Message ID | 20201001143203.98803-4-colomar.6.4.3@gmail.com |
---|---|
State | New |
Headers | show |
Series | Document [u]int_fastN_t | expand |
Thanks, Alex. Applied. On 10/1/20 4:32 PM, Alejandro Colomar wrote: > Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> > --- > man7/system_data_types.7 | 80 ++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 80 insertions(+) > > diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 > index c5d0b700d..c130b7256 100644 > --- a/man7/system_data_types.7 > +++ b/man7/system_data_types.7 > @@ -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 >
diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 index c5d0b700d..c130b7256 100644 --- a/man7/system_data_types.7 +++ b/man7/system_data_types.7 @@ -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
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> --- man7/system_data_types.7 | 80 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+)