]> mj.ucw.cz Git - libucw.git/blob - ucw/strtonum.h
Opt: defined user interface
[libucw.git] / ucw / strtonum.h
1 /*
2  *      UCW Library -- Conversions of Strings to Numbers: Declarations
3  *
4  *      (c) 2010 Daniel Fiala <danfiala@ucw.cz>
5  *
6  *      This software may be freely distributed and used according to the terms
7  *      of the GNU Lesser General Public License.
8  */
9
10 #ifndef _STRTONUM_H
11 #define _STRTONUM_H
12
13 // Set (flags & 0x1f) in the range 1 to 31 to denote the default base of the number
14 enum str_to_num_flags {
15   STN_SIGNED = 0x20,       // The resulting range is signed
16   STN_MINUS = 0x40,        // Allow optional '-' sign
17   STN_PLUS = 0x80,         // Allow optional '+' sign
18   STN_TRUNC = 0x100,       // Allow range overflow -> truncate to the allowed range
19   STN_DEC = 0x200,         // Support decimal numbers (currently no prefix)
20   STN_HEX = 0x400,         // Support hexadecimal numbers (0x...)
21   STN_BIN = 0x800,         // Support binary numbers (0b...)
22   STN_OCT = 0x1000,        // Support octal numbers (0o...)
23   STN_OCT0 = 0x2000,       // Support octal numbers (0[0-7]...)
24   STN_UNDERSCORE = 0x4000, // Number can contain underscore characters to increase readability (eg. 1_000_000)
25   STN_WHOLE = 0x8000,      // Number can be terminated only by \0 character
26 };
27
28 #define STN_DBASES_MASK    0x1F
29 #define STN_SIGNS          (STN_MINUS | STN_PLUS)
30 #define STN_BASES          (STN_DEC | STN_HEX | STN_BIN | STN_OCT)
31 #define STN_BASES0         (STN_BASES | STN_OCT0)
32 #define STN_FLAGS          (STN_MINUS | STN_PLUS | STN_BASES)
33 #define STN_UFLAGS         (STN_FLAGS | STN_UNDERSCORE)
34 #define STN_SFLAGS         (STN_FLAGS | STN_SIGNED)
35 #define STN_USFLAGS        (STN_SFLAGS | STN_UNDERSCORE)
36
37 #define STN_DECLARE_CONVERTOR(type, suffix)                                                               \
38 const char *str_to_##suffix(type *num, const char *str, const char **next, const uns flags)
39
40 #define STN_SIGNED_CONVERTOR(type, suffix, usuffix)                                                       \
41 static inline const char *str_to_##suffix(type *num, const char *str, const char **next, const uns flags) \
42 {                                                                                                         \
43   return str_to_##usuffix((void *) num, str, next, flags | STN_SIGNED | STN_PLUS | STN_MINUS);            \
44 }
45
46 STN_DECLARE_CONVERTOR(uns, uns);
47 STN_SIGNED_CONVERTOR(int, int, uns)
48
49 STN_DECLARE_CONVERTOR(uintmax_t, uintmax);
50 STN_SIGNED_CONVERTOR(intmax_t, intmax, uintmax)
51
52 #endif