wcstol(3)

wcstol3

Convert a wide character string value to a intmax_t, long, long long, unsigned long, unsigned long long, or uintmax_t integer

Usage

#include <wchar.h>

long

wcstol(const wchar_t *restrict nptr, wchar_t **restrict endptr, int base);

long long

wcstoll(const wchar_t *restrict nptr, wchar_t **restrict endptr, int base);

unsigned long

wcstoul(const wchar_t *restrict nptr, wchar_t **restrict endptr, int base);

unsigned long long

wcstoull(const wchar_t *restrict nptr, wchar_t **restrict endptr, int base);

#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);

Library

Standard C Library (libc, -lc)

Overview

The wcstol(), wcstoul(), wcstoll(), wcstoull(), wcstoimax(), and wcstoumax() functions are wide-character versions of the strtol(), strtoul(), strtoll(), strtoull(), strtoimax(), and strtoumax() functions, respectively. Refer to their manual pages (for example strtol(3)) for details.

Extended locale versions of these functions are documented in wcstol_l(3). See xlocale(3) for more information.

Legacy synopsis

#include <stddef.h> #include <inttypes.h>

The include file ⟨stddef.h⟩ is necessary for the wcstoimax() and wcstoumax() functions.

Releases

145 releases since Mac OS X 10.3; the text changed 1 time.

  1. 10.3–10.4.11
  2. 10.5–26.5

Standards

The wcstol(), wcstoul(), wcstoll(), wcstoull(), wcstoimax(), and wcstoumax() functions conform to ISO/IEC 9899:1999 (“ISO C99”).

From Libc 1752.120.2 in macOS 26.5. Parsed by carta from the page's mdoc source.