Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

Guardian Native C Library Calls (t - z) wcstoull(3)
NAME
wcstoull - Converts wide-character strings to an unsigned long long integer
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
SYNOPSIS
#include <wchar.h>
unsigned long long int wcstoull(
const wchar_t *nptr,
wchar_t **endptr,
int base);
PARAMETERS
nptr Contains a pointer to the wide-character string that is to be converted to an
unsigned long long integer.
endptr Points to a pointer in which the wcstoull() function stores the position in the
string specified by the nptr parameter where a wide character is found that is not
a valid character for the purpose of this conversion.
base Specified the radix in which the wide characters are interpreted.
DESCRIPTION
The wcstoull() function converts the initial portion of the wide-character string pointed to by the
nptr parameter to an unsigned long long integer representation. The input wide-character string
is first divided into three parts:
• White space: An initial (possibly empty) sequence of wide-character spaces, as specified
by the iswspace() function.
• Subject sequence: A sequence of wide characters that are valid in an integer constant of
the radix determined by the base parameter.
• Unrecognized characters: A final sequence of unrecognized wide-character codes,
including the terminating null wide character.
If possible, the subject is then converted to an unsigned integer and the result is returned.
The base parameter can take values between 0 and 36.
• If the base value is 0 (zero), the subject string can be a decimal, octal, or hexadecimal
integer constant. A decimal constant begins with a nonzero digit, and consists of a
sequence of decimal digits. An octal constant consists of the prefix 0 (zero) optionally
followed by a sequence of digits in the range 0 through 7. A hexadecimal constant con-
sists of the prefix 0x or 0X followed by a sequence consisting of decimal digits and the
letters in the range a (or A) to f (or F).
• If the base value is between 2 and 36, the subject string can be a sequence of digits and
the letters a (or A) to z (or Z) that are used to represent an integer in the specified base.
Alphabetic characters represent digits with an equivalent decimal value from 10 (for the
letter A) to 35 (for the letter Z). The subject string can only have digits with a value less
than base and alphabetic characters with equivalent values less than base. For example,
when the value of the base parameter is 20, only the following value assignments are
converted:
527192-007 Hewlett-Packard Company 7−87