WCSTOIMAX(3C) Standard C Library Functions WCSTOIMAX(3C)
NAME
wcstoimax, wcstoumax - convert wide-character string to integer type
SYNOPSIS
#include <stddef.h>
#include <inttypes.h>
intmax_t wcstoimax(
const wchar_t *restrict nptr,
wchar_t **restrict endptr,
int base);
uintmax_t wcstoumax(
const wchar_t *restrict nptr,
wchar_t **restrict endptr,
int base);
DESCRIPTION
These functions are equivalent to the
wcstol(3C),
wcstoll(3C),
wcstoul(3C), and
wcstoull(3C) functions, respectively, except that
the initial portion of the wide string is converted to
intmax_t and
uintmax_t representation, respectively.
RETURN VALUES
These functions return the converted value, if any. If no conversion
could be performed, 0 is returned. If the correct value is outside
the range of representable values, {
INTMAX_MAX}, {
INTMAX_MIN}, or
{
UINTMAX_MAX} is returned (according to the return type and sign of
the value), and
errno is set to
ERANGE.
ERRORS
These functions will fail if:
EINVAL The value of
base is not supported.
ERANGE The value to be returned is not representable.
These functions may fail if:
EINVAL No conversion could be performed.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
wcstol(3C),
wcstoul(3C),
attributes(7),
standards(7) December 1, 2003 WCSTOIMAX(3C)
