Document [u]int_fastN_t
v2 cover Document [u]int_fastN_t
This patches are the v2 of the patches 5 to 8 of a previous patchset:
https://lore.kernel.org/linux-man/[email protected]/T/#t
Alejandro Colomar (4):
system_data_types.7: Add int_fastN_t family of types int_fast8_t.3, int_fast16_t.3, int_fast32_t.3, int_fast64_t.3,
int_fastN_t.3: New links to system_data_types(7)
system_data_types.7: Add uint_fastN_t family of types uint_fast8_t.3, uint_fast16_t.3, uint_fast32_t.3, uint_fast64_t.3,
uint_fastN_t.3: New links to system_data_types(7)
man3/int_fast16_t.3 | 1 + man3/int_fast32_t.3 | 1 + man3/int_fast64_t.3 | 1 + man3/int_fast8_t.3 | 1 + man3/int_fastN_t.3 | 1 + man3/uint_fast16_t.3 | 1 + man3/uint_fast32_t.3 | 1 + man3/uint_fast64_t.3 | 1 + man3/uint_fast8_t.3 | 1 + man3/uint_fastN_t.3 | 1 + man7/system_data_types.7 | 157 +++++++++++++++++++++++++++++++++++++++ 11 files changed, 167 insertions(+) create mode 100644 man3/int_fast16_t.3 create mode 100644 man3/int_fast32_t.3 create mode 100644 man3/int_fast64_t.3 create mode 100644 man3/int_fast8_t.3 create mode 100644 man3/int_fastN_t.3 create mode 100644 man3/uint_fast16_t.3 create mode 100644 man3/uint_fast32_t.3 create mode 100644 man3/uint_fast64_t.3 create mode 100644 man3/uint_fast8_t.3 create mode 100644 man3/uint_fastN_t.3
Signature · 1 line
2.28.0
PATCH v2 1/4 system_data_types.7: Add int_fastN_t family of types
--- man7/system_data_types.7 | 77 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+)
man7/system_data_types.7 +77 -0
@@ -329,6 +329,83 @@ C99 and later; POSIX.1-2001 and later. See also: .BR imaxdiv (3) .RE +.\"------------------------------------- int_fastN_t ------------------/ +.TP +.IR int_fast N _t +.RS +Include: +.IR <stdint.h> . +Alternatively, +.IR <inttypes.h> . +.PP +.IR int_fast8_t , +.IR int_fast16_t , +.IR int_fast32_t , +.I int_fast64_t +.PP +Usually the fastest (see Notes) signed integer type +of a width of at least 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 +.RB [ INT_FAST N _MIN , +.BR INT_FAST N _MAX ], +substituting N by the appropriate number. +.PP +The length modifiers for the +.IR int_fast N _t +types for the +.BR printf (3) +family of functions +are expanded by macros of the forms +.BR PRIdFAST N +and +.BR PRIiFAST N +(defined in +.IR <inttypes.h> ); +resulting for example in +.B %"PRIdFAST64" +or +.B %"PRIiFAST64" +for printing +.I int_fast64_t +values. +The length modifiers for the +.IR int_fast N _t +types for the +.BR scanf (3) +family of functions +are expanded by macros of the forms +.BR SCNdFAST N +and +.BR SCNiFAST N, +(defined in +.IR <inttypes.h> ); +resulting for example in +.B %"SCNdFAST8" +or +.B %"SCNiFAST8" +for scanning +.I int_fast8_t +values. +.PP +Conforming to: +C99 and later; POSIX.1-2001 and later. +.PP +Notes: +Where there is no single type that is fastest for all purposes, +the implementation may choose any type +with the required signedness and at least the minimum width. +.PP +See also the +.IR int_least N _t , +.IR int N _t , +.IR uint_fast N _t , +.IR uint_least N _t +and +.IR uint N _t +types in this page. +.RE .\"------------------------------------- intmax_t ---------------------/ .TP .I intmax_t
Signature · 1 line
2.28.0
Re: [PATCH v2 1/4] system_data_types.7: Add int_fastN_t family of types
Thanks, Alex. Applied.
Quoted 94 lines · Alejandro Colomar
Signed-off-by Alejandro Colomar <[email protected]>--- man7/system_data_types.7 | 77 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+)man7/system_data_types.7 +77
-0@@ -329,6 +329,83 @@ C99 and later; POSIX.1-2001 and later. See also: .BR imaxdiv (3) .RE +.\"------------------------------------- int_fastN_t ------------------/ +.TP +.IR int_fast N _t +.RS +Include: +.IR <stdint.h> . +Alternatively, +.IR <inttypes.h> . +.PP +.IR int_fast8_t , +.IR int_fast16_t , +.IR int_fast32_t , +.I int_fast64_t +.PP +Usually the fastest (see Notes) signed integer type +of a width of at least 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 +.RB [ INT_FAST N _MIN , +.BR INT_FAST N _MAX ], +substituting N by the appropriate number. +.PP +The length modifiers for the +.IR int_fast N _t +types for the +.BR printf (3) +family of functions +are expanded by macros of the forms +.BR PRIdFAST N +and +.BR PRIiFAST N +(defined in +.IR <inttypes.h> ); +resulting for example in +.B %"PRIdFAST64" +or +.B %"PRIiFAST64" +for printing +.I int_fast64_t +values. +The length modifiers for the +.IR int_fast N _t +types for the +.BR scanf (3) +family of functions +are expanded by macros of the forms +.BR SCNdFAST N +and +.BR SCNiFAST N, +(defined in +.IR <inttypes.h> ); +resulting for example in +.B %"SCNdFAST8" +or +.B %"SCNiFAST8" +for scanning +.I int_fast8_t +values. +.PP +Conforming to: +C99 and later; POSIX.1-2001 and later. +.PP +Notes: +Where there is no single type that is fastest for all purposes, +the implementation may choose any type +with the required signedness and at least the minimum width. +.PP +See also the +.IR int_least N _t , +.IR int N _t , +.IR uint_fast N _t , +.IR uint_least N _t +and +.IR uint N _t +types in this page. +.RE .\"------------------------------------- intmax_t ---------------------/ .TP .I intmax_t
Signature · 3 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
PATCH v2 2/4 int_fast8_t.3, int_fast16_t.3, int_fast32_t.3, int_fast64_t.3, int_fastN_t.3: New links to system_data_types(7)
In reply to Alejandro Colomar--- man3/int_fast16_t.3 | 1 + man3/int_fast32_t.3 | 1 + man3/int_fast64_t.3 | 1 + man3/int_fast8_t.3 | 1 + man3/int_fastN_t.3 | 1 + 5 files changed, 5 insertions(+) create mode 100644 man3/int_fast16_t.3 create mode 100644 man3/int_fast32_t.3 create mode 100644 man3/int_fast64_t.3 create mode 100644 man3/int_fast8_t.3 create mode 100644 man3/int_fastN_t.3
man3/int_fast16_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
man3/int_fast32_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
man3/int_fast64_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
man3/int_fast8_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
man3/int_fastN_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
Signature · 1 line
2.28.0
Re: [PATCH v2 2/4] int_fast8_t.3, int_fast16_t.3, int_fast32_t.3, int_fast64_t.3, int_fastN_t.3: New links to system_data_types(7)
Thanks, Alex. Applied.
Quoted 50 lines · Alejandro Colomar
Signed-off-by Alejandro Colomar <[email protected]>--- man3/int_fast16_t.3 | 1 + man3/int_fast32_t.3 | 1 + man3/int_fast64_t.3 | 1 + man3/int_fast8_t.3 | 1 + man3/int_fastN_t.3 | 1 + 5 files changed, 5 insertions(+) create mode 100644 man3/int_fast16_t.3 create mode 100644 man3/int_fast32_t.3 create mode 100644 man3/int_fast64_t.3 create mode 100644 man3/int_fast8_t.3 create mode 100644 man3/int_fastN_t.3man3/int_fast16_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7man3/int_fast32_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7man3/int_fast64_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7man3/int_fast8_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7man3/int_fastN_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7
Signature · 3 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
PATCH v2 3/4 system_data_types.7: Add uint_fastN_t family of types
In reply to Alejandro Colomar--- man7/system_data_types.7 | 80 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+)
man7/system_data_types.7 +80 -0
@@ -1348,6 +1348,86 @@ See also: .BR getpwnam (2), .BR credentials (7) .RE +.\"------------------------------------- uint_fastN_t -----------------/ +.TP +.IR uint_fast N _t +.RS +Include: +.IR <stdint.h> . +Alternatively, +.IR <inttypes.h> . +.PP +.IR uint_fast8_t , +.IR uint_fast16_t , +.IR uint_fast32_t , +.I uint_fast64_t +.PP +Usually the fastest (see Notes) unsigned integer type +of a width of at least 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_FAST N _MAX ], +substituting N by the appropriate number. +.PP +The length modifiers for the +.IR uint_fast N _t +types for the +.BR printf (3) +family of functions +are expanded by macros of the forms +.BR PRIuFAST N, +.BR PRIoFAST N, +.BR PRIxFAST N +and +.BR PRIXFAST N +(defined in +.IR <inttypes.h> ); +resulting for example in +.B %"PRIuFAST32" +or +.B %"PRIxFAST32" +for printing +.I uint_fast32_t +values. +The length modifiers for the +.IR uint_fast N _t +types for the +.BR scanf (3) +family of functions +are expanded by macros of the forms +.BR SCNuFAST N, +.BR SCNoFAST N, +.BR SCNxFAST N +and +.BR SCNXFAST N +(defined in +.IR <inttypes.h> ); +resulting for example in +.B %"SCNuFAST16" +or +.B %"SCNxFAST16" +for scanning +.I uint_fast16_t +values. +.PP +Conforming to: +C99 and later; POSIX.1-2001 and later. +.PP +Notes: +Where there is no single type that is fastest for all purposes, +the implementation may choose any type +with the required signedness and at least the minimum width. +.PP +See also the +.IR int_fast N _t , +.IR int_least N _t , +.IR int N _t , +.IR uint_least N _t +and +.IR uint N _t +types in this page. +.RE .\"------------------------------------- uintmax_t --------------------/ .TP .I uintmax_t
Signature · 1 line
2.28.0
Re: [PATCH v2 3/4] system_data_types.7: Add uint_fastN_t family of types
Thanks, Alex. Applied.
Quoted 97 lines · Alejandro Colomar
Signed-off-by Alejandro Colomar <[email protected]>--- man7/system_data_types.7 | 80 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+)man7/system_data_types.7 +80
-0@@ -1348,6 +1348,86 @@ See also: .BR getpwnam (2), .BR credentials (7) .RE +.\"------------------------------------- uint_fastN_t -----------------/ +.TP +.IR uint_fast N _t +.RS +Include: +.IR <stdint.h> . +Alternatively, +.IR <inttypes.h> . +.PP +.IR uint_fast8_t , +.IR uint_fast16_t , +.IR uint_fast32_t , +.I uint_fast64_t +.PP +Usually the fastest (see Notes) unsigned integer type +of a width of at least 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_FAST N _MAX ], +substituting N by the appropriate number. +.PP +The length modifiers for the +.IR uint_fast N _t +types for the +.BR printf (3) +family of functions +are expanded by macros of the forms +.BR PRIuFAST N, +.BR PRIoFAST N, +.BR PRIxFAST N +and +.BR PRIXFAST N +(defined in +.IR <inttypes.h> ); +resulting for example in +.B %"PRIuFAST32" +or +.B %"PRIxFAST32" +for printing +.I uint_fast32_t +values. +The length modifiers for the +.IR uint_fast N _t +types for the +.BR scanf (3) +family of functions +are expanded by macros of the forms +.BR SCNuFAST N, +.BR SCNoFAST N, +.BR SCNxFAST N +and +.BR SCNXFAST N +(defined in +.IR <inttypes.h> ); +resulting for example in +.B %"SCNuFAST16" +or +.B %"SCNxFAST16" +for scanning +.I uint_fast16_t +values. +.PP +Conforming to: +C99 and later; POSIX.1-2001 and later. +.PP +Notes: +Where there is no single type that is fastest for all purposes, +the implementation may choose any type +with the required signedness and at least the minimum width. +.PP +See also the +.IR int_fast N _t , +.IR int_least N _t , +.IR int N _t , +.IR uint_least N _t +and +.IR uint N _t +types in this page. +.RE .\"------------------------------------- uintmax_t --------------------/ .TP .I uintmax_t
Signature · 3 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
PATCH v2 4/4 uint_fast8_t.3, uint_fast16_t.3, uint_fast32_t.3, uint_fast64_t.3, uint_fastN_t.3: New links to system_data_types(7)
In reply to Alejandro Colomar--- man3/uint_fast16_t.3 | 1 + man3/uint_fast32_t.3 | 1 + man3/uint_fast64_t.3 | 1 + man3/uint_fast8_t.3 | 1 + man3/uint_fastN_t.3 | 1 + 5 files changed, 5 insertions(+) create mode 100644 man3/uint_fast16_t.3 create mode 100644 man3/uint_fast32_t.3 create mode 100644 man3/uint_fast64_t.3 create mode 100644 man3/uint_fast8_t.3 create mode 100644 man3/uint_fastN_t.3
man3/uint_fast16_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
man3/uint_fast32_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
man3/uint_fast64_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
man3/uint_fast8_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
man3/uint_fastN_t.3 new file +1 -0
@@ -0,0 +1 @@ +.so man7/system_data_types.7
Signature · 1 line
2.28.0
Re: [PATCH v2 4/4] uint_fast8_t.3, uint_fast16_t.3, uint_fast32_t.3, uint_fast64_t.3, uint_fastN_t.3: New links to system_data_types(7)
Thanks, Alex. Applied.
Quoted 50 lines · Alejandro Colomar
Signed-off-by Alejandro Colomar <[email protected]>--- man3/uint_fast16_t.3 | 1 + man3/uint_fast32_t.3 | 1 + man3/uint_fast64_t.3 | 1 + man3/uint_fast8_t.3 | 1 + man3/uint_fastN_t.3 | 1 + 5 files changed, 5 insertions(+) create mode 100644 man3/uint_fast16_t.3 create mode 100644 man3/uint_fast32_t.3 create mode 100644 man3/uint_fast64_t.3 create mode 100644 man3/uint_fast8_t.3 create mode 100644 man3/uint_fastN_t.3man3/uint_fast16_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7man3/uint_fast32_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7man3/uint_fast64_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7man3/uint_fast8_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7man3/uint_fastN_t.3 new file +1
-0@@ -0,0 +1 @@ +.so man7/system_data_types.7
Signature · 3 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/