strnum.h

#pragma once
 
#include <cx/string/strbase.h>
 
CX_C_BEGIN
 
 
// for keeping annotations consistent and prototypes on a single line
#define _strNumSuccess _Success_(return)
 
enum STRNUM_FLAGS {
    STRNUM_NoTrailing = 0x01,   
    STRNUM_NoWS       = 0x02,   
    STRNUM_NoPrefix   = 0x04,   
    STRNUM_NoSign     = 0x08,   
};
 
_strNumSuccess bool strToInt32(_Out_ int32* _Nonnull out, _In_opt_ strref s, int base,
                               flags_t flags);
 
_strNumSuccess bool strToUInt32(_Out_ uint32* _Nonnull out, _In_opt_ strref s, int base,
                                flags_t flags);
 
_strNumSuccess bool strToInt64(_Out_ int64* _Nonnull out, _In_opt_ strref s, int base,
                               flags_t flags);
 
_strNumSuccess bool strToUInt64(_Out_ uint64* _Nonnull out, _In_opt_ strref s, int base,
                                flags_t flags);
 
bool strFromInt32(_Inout_ strhandle out, int32 i, uint16 base);
 
bool strFromUInt32(_Inout_ strhandle out, uint32 i, uint16 base);
 
bool strFromInt64(_Inout_ strhandle out, int64 i, uint16 base);
 
bool strFromUInt64(_Inout_ strhandle out, uint64 i, uint16 base);
 
_strNumSuccess bool strToFloat32(_Out_ float32* _Nonnull out, _In_opt_ strref s, flags_t flags);
 
_strNumSuccess bool strToFloat64(_Out_ float64* _Nonnull out, _In_opt_ strref s, flags_t flags);
 
bool strFromFloat32(_Inout_ strhandle out, float32 f);
 
bool strFromFloat64(_Inout_ strhandle out, float64 f);
 
 
#define STRNUM_INTBUF 66
 
_Ret_valid_ uint8* _Nonnull _strnum_u64toa(_Out_writes_(STRNUM_INTBUF) uint8 buf[STRNUM_INTBUF],
                                           _Out_opt_ uint32* _Nullable len, uint64 value,
                                           uint16 base, uint32 mindigits, char sign, bool upper);
 
#define STRNUM_FPDIGITS 18
 
#define STRNUM_FPBUF 25
 
uint32 _strnum_f64toa(float64 d, _Out_writes_(STRNUM_FPBUF) uint8 dest[STRNUM_FPBUF]);
 
uint32 _strnum_f32toa(float32 f, _Out_writes_(STRNUM_FPBUF) uint8 dest[STRNUM_FPBUF]);
 
int32 _strnum_grisu2_32(float32 f, _Out_writes_(18) uint8* _Nonnull digits,
                        _Inout_ int32* _Nonnull K);
 
int32 _strnum_grisu2_64(float64 d, _Out_writes_(18) uint8* _Nonnull digits,
                        _Inout_ int32* _Nonnull K);
 
 
 
CX_C_END