From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/string%2Fbyte%2Fstrtoimax.html | 78 ++++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 devdocs/c/string%2Fbyte%2Fstrtoimax.html (limited to 'devdocs/c/string%2Fbyte%2Fstrtoimax.html') diff --git a/devdocs/c/string%2Fbyte%2Fstrtoimax.html b/devdocs/c/string%2Fbyte%2Fstrtoimax.html new file mode 100644 index 00000000..2e199efe --- /dev/null +++ b/devdocs/c/string%2Fbyte%2Fstrtoimax.html @@ -0,0 +1,78 @@ +

strtoimax, strtoumax

Defined in header <inttypes.h> 
intmax_t strtoimax( const char *restrict nptr,
+                    char **restrict endptr, int base );
+		 (since C99) 
uintmax_t strtoumax( const char *restrict nptr,
+                     char **restrict endptr, int base );
+		 (since C99)

Interprets an integer value in a byte string pointed to by nptr.

+

Discards any whitespace characters (as identified by calling isspace) until the first non-whitespace character is found, then takes as many characters as possible to form a valid base-n (where n=base) integer number representation and converts them to an integer value. The valid integer value consists of the following parts:

+

The set of valid values for base is {0,2,3,...,36}. The set of valid digits for base-2 integers is {0,1}, for base-3 integers is {0,1,2}, and so on. For bases larger than 10, valid digits include alphabetic characters, starting from Aa for base-11 integer, to Zz for base-36 integer. The case of the characters is ignored.

+

Additional numeric formats may be accepted by the currently installed C locale.

+

If the value of base is ​0​, the numeric base is auto-detected: if the prefix is 0, the base is octal, if the prefix is 0x or 0X, the base is hexadecimal, otherwise the base is decimal.

+

If the minus sign was part of the input sequence, the numeric value calculated from the sequence of digits is negated as if by unary minus in the result type.

+

The functions sets the pointer pointed to by endptr to point to the character past the last character interpreted. If endptr is a null pointer, it is ignored.

+

If the nptr is empty or does not have the expected form, no conversion is performed, and (if endptr is not a null pointer) the value of nptr is stored in the object pointed to by endptr.

+

Parameters

+ + + +
nptr - pointer to the null-terminated byte string to be interpreted
endptr - pointer to a pointer to character.
base - base of the interpreted integer value

Return value

Example

#include <errno.h>
+#include <inttypes.h>
+#include <stdio.h>
+#include <string.h>
+ 
+int main(void)
+{
+    char* endptr;
+ 
+    printf("%ld\n", strtoimax(" -123junk",&endptr,10)); /* base 10                    */
+    printf("%ld\n", strtoimax("11111111",&endptr,2));   /* base 2                     */
+    printf("%ld\n", strtoimax("XyZ",&endptr,36));       /* base 36                    */
+    printf("%ld\n", strtoimax("010",&endptr,0));        /* octal auto-detection       */
+    printf("%ld\n", strtoimax("10",&endptr,0));         /* decimal auto-detection     */
+    printf("%ld\n", strtoimax("0x10",&endptr,0));       /* hexadecimal auto-detection */
+ 
+    /* range error             */
+    /* LONG_MAX+1 --> LONG_MAX */
+    errno = 0;
+    printf("%ld\n", strtoimax("9223372036854775808",&endptr,10));
+    printf("%s\n", strerror(errno));
+ 
+    return 0;
+}

Output:

+
-123
+255
+44027
+8
+10
+16
+9223372036854775807
+Numerical result out of range

References

See also

+ + + +
+
(C99)(C99)
 converts a wide string to intmax_t or uintmax_t
(function)
+
(C99)
 converts a byte string to an integer value
(function)
+
(C99)
 converts a byte string to an unsigned integer value
(function)
C++ documentation for strtoimax, strtoumax
+

+ © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
+ https://en.cppreference.com/w/c/string/byte/strtoimax +

+
-- cgit v1.2.3