wcstol(3C) — DG/UX R4.11MU05



wcstol(3C)                     DG/UX R4.11MU05                    wcstol(3C)


NAME
       wcstol - convert a wide character string to a long integer

SYNOPSIS
       #include <wchar.h>
       long wcstol(const wchart *nptr, wchart **endptr, int base);
       long wcstoul(const wchart *nptr, wchart **endptr, int base);

DESCRIPTION
       wcstol returns, as a long integer, the value represented by the
       character string pointed to by nptr.  wcstoul returns, as an unsigned
       long integer, the value represented by the character string pointed
       to by nptr.  The string is scanned up to the first character
       inconsistent with the base.  Leading ``white-space'' characters [as
       defined by iswspace] are ignored.

       If the value of endptr is not a null pointer, a pointer to the wide
       character terminating the scan is returned in the location pointed to
       by endptr.  If no integer can be formed, that location is set to
       nptr, and zero is returned.

       If base is between 2 and 36, inclusive, it is used as the base for
       conversion.  After an optional leading sign, leading zeros are
       ignored, and a leading ``0x'' or ``0X'' is ignored if base is 16 and
       a leading )b or 0B is ignored if base is 2.

       If base is zero, the string itself determines the base as follows:
       After an optional leading sign a leading zero indicates octal
       conversion, and a leading ``0x'' or ``0X'' hexadecimal conversion.
       Otherwise, decimal conversion is used.

Return Values
       For wcstol, if the value represented by nptr would cause overflow,
       LONGMAX or LONGMIN is returned (according to the sign of the
       value), and errno is set to the value ERANGE.

       For wcstoul, if the value represented by nptr would cause overflow,
       ULONGMAX is returned, and errno is set to the value ERANGE.

       If wcstol or wcstoul is given a base other than zero or 2 through 36,
       it returns zero and sets errno to EINVAL.  Otherwise, wcstol and
       wcstoul return the represented value.

   Errors
       In the following conditions, wcstol fails and sets errno to:

        EINVAL The value of base is not supported.

        EINVAL No conversion could be performed.

        ERANGE The value to be returned is not representable.

REFERENCES
       scanf(3S), wcstod(3C)


Licensed material--property of copyright holder(s)
Museum
