feat(inttypes): PRI/SCN macros + strtoimax family

2026-09-03 22:16:12 -04:00
parent 26786e9027
commit 14b0136a8e
3 changed files with 980 additions and 0 deletions
@@ -0,0 +1,314 @@
+#ifndef VLIBC_INTTYPES_H
+#define VLIBC_INTTYPES_H
+
+/*
+ * vlibc — <inttypes.h>.
+ *
+ * Extended integer type names, the imax* conversions of the widest signed
+ * type, and the PRI and SCN formatted-I/O macros (C23 7.8). Every macro below
+ * expands to a string literal holding the complete conversion specifier
+ * (length modifier included) for the corresponding <stdint.h> type on the
+ * x86_64 LP64 target, where the compiler predefined types are:
+ *
+ *   int8_t/uint8_t           signed char / unsigned char
+ *   int16_t/uint16_t         short / unsigned short
+ *   int32_t/uint32_t         int / unsigned int
+ *   int64_t/uint64_t         long / unsigned long
+ *   int_leastN_t             identical to the exact-width types
+ *   int_fast8_t              signed char; int_fast16/32/64_t are long
+ *   intmax_t/uintmax_t       long / unsigned long
+ *   intptr_t/uintptr_t       long / unsigned long
+ *
+ * Design rule (per plan): the fprintf macros name the length modifier of
+ * the PROMOTED argument — printf receives an int for every sub-int type,
+ * so PRId8 is "d", not "hhd" — while the fscanf macros name the
+ * exact-width modifier — scanf receives a pointer, so SCNd8 is "hhd".
+ * Both forms convert the corresponding type correctly under C23 7.8.1;
+ * glibc and musl instead use the exact-width modifier in both families,
+ * which is equally conformant and indistinguishable in behavior for
+ * correctly-typed arguments.
+ *
+ * This header is ISO C core and is present in every profile.
+ */
+
+#include <stddef.h>
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Quotient and remainder of the widest integer division (C23 7.8.1). */
+typedef struct imaxdiv_t
+{
+    intmax_t quot;
+    intmax_t rem;
+} imaxdiv_t;
+
+/*
+ * fprintf macros for the signed exact-width types (argument promotes to
+ * int, or stays long for the 64-bit width).
+ */
+#define PRId8 "d"
+#define PRId16 "d"
+#define PRId32 "d"
+#define PRId64 "ld"
+
+#define PRIi8 "i"
+#define PRIi16 "i"
+#define PRIi32 "i"
+#define PRIi64 "li"
+
+/* fprintf macros for the unsigned exact-width types. */
+#define PRIo8 "o"
+#define PRIo16 "o"
+#define PRIo32 "o"
+#define PRIo64 "lo"
+
+#define PRIu8 "u"
+#define PRIu16 "u"
+#define PRIu32 "u"
+#define PRIu64 "lu"
+
+#define PRIx8 "x"
+#define PRIx16 "x"
+#define PRIx32 "x"
+#define PRIx64 "lx"
+
+#define PRIX8 "X"
+#define PRIX16 "X"
+#define PRIX32 "X"
+#define PRIX64 "lX"
+
+/* fprintf macros for the signed least-width types (same typedefs as the
+ * exact-width types on x86_64). */
+#define PRIdLEAST8 "d"
+#define PRIdLEAST16 "d"
+#define PRIdLEAST32 "d"
+#define PRIdLEAST64 "ld"
+
+#define PRIiLEAST8 "i"
+#define PRIiLEAST16 "i"
+#define PRIiLEAST32 "i"
+#define PRIiLEAST64 "li"
+
+/* fprintf macros for the unsigned least-width types. */
+#define PRIoLEAST8 "o"
+#define PRIoLEAST16 "o"
+#define PRIoLEAST32 "o"
+#define PRIoLEAST64 "lo"
+
+#define PRIuLEAST8 "u"
+#define PRIuLEAST16 "u"
+#define PRIuLEAST32 "u"
+#define PRIuLEAST64 "lu"
+
+#define PRIxLEAST8 "x"
+#define PRIxLEAST16 "x"
+#define PRIxLEAST32 "x"
+#define PRIxLEAST64 "lx"
+
+#define PRIXLEAST8 "X"
+#define PRIXLEAST16 "X"
+#define PRIXLEAST32 "X"
+#define PRIXLEAST64 "lX"
+
+/* fprintf macros for the signed fastest types (int_fast8_t is signed char,
+ * which promotes to int; int_fast16/32/64_t are long). */
+#define PRIdFAST8 "d"
+#define PRIdFAST16 "ld"
+#define PRIdFAST32 "ld"
+#define PRIdFAST64 "ld"
+
+#define PRIiFAST8 "i"
+#define PRIiFAST16 "li"
+#define PRIiFAST32 "li"
+#define PRIiFAST64 "li"
+
+/* fprintf macros for the unsigned fastest types. */
+#define PRIoFAST8 "o"
+#define PRIoFAST16 "lo"
+#define PRIoFAST32 "lo"
+#define PRIoFAST64 "lo"
+
+#define PRIuFAST8 "u"
+#define PRIuFAST16 "lu"
+#define PRIuFAST32 "lu"
+#define PRIuFAST64 "lu"
+
+#define PRIxFAST8 "x"
+#define PRIxFAST16 "lx"
+#define PRIxFAST32 "lx"
+#define PRIxFAST64 "lx"
+
+#define PRIXFAST8 "X"
+#define PRIXFAST16 "lX"
+#define PRIXFAST32 "lX"
+#define PRIXFAST64 "lX"
+
+/* fprintf macros for the widest (intmax_t/uintmax_t) and pointer-width
+ * (intptr_t/uintptr_t) types; both families are long/unsigned long. */
+#define PRIdMAX "ld"
+#define PRIiMAX "li"
+#define PRIoMAX "lo"
+#define PRIuMAX "lu"
+#define PRIxMAX "lx"
+#define PRIXMAX "lX"
+
+#define PRIdPTR "ld"
+#define PRIiPTR "li"
+#define PRIoPTR "lo"
+#define PRIuPTR "lu"
+#define PRIxPTR "lx"
+#define PRIXPTR "lX"
+
+/*
+ * fscanf macros for the signed exact-width types: the pointer targets the
+ * exact type, so the modifier is hh/h/(none)/l by width.
+ */
+#define SCNd8 "hhd"
+#define SCNd16 "hd"
+#define SCNd32 "d"
+#define SCNd64 "ld"
+
+#define SCNi8 "hhi"
+#define SCNi16 "hi"
+#define SCNi32 "i"
+#define SCNi64 "li"
+
+/* fscanf macros for the unsigned exact-width types. */
+#define SCNo8 "hho"
+#define SCNo16 "ho"
+#define SCNo32 "o"
+#define SCNo64 "lo"
+
+#define SCNu8 "hhu"
+#define SCNu16 "hu"
+#define SCNu32 "u"
+#define SCNu64 "lu"
+
+#define SCNx8 "hhx"
+#define SCNx16 "hx"
+#define SCNx32 "x"
+#define SCNx64 "lx"
+
+/* fscanf macros for the signed least-width types (same typedefs as the
+ * exact-width types on x86_64). */
+#define SCNdLEAST8 "hhd"
+#define SCNdLEAST16 "hd"
+#define SCNdLEAST32 "d"
+#define SCNdLEAST64 "ld"
+
+#define SCNiLEAST8 "hhi"
+#define SCNiLEAST16 "hi"
+#define SCNiLEAST32 "i"
+#define SCNiLEAST64 "li"
+
+/* fscanf macros for the unsigned least-width types. */
+#define SCNoLEAST8 "hho"
+#define SCNoLEAST16 "ho"
+#define SCNoLEAST32 "o"
+#define SCNoLEAST64 "lo"
+
+#define SCNuLEAST8 "hhu"
+#define SCNuLEAST16 "hu"
+#define SCNuLEAST32 "u"
+#define SCNuLEAST64 "lu"
+
+#define SCNxLEAST8 "hhx"
+#define SCNxLEAST16 "hx"
+#define SCNxLEAST32 "x"
+#define SCNxLEAST64 "lx"
+
+/* fscanf macros for the signed fastest types (int_fast8_t is signed char;
+ * int_fast16/32/64_t are long). */
+#define SCNdFAST8 "hhd"
+#define SCNdFAST16 "ld"
+#define SCNdFAST32 "ld"
+#define SCNdFAST64 "ld"
+
+#define SCNiFAST8 "hhi"
+#define SCNiFAST16 "li"
+#define SCNiFAST32 "li"
+#define SCNiFAST64 "li"
+
+/* fscanf macros for the unsigned fastest types. */
+#define SCNoFAST8 "hho"
+#define SCNoFAST16 "lo"
+#define SCNoFAST32 "lo"
+#define SCNoFAST64 "lo"
+
+#define SCNuFAST8 "hhu"
+#define SCNuFAST16 "lu"
+#define SCNuFAST32 "lu"
+#define SCNuFAST64 "lu"
+
+#define SCNxFAST8 "hhx"
+#define SCNxFAST16 "lx"
+#define SCNxFAST32 "lx"
+#define SCNxFAST64 "lx"
+
+/* fscanf macros for the widest and pointer-width types. */
+#define SCNdMAX "ld"
+#define SCNiMAX "li"
+#define SCNoMAX "lo"
+#define SCNuMAX "lu"
+#define SCNxMAX "lx"
+
+#define SCNdPTR "ld"
+#define SCNiPTR "li"
+#define SCNoPTR "lo"
+#define SCNuPTR "lu"
+#define SCNxPTR "lx"
+
+/*
+ * Return the absolute value of n. abs(INTMAX_MIN) is not representable;
+ * it wraps (implementation-defined, no errno), matching GCC's two's
+ * complement semantics.
+ * const: result depends only on the argument (GCC predeclares imaxabs
+ * with this attribute, so no weaker one may be used).
+ */
+__attribute__((const)) intmax_t
+imaxabs(intmax_t n);
+
+/*
+ * Return { quot, rem } of numer / denom, both truncated toward zero with
+ * the remainder taking the sign of numer (C division semantics).
+ * const: result depends only on the arguments.
+ */
+__attribute__((const)) imaxdiv_t
+imaxdiv(intmax_t numer, intmax_t denom);
+
+/*
+ * Convert the initial portion of nptr to intmax_t, as strtol with the
+ * widest signed type. intmax_t is long on x86_64 LP64, so this is an
+ * ABI-identical delegation to strtol (same engine, same errno policy:
+ * ERANGE clamps, EINVAL for a base outside {0} union [2, 36]).
+ */
+intmax_t
+strtoimax(const char *restrict nptr, char **restrict endptr, int base);
+
+/* As strtoimax, converted to uintmax_t (unsigned long); negative subject
+ * sequences wrap modulo 2^64 and are never a range error (C23 7.8.2.3). */
+uintmax_t
+strtoumax(const char *restrict nptr, char **restrict endptr, int base);
+
+/*
+ * Wide-character forms of strtoimax/strtoumax (C23 7.8.2.4-5). The subject
+ * sequence is scanned from nptr under the same rules as strtol: C-locale
+ * whitespace (L' ' and L'\t'..L'\r'), optional sign, base 0/2..36 with the
+ * 0x/0 prefix rules, ASCII digits only. errno and endptr (of type
+ * wchar_t **) behave exactly as the narrow forms.
+ */
+intmax_t
+wcstoimax(const wchar_t *restrict nptr, wchar_t **restrict endptr, int base);
+
+uintmax_t
+wcstoumax(const wchar_t *restrict nptr, wchar_t **restrict endptr, int base);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* VLIBC_INTTYPES_H */