]> git.ipfire.org Git - thirdparty/gcc.git/commitdiff
Document unsigned constants in intrinsic modules.
authorThomas Koenig <tkoenig@gcc.gnu.org>
Tue, 7 Jan 2025 14:23:29 +0000 (15:23 +0100)
committerThomas Koenig <tkoenig@gcc.gnu.org>
Tue, 7 Jan 2025 18:26:54 +0000 (19:26 +0100)
gcc/fortran/ChangeLog:

* intrinsic.texi (ISO_FORTRAN_ENV):  Also mention INT8 in the
text. Document UINT8, UINT16, UINT32 and UINT64.
(ISO_C_BINDING): New table for unsigned KIND numbers.

gcc/fortran/intrinsic.texi

index 7c7e4c9372bd78cafe05a70855eecd02485d3b22..55933d23e18811cf9873adcfbf080d4b4024c750 100644 (file)
@@ -15305,7 +15305,7 @@ Identifies the preconnected unit identified by the asterisk
 
 @item @code{INT8}, @code{INT16}, @code{INT32}, @code{INT64}:
 Kind type parameters to specify an INTEGER type with a storage
-size of 16, 32, and 64 bits. It is negative if a target platform
+size of 8, 16, 32, and 64 bits. It is negative if a target platform
 does not support the particular kind. (Fortran 2008 or later.)
 
 @item @code{INTEGER_KINDS}:
@@ -15368,6 +15368,12 @@ in the failed state. (TS 18508 or later.)
 @item @code{STAT_UNLOCKED}:
 Scalar default-integer constant used as @code{STAT=} return value by @code{UNLOCK} to
 denote that the lock variable is unlocked. (Fortran 2008 or later.)
+
+@item @code{UINT8}, @code{UINT16}, @code{UINT32}, @code{UINT64}:
+Kind type parameters to specify an UNSIGNED type with a storage
+size of 8, 16, 32, and 64 bits. It is negative if a target platform
+does not support the particular kind. (Extension, @pxref{Unsigned integers}.)
+
 @end table
 
 The module provides the following derived type:
@@ -15455,6 +15461,33 @@ Furthermore, if @code{_Float128} is supported in C, the named constants
 @item @code{CHARACTER}@tab @code{C_CHAR}        @tab @code{char}
 @end multitable
 
+GNU Fortran also provides as an extension, named constants for
+@code{UNSIGNED} integers @pxref{Unsigned integers}.
+@multitable @columnfractions .20 0.40 0.40
+@headitem Fortran Type  @tab Named constant         @tab C type
+@item @code{UNSIGNED}@tab @code{C_UNSIGNED}            @tab @code{unsigned int}
+@item @code{UNSIGNED}@tab @code{C_UNSIGNED_SHORT}      @tab @code{unsigned short}
+@item @code{UNSIGNED}@tab @code{C_UNSIGNED_CHAR}       @tab @code{unsigned char}
+@item @code{UNSINGED}@tab @code{C_UNSIGNED_LONG}       @tab @code{unsigned long}
+@item @code{UNSINGED}@tab @code{C_UNSIGNED_LONG_LONG}  @tab @code{unsigned long long}
+@item @code{UNSIGNED}@tab @code{C_UINTMAX_T}           @tab @code{uintmax_t}
+@item @code{UNSIGNED}@tab @code{C_UINT8_T}             @tab @code{uint8_t}
+@item @code{UNSIGNED}@tab @code{C_UINT16_T}            @tab @code{uint16_t}
+@item @code{UNSIGNED}@tab @code{C_UINT32_T}            @tab @code{uint32_t}
+@item @code{UNSIGNED}@tab @code{C_UINT64_T}            @tab @code{uint64_t}
+@item @code{UNSIGNED}@tab @code{C_UINT128_T}           @tab @code{uint128_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_FAST8_T}                @tab @code{uint_fast8_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_FAST16_T}       @tab @code{uint_fast16_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_FAST32_T}       @tab @code{uint_fast32_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_FAST64_T}       @tab @code{uint_fast64_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_FAST128_T}      @tab @code{uint_fast128_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_LEAST8_T}       @tab @code{uint_least8_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_LEAST16_T}      @tab @code{uint_least16_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_LEAST32_T}      @tab @code{uint_least32_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_LEAST64_T}      @tab @code{uint_least64_t}
+@item @code{UNSIGNED}@tab @code{C_UINT_LEAST128_T}     @tab @code{uint_least128_t}
+@end multitable
+
 Additionally, the following parameters of type @code{CHARACTER(KIND=C_CHAR)}
 are defined.