Signed-off-by: Alejandro Colomar <alx.manpages@xxxxxxxxx> --- man3/intN_t.3 | 64 +++++++++++++++++++++--------- man3/uint16_t.3 | 2 +- man3/uint32_t.3 | 2 +- man3/uint64_t.3 | 2 +- man3/uint8_t.3 | 2 +- man3/uintN_t.3 | 2 +- man7/system_data_types.7 | 84 ---------------------------------------- 7 files changed, 50 insertions(+), 108 deletions(-) diff --git a/man3/intN_t.3 b/man3/intN_t.3 index c8a595bac..b7642545f 100644 --- a/man3/intN_t.3 +++ b/man3/intN_t.3 @@ -1,6 +1,8 @@ .TH INTN_T 3 2021-11-02 Linux "Linux Programmer's Manual" .SH NAME -intN_t, int8_t, int16_t, int32_t, int64_t \- fixed-width basic integer types +intN_t, int8_t, int16_t, int32_t, int64_t, +uintN_t, uint8_t, uint16_t, uint32_t, uint64_t +\- fixed-width basic integer types .SH SYNOPSIS .nf .B #include <stdint.h> @@ -9,38 +11,60 @@ intN_t, int8_t, int16_t, int32_t, int64_t \- fixed-width basic integer types .BR typedef " /* ... */ " int16_t; .BR typedef " /* ... */ " int32_t; .BR typedef " /* ... */ " int64_t; +.PP +.BR typedef " /* ... */ " uint8_t; +.BR typedef " /* ... */ " uint16_t; +.BR typedef " /* ... */ " uint32_t; +.BR typedef " /* ... */ " uint64_t; .fi .SH DESCRIPTION .IR int N _t are signed integer types of a fixed width of exactly N bits, -N being the value specified in its type name. +.I N +being the value specified in its type name. According to the C language standard, they shall be capable of storing values in the range -.RB [ INT N _MIN , -.BR INT N _MAX ], -substituting N by the appropriate number. +.RB [ INT \fIN\fP _MIN , +.BR INT \fIN\fP _MAX ], +substituting +.I N +by the appropriate number. +.PP +.IR uint N _t +are +unsigned integer types +of a fixed width of exactly N bits, +N being the value specified in its type name. +According to the C language standard, they shall be +capable of storing values in the range [0, +.BR UINT \fIN\fP _MAX ], +substituting +.I N +by the appropriate number. .PP According to POSIX, -.IR int8_t , -.IR int16_t , +.RI [ u ] int8_t , +.RI [ u ] int16_t , and -.I int32_t +.RI [ u ] int32_t are required; -.I int64_t -is only required in implementations that provide integer types with width 64; +.RI [ u ] int64_t +are only required in implementations that provide integer types with width 64; and all other types of this form are optional. .PP The length modifiers for the -.IR int N _t +.RI [ u ] int N _t types for the .BR printf (3) family of functions are expanded by macros of the forms -.BR PRId N +.BR PRId \fIN\fP, +.BR PRIi \fIN\fP, +.BR PRIu \fIN\fP, and -.BR PRIi N +.BI PRIx N (defined in .IR <inttypes.h> ); resulting for example in @@ -51,22 +75,24 @@ for printing .I int64_t values. The length modifiers for the -.IR int N _t +.RI [ u ] int N _t types for the .BR scanf (3) family of functions are expanded by macros of the forms -.BR SCNd N +.BR SCNd \fIN\fP, +.BR SCNi \fIN\fP, +.BR SCNu \fIN\fP, and -.BR SCNi N, +.BI SCNx N, (defined in .IR <inttypes.h> ); resulting for example in -.B %"SCNd8" +.B %"SCNu8" or -.B %"SCNi8" +.B %"SCNx8" for scanning -.I int8_t +.I uint8_t values. .PP .IR "Conforming to" : diff --git a/man3/uint16_t.3 b/man3/uint16_t.3 index db50c0f09..027707f61 100644 --- a/man3/uint16_t.3 +++ b/man3/uint16_t.3 @@ -1 +1 @@ -.so man7/system_data_types.7 +.so man3/intN_t.3 diff --git a/man3/uint32_t.3 b/man3/uint32_t.3 index db50c0f09..027707f61 100644 --- a/man3/uint32_t.3 +++ b/man3/uint32_t.3 @@ -1 +1 @@ -.so man7/system_data_types.7 +.so man3/intN_t.3 diff --git a/man3/uint64_t.3 b/man3/uint64_t.3 index db50c0f09..027707f61 100644 --- a/man3/uint64_t.3 +++ b/man3/uint64_t.3 @@ -1 +1 @@ -.so man7/system_data_types.7 +.so man3/intN_t.3 diff --git a/man3/uint8_t.3 b/man3/uint8_t.3 index db50c0f09..027707f61 100644 --- a/man3/uint8_t.3 +++ b/man3/uint8_t.3 @@ -1 +1 @@ -.so man7/system_data_types.7 +.so man3/intN_t.3 diff --git a/man3/uintN_t.3 b/man3/uintN_t.3 index db50c0f09..027707f61 100644 --- a/man3/uintN_t.3 +++ b/man3/uintN_t.3 @@ -1 +1 @@ -.so man7/system_data_types.7 +.so man3/intN_t.3 diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 index 836b390c6..f4b30caba 100644 --- a/man7/system_data_types.7 +++ b/man7/system_data_types.7 @@ -1154,90 +1154,6 @@ POSIX.1-2001 and later. .\"------------------------------------- uid_t ----------------------/ .\"------------------------------------- uintmax_t --------------------/ .\"------------------------------------- uintN_t ----------------------/ -.TP -.IR uint N _t -.RS -.IR Include : -.IR <stdint.h> . -Alternatively, -.IR <inttypes.h> . -.PP -.IR uint8_t , -.IR uint16_t , -.IR uint32_t , -.I uint64_t -.PP -An unsigned integer type -of a fixed width of exactly N bits, -N being the value specified in its type name. -According to the C language standard, they shall be -capable of storing values in the range [0, -.BR UINT N _MAX ], -substituting N by the appropriate number. -.PP -According to POSIX, -.IR uint8_t , -.IR uint16_t , -and -.I uint32_t -are required; -.I uint64_t -is only required in implementations that provide integer types -with width 64; -and all other types of this form are optional. -.PP -The length modifiers for the -.IR uint N _t -types for the -.BR printf (3) -family of functions -are expanded by macros of the forms -.BR PRIu N, -.BR PRIo N, -.BR PRIx N, -and -.BR PRIX N -(defined in -.IR <inttypes.h> ); -resulting for example in -.B %"PRIu32" -or -.B %"PRIx32" -for printing -.I uint32_t -values. -The length modifiers for the -.IR uint N _t -types for the -.BR scanf (3) -family of functions -are expanded by macros of the forms -.BR SCNu N, -.BR SCNo N, -.BR SCNx N, -and -.BR SCNX N -(defined in -.IR <inttypes.h> ); -resulting for example in -.B %"SCNu16" -or -.B %"SCNx16" -for scanning -.I uint16_t -values. -.PP -.IR "Conforming to" : -C99 and later; POSIX.1-2001 and later. -.PP -.IR "See also" : -the -.IR intmax_t , -.IR int N _t , -and -.IR uintmax_t -types in this page. -.RE .\"------------------------------------- uintptr_t --------------------/ .TP .I uintptr_t -- 2.33.1
