wcstol(3)

wcstol3

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

Usage

#include <wchar.h>

long

wcstol(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);

long long

wcstoll(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 <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.

Releases

56 releases since FreeBSD 5.0-RELEASE; the text changed 32 times.

  1. 5.0–6.3
  2. 6.4
  3. 7.0
  4. 7.1
  5. 7.2
  6. 7.3
  7. 7.4
  8. 8.0
  9. 8.1
  10. 8.2
  11. 8.3
  12. 8.4
  13. 9.0
  14. 9.1
  15. 9.2
  16. 9.3
  17. 10.0
  18. 10.1
  19. 10.2
  20. 10.3
  21. 10.4
  22. 11.0
  23. 11.1
  24. 11.2
  25. 11.3
  26. 11.4
  27. 12.0
  28. 12.1
  29. 12.2
  30. 12.3
  31. 12.4
  32. 13.0–13.2
  33. 13.3–16.0

Standards

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

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.