1WCSTOIMAX(P)               POSIX Programmer's Manual              WCSTOIMAX(P)
2
3
4

NAME

6       wcstoimax,  wcstoumax  -  convert a wide-character string to an integer
7       type
8

SYNOPSIS

10       #include <stddef.h>
11       #include <inttypes.h>
12
13       intmax_t wcstoimax(const wchar_t *restrict nptr,
14              wchar_t **restrict endptr, int base);
15       uintmax_t wcstoumax(const wchar_t *restrict nptr,
16              wchar_t **restrict endptr, int base);
17
18

DESCRIPTION

20       These  functions  shall  be  equivalent  to  the  wcstol(),  wcstoll(),
21       wcstoul(), and wcstoull() functions, respectively, except that the ini‐
22       tial portion of the wide string shall  be  converted  to  intmax_t  and
23       uintmax_t representation, respectively.
24

RETURN VALUE

26       These functions shall return the converted value, if any.
27
28       If  no  conversion  could  be performed, zero shall be returned. If the
29       correct value is outside  the  range  of  representable  values,  {INT‐
30       MAX_MAX},  {INTMAX_MIN},  or {UINTMAX_MAX} shall be returned (according
31       to the return type and sign of the value, if any), and errno  shall  be
32       set to [ERANGE].
33

ERRORS

35       These functions shall fail if:
36
37       EINVAL The value of base is not supported.
38
39       ERANGE The value to be returned is not representable.
40
41
42       These functions may fail if:
43
44       EINVAL No conversion could be performed.
45
46
47       The following sections are informative.
48

EXAMPLES

50       None.
51

APPLICATION USAGE

53       None.
54

RATIONALE

56       None.
57

FUTURE DIRECTIONS

59       None.
60

SEE ALSO

62       wcstol()    ,    wcstoul()   ,   the   Base   Definitions   volume   of
63       IEEE Std 1003.1-2001, <inttypes.h>, <stddef.h>
64

66       Portions of this text are reprinted and reproduced in  electronic  form
67       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
68       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
69       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
70       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
71       event of any discrepancy between this version and the original IEEE and
72       The Open Group Standard, the original IEEE and The Open Group  Standard
73       is  the  referee document. The original Standard can be obtained online
74       at http://www.opengroup.org/unix/online.html .
75
76
77
78IEEE/The Open Group                  2003                         WCSTOIMAX(P)
Impressum