Where Online Learning is simpler!

The C and C++ Include Header Files

/usr/include/inttypes.h


$ cat -n /usr/include/inttypes.h

     1	/* Copyright (C) 1997-2024 Free Software Foundation, Inc.
     2	   This file is part of the GNU C Library.
     3	
     4	   The GNU C Library is free software; you can redistribute it and/or
     5	   modify it under the terms of the GNU Lesser General Public
     6	   License as published by the Free Software Foundation; either
     7	   version 2.1 of the License, or (at your option) any later version.
     8	
     9	   The GNU C Library is distributed in the hope that it will be useful,
    10	   but WITHOUT ANY WARRANTY; without even the implied warranty of
    11	   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    12	   Lesser General Public License for more details.
    13	
    14	   You should have received a copy of the GNU Lesser General Public
    15	   License along with the GNU C Library; if not, see
    16	   <https://www.gnu.org/licenses/>.  */
    17	
    18	/*
    19	 *	ISO C99: 7.8 Format conversion of integer types	<inttypes.h>
    20	 */
    21	
    22	#ifndef _INTTYPES_H
    23	#define _INTTYPES_H	1
    24	
    25	#include <features.h>
    26	/* Get the type definitions.  */
    27	#include <stdint.h>
    28	
    29	/* Get a definition for wchar_t.  But we must not define wchar_t itself.  */
    30	#ifndef ____gwchar_t_defined
    31	# ifdef __cplusplus
    32	#  define __gwchar_t wchar_t
    33	# elif defined __WCHAR_TYPE__
    34	typedef __WCHAR_TYPE__ __gwchar_t;
    35	# else
    36	#  define __need_wchar_t
    37	#  include <stddef.h>
    38	typedef wchar_t __gwchar_t;
    39	# endif
    40	# define ____gwchar_t_defined	1
    41	#endif
    42	
    43	# if __WORDSIZE == 64
    44	#  define __PRI64_PREFIX	"l"
    45	#  define __PRIPTR_PREFIX	"l"
    46	# else
    47	#  define __PRI64_PREFIX	"ll"
    48	#  define __PRIPTR_PREFIX
    49	# endif
    50	
    51	/* Macros for printing format specifiers.  */
    52	
    53	/* Decimal notation.  */
    54	# define PRId8		"d"
    55	# define PRId16		"d"
    56	# define PRId32		"d"
    57	# define PRId64		__PRI64_PREFIX "d"
    58	
    59	# define PRIdLEAST8	"d"
    60	# define PRIdLEAST16	"d"
    61	# define PRIdLEAST32	"d"
    62	# define PRIdLEAST64	__PRI64_PREFIX "d"
    63	
    64	# define PRIdFAST8	"d"
    65	# define PRIdFAST16	__PRIPTR_PREFIX "d"
    66	# define PRIdFAST32	__PRIPTR_PREFIX "d"
    67	# define PRIdFAST64	__PRI64_PREFIX "d"
    68	
    69	
    70	# define PRIi8		"i"
    71	# define PRIi16		"i"
    72	# define PRIi32		"i"
    73	# define PRIi64		__PRI64_PREFIX "i"
    74	
    75	# define PRIiLEAST8	"i"
    76	# define PRIiLEAST16	"i"
    77	# define PRIiLEAST32	"i"
    78	# define PRIiLEAST64	__PRI64_PREFIX "i"
    79	
    80	# define PRIiFAST8	"i"
    81	# define PRIiFAST16	__PRIPTR_PREFIX "i"
    82	# define PRIiFAST32	__PRIPTR_PREFIX "i"
    83	# define PRIiFAST64	__PRI64_PREFIX "i"
    84	
    85	/* Octal notation.  */
    86	# define PRIo8		"o"
    87	# define PRIo16		"o"
    88	# define PRIo32		"o"
    89	# define PRIo64		__PRI64_PREFIX "o"
    90	
    91	# define PRIoLEAST8	"o"
    92	# define PRIoLEAST16	"o"
    93	# define PRIoLEAST32	"o"
    94	# define PRIoLEAST64	__PRI64_PREFIX "o"
    95	
    96	# define PRIoFAST8	"o"
    97	# define PRIoFAST16	__PRIPTR_PREFIX "o"
    98	# define PRIoFAST32	__PRIPTR_PREFIX "o"
    99	# define PRIoFAST64	__PRI64_PREFIX "o"
   100	
   101	/* Unsigned integers.  */
   102	# define PRIu8		"u"
   103	# define PRIu16		"u"
   104	# define PRIu32		"u"
   105	# define PRIu64		__PRI64_PREFIX "u"
   106	
   107	# define PRIuLEAST8	"u"
   108	# define PRIuLEAST16	"u"
   109	# define PRIuLEAST32	"u"
   110	# define PRIuLEAST64	__PRI64_PREFIX "u"
   111	
   112	# define PRIuFAST8	"u"
   113	# define PRIuFAST16	__PRIPTR_PREFIX "u"
   114	# define PRIuFAST32	__PRIPTR_PREFIX "u"
   115	# define PRIuFAST64	__PRI64_PREFIX "u"
   116	
   117	/* lowercase hexadecimal notation.  */
   118	# define PRIx8		"x"
   119	# define PRIx16		"x"
   120	# define PRIx32		"x"
   121	# define PRIx64		__PRI64_PREFIX "x"
   122	
   123	# define PRIxLEAST8	"x"
   124	# define PRIxLEAST16	"x"
   125	# define PRIxLEAST32	"x"
   126	# define PRIxLEAST64	__PRI64_PREFIX "x"
   127	
   128	# define PRIxFAST8	"x"
   129	# define PRIxFAST16	__PRIPTR_PREFIX "x"
   130	# define PRIxFAST32	__PRIPTR_PREFIX "x"
   131	# define PRIxFAST64	__PRI64_PREFIX "x"
   132	
   133	/* UPPERCASE hexadecimal notation.  */
   134	# define PRIX8		"X"
   135	# define PRIX16		"X"
   136	# define PRIX32		"X"
   137	# define PRIX64		__PRI64_PREFIX "X"
   138	
   139	# define PRIXLEAST8	"X"
   140	# define PRIXLEAST16	"X"
   141	# define PRIXLEAST32	"X"
   142	# define PRIXLEAST64	__PRI64_PREFIX "X"
   143	
   144	# define PRIXFAST8	"X"
   145	# define PRIXFAST16	__PRIPTR_PREFIX "X"
   146	# define PRIXFAST32	__PRIPTR_PREFIX "X"
   147	# define PRIXFAST64	__PRI64_PREFIX "X"
   148	
   149	
   150	/* Macros for printing `intmax_t' and `uintmax_t'.  */
   151	# define PRIdMAX	__PRI64_PREFIX "d"
   152	# define PRIiMAX	__PRI64_PREFIX "i"
   153	# define PRIoMAX	__PRI64_PREFIX "o"
   154	# define PRIuMAX	__PRI64_PREFIX "u"
   155	# define PRIxMAX	__PRI64_PREFIX "x"
   156	# define PRIXMAX	__PRI64_PREFIX "X"
   157	
   158	
   159	/* Macros for printing `intptr_t' and `uintptr_t'.  */
   160	# define PRIdPTR	__PRIPTR_PREFIX "d"
   161	# define PRIiPTR	__PRIPTR_PREFIX "i"
   162	# define PRIoPTR	__PRIPTR_PREFIX "o"
   163	# define PRIuPTR	__PRIPTR_PREFIX "u"
   164	# define PRIxPTR	__PRIPTR_PREFIX "x"
   165	# define PRIXPTR	__PRIPTR_PREFIX "X"
   166	
   167	/* Binary notation.  */
   168	# if __GLIBC_USE (ISOC2X)
   169	#  define PRIb8		"b"
   170	#  define PRIb16	"b"
   171	#  define PRIb32	"b"
   172	#  define PRIb64	__PRI64_PREFIX "b"
   173	
   174	#  define PRIbLEAST8	"b"
   175	#  define PRIbLEAST16	"b"
   176	#  define PRIbLEAST32	"b"
   177	#  define PRIbLEAST64	__PRI64_PREFIX "b"
   178	
   179	#  define PRIbFAST8	"b"
   180	#  define PRIbFAST16	__PRIPTR_PREFIX "b"
   181	#  define PRIbFAST32	__PRIPTR_PREFIX "b"
   182	#  define PRIbFAST64	__PRI64_PREFIX "b"
   183	
   184	#  define PRIbMAX	__PRI64_PREFIX "b"
   185	#  define PRIbPTR	__PRIPTR_PREFIX "b"
   186	
   187	#  define PRIB8		"B"
   188	#  define PRIB16	"B"
   189	#  define PRIB32	"B"
   190	#  define PRIB64	__PRI64_PREFIX "B"
   191	
   192	#  define PRIBLEAST8	"B"
   193	#  define PRIBLEAST16	"B"
   194	#  define PRIBLEAST32	"B"
   195	#  define PRIBLEAST64	__PRI64_PREFIX "B"
   196	
   197	#  define PRIBFAST8	"B"
   198	#  define PRIBFAST16	__PRIPTR_PREFIX "B"
   199	#  define PRIBFAST32	__PRIPTR_PREFIX "B"
   200	#  define PRIBFAST64	__PRI64_PREFIX "B"
   201	
   202	#  define PRIBMAX	__PRI64_PREFIX "B"
   203	#  define PRIBPTR	__PRIPTR_PREFIX "B"
   204	# endif
   205	
   206	
   207	/* Macros for scanning format specifiers.  */
   208	
   209	/* Signed decimal notation.  */
   210	# define SCNd8		"hhd"
   211	# define SCNd16		"hd"
   212	# define SCNd32		"d"
   213	# define SCNd64		__PRI64_PREFIX "d"
   214	
   215	# define SCNdLEAST8	"hhd"
   216	# define SCNdLEAST16	"hd"
   217	# define SCNdLEAST32	"d"
   218	# define SCNdLEAST64	__PRI64_PREFIX "d"
   219	
   220	# define SCNdFAST8	"hhd"
   221	# define SCNdFAST16	__PRIPTR_PREFIX "d"
   222	# define SCNdFAST32	__PRIPTR_PREFIX "d"
   223	# define SCNdFAST64	__PRI64_PREFIX "d"
   224	
   225	/* Signed decimal notation.  */
   226	# define SCNi8		"hhi"
   227	# define SCNi16		"hi"
   228	# define SCNi32		"i"
   229	# define SCNi64		__PRI64_PREFIX "i"
   230	
   231	# define SCNiLEAST8	"hhi"
   232	# define SCNiLEAST16	"hi"
   233	# define SCNiLEAST32	"i"
   234	# define SCNiLEAST64	__PRI64_PREFIX "i"
   235	
   236	# define SCNiFAST8	"hhi"
   237	# define SCNiFAST16	__PRIPTR_PREFIX "i"
   238	# define SCNiFAST32	__PRIPTR_PREFIX "i"
   239	# define SCNiFAST64	__PRI64_PREFIX "i"
   240	
   241	/* Unsigned decimal notation.  */
   242	# define SCNu8		"hhu"
   243	# define SCNu16		"hu"
   244	# define SCNu32		"u"
   245	# define SCNu64		__PRI64_PREFIX "u"
   246	
   247	# define SCNuLEAST8	"hhu"
   248	# define SCNuLEAST16	"hu"
   249	# define SCNuLEAST32	"u"
   250	# define SCNuLEAST64	__PRI64_PREFIX "u"
   251	
   252	# define SCNuFAST8	"hhu"
   253	# define SCNuFAST16	__PRIPTR_PREFIX "u"
   254	# define SCNuFAST32	__PRIPTR_PREFIX "u"
   255	# define SCNuFAST64	__PRI64_PREFIX "u"
   256	
   257	/* Octal notation.  */
   258	# define SCNo8		"hho"
   259	# define SCNo16		"ho"
   260	# define SCNo32		"o"
   261	# define SCNo64		__PRI64_PREFIX "o"
   262	
   263	# define SCNoLEAST8	"hho"
   264	# define SCNoLEAST16	"ho"
   265	# define SCNoLEAST32	"o"
   266	# define SCNoLEAST64	__PRI64_PREFIX "o"
   267	
   268	# define SCNoFAST8	"hho"
   269	# define SCNoFAST16	__PRIPTR_PREFIX "o"
   270	# define SCNoFAST32	__PRIPTR_PREFIX "o"
   271	# define SCNoFAST64	__PRI64_PREFIX "o"
   272	
   273	/* Hexadecimal notation.  */
   274	# define SCNx8		"hhx"
   275	# define SCNx16		"hx"
   276	# define SCNx32		"x"
   277	# define SCNx64		__PRI64_PREFIX "x"
   278	
   279	# define SCNxLEAST8	"hhx"
   280	# define SCNxLEAST16	"hx"
   281	# define SCNxLEAST32	"x"
   282	# define SCNxLEAST64	__PRI64_PREFIX "x"
   283	
   284	# define SCNxFAST8	"hhx"
   285	# define SCNxFAST16	__PRIPTR_PREFIX "x"
   286	# define SCNxFAST32	__PRIPTR_PREFIX "x"
   287	# define SCNxFAST64	__PRI64_PREFIX "x"
   288	
   289	
   290	/* Macros for scanning `intmax_t' and `uintmax_t'.  */
   291	# define SCNdMAX	__PRI64_PREFIX "d"
   292	# define SCNiMAX	__PRI64_PREFIX "i"
   293	# define SCNoMAX	__PRI64_PREFIX "o"
   294	# define SCNuMAX	__PRI64_PREFIX "u"
   295	# define SCNxMAX	__PRI64_PREFIX "x"
   296	
   297	/* Macros for scanning `intptr_t' and `uintptr_t'.  */
   298	# define SCNdPTR	__PRIPTR_PREFIX "d"
   299	# define SCNiPTR	__PRIPTR_PREFIX "i"
   300	# define SCNoPTR	__PRIPTR_PREFIX "o"
   301	# define SCNuPTR	__PRIPTR_PREFIX "u"
   302	# define SCNxPTR	__PRIPTR_PREFIX "x"
   303	
   304	
   305	/* Binary notation.  */
   306	# if __GLIBC_USE (ISOC2X)
   307	#  define SCNb8		"hhb"
   308	#  define SCNb16	"hb"
   309	#  define SCNb32	"b"
   310	#  define SCNb64	__PRI64_PREFIX "b"
   311	
   312	#  define SCNbLEAST8	"hhb"
   313	#  define SCNbLEAST16	"hb"
   314	#  define SCNbLEAST32	"b"
   315	#  define SCNbLEAST64	__PRI64_PREFIX "b"
   316	
   317	#  define SCNbFAST8	"hhb"
   318	#  define SCNbFAST16	__PRIPTR_PREFIX "b"
   319	#  define SCNbFAST32	__PRIPTR_PREFIX "b"
   320	#  define SCNbFAST64	__PRI64_PREFIX "b"
   321	
   322	#  define SCNbMAX	__PRI64_PREFIX "b"
   323	#  define SCNbPTR	__PRIPTR_PREFIX "b"
   324	# endif
   325	
   326	
   327	__BEGIN_DECLS
   328	
   329	#if __WORDSIZE == 64
   330	
   331	/* We have to define the `uintmax_t' type using `ldiv_t'.  */
   332	typedef struct
   333	  {
   334	    long int quot;		/* Quotient.  */
   335	    long int rem;		/* Remainder.  */
   336	  } imaxdiv_t;
   337	
   338	#else
   339	
   340	/* We have to define the `uintmax_t' type using `lldiv_t'.  */
   341	typedef struct
   342	  {
   343	    __extension__ long long int quot;	/* Quotient.  */
   344	    __extension__ long long int rem;	/* Remainder.  */
   345	  } imaxdiv_t;
   346	
   347	#endif
   348	
   349	
   350	/* Compute absolute value of N.  */
   351	extern intmax_t imaxabs (intmax_t __n) __THROW __attribute__ ((__const__));
   352	
   353	/* Return the `imaxdiv_t' representation of the value of NUMER over DENOM. */
   354	extern imaxdiv_t imaxdiv (intmax_t __numer, intmax_t __denom)
   355	      __THROW __attribute__ ((__const__));
   356	
   357	/* Like `strtol' but convert to `intmax_t'.  */
   358	extern intmax_t strtoimax (const char *__restrict __nptr,
   359				   char **__restrict __endptr, int __base) __THROW;
   360	
   361	/* Like `strtoul' but convert to `uintmax_t'.  */
   362	extern uintmax_t strtoumax (const char *__restrict __nptr,
   363				    char ** __restrict __endptr, int __base) __THROW;
   364	
   365	/* Like `wcstol' but convert to `intmax_t'.  */
   366	extern intmax_t wcstoimax (const __gwchar_t *__restrict __nptr,
   367				   __gwchar_t **__restrict __endptr, int __base)
   368	     __THROW;
   369	
   370	/* Like `wcstoul' but convert to `uintmax_t'.  */
   371	extern uintmax_t wcstoumax (const __gwchar_t *__restrict __nptr,
   372				    __gwchar_t ** __restrict __endptr, int __base)
   373	     __THROW;
   374	
   375	/* Versions of the above functions that handle '0b' and '0B' prefixes
   376	   in base 0 or 2.  */
   377	#if __GLIBC_USE (C2X_STRTOL)
   378	# ifdef __REDIRECT
   379	extern intmax_t __REDIRECT_NTH (strtoimax, (const char *__restrict __nptr,
   380						    char **__restrict __endptr,
   381						    int __base), __isoc23_strtoimax);
   382	extern uintmax_t __REDIRECT_NTH (strtoumax, (const char *__restrict __nptr,
   383						     char **__restrict __endptr,
   384						     int __base), __isoc23_strtoumax);
   385	extern intmax_t __REDIRECT_NTH (wcstoimax,
   386					(const __gwchar_t *__restrict __nptr,
   387					 __gwchar_t **__restrict __endptr, int __base),
   388					__isoc23_wcstoimax);
   389	extern uintmax_t __REDIRECT_NTH (wcstoumax,
   390					 (const __gwchar_t *__restrict __nptr,
   391					  __gwchar_t **__restrict __endptr, int __base),
   392					 __isoc23_wcstoumax);
   393	# else
   394	extern intmax_t __isoc23_strtoimax (const char *__restrict __nptr,
   395					    char **__restrict __endptr, int __base)
   396	     __THROW;
   397	extern uintmax_t __isoc23_strtoumax (const char *__restrict __nptr,
   398					     char ** __restrict __endptr, int __base)
   399	     __THROW;
   400	extern intmax_t __isoc23_wcstoimax (const __gwchar_t *__restrict __nptr,
   401					    __gwchar_t **__restrict __endptr,
   402					    int __base)
   403	     __THROW;
   404	extern uintmax_t __isoc23_wcstoumax (const __gwchar_t *__restrict __nptr,
   405					     __gwchar_t ** __restrict __endptr,
   406					     int __base)
   407	     __THROW;
   408	# define strtoimax __isoc23_strtoimax
   409	# define strtoumax __isoc23_strtoumax
   410	# define wcstoimax __isoc23_wcstoimax
   411	# define wcstoumax __isoc23_wcstoumax
   412	# endif
   413	#endif
   414	
   415	__END_DECLS
   416	
   417	#endif /* inttypes.h */