7.24.4 General wide string utilities

• 7.24.4.1 Wide string numeric conversion functions
  • 7.24.4.1.1 The wcstod, wcstof, and wcstold functions
  • 7.24.4.1.2 The wcstol, wcstoll, wcstoul, and wcstoull functions
• 7.24.4.2 Wide string copying functions
  • 7.24.4.2.1 The wcscpy function
  • 7.24.4.2.2 The wcsncpy function
  • 7.24.4.2.3 The wmemcpy function
  • 7.24.4.2.4 The wmemmove function
• 7.24.4.3 Wide string concatenation functions
  • 7.24.4.3.1 The wcscat function
  • 7.24.4.3.2 The wcsncat function
• 7.24.4.4 Wide string comparison functions
  • 7.24.4.4.1 The wcscmp function
  • 7.24.4.4.2 The wcscoll function
  • 7.24.4.4.3 The wcsncmp function
  • 7.24.4.4.4 The wcsxfrm function
  • 7.24.4.4.5 The wmemcmp function
• 7.24.4.5 Wide string search functions
  • 7.24.4.5.1 The wcschr function
  • 7.24.4.5.2 The wcscspn function
  • 7.24.4.5.3 The wcspbrk function
  • 7.24.4.5.4 The wcsrchr function
  • 7.24.4.5.5 The wcsspn function
  • 7.24.4.5.6 The wcsstr function
  • 7.24.4.5.7 The wcstok function
  • 7.24.4.5.8 The wmemchr function
• 7.24.4.6 Miscellaneous functions
  • 7.24.4.6.1 The wcslen function
  • 7.24.4.6.2 The wmemset function

1

The header <wchar.h> declares a number of functions useful for wide string manipulation. Various methods are used for determining the lengths of the arrays, but in all cases a wchar_t * argument points to the initial (lowest addressed) element of the array. If an array is accessed beyond the end of an object, the behavior is undefined.

2

Where an argument declared as size_t n determines the length of the array for a function, n can have the value zero on a call to that function. Unless explicitly stated otherwise in the description of a particular function in this subclause, pointer arguments on such a call shall still have valid values, as described in 7.1.4. On such a call, a function that locates a wide character finds no occurrence, a function that compares two wide character sequences returns zero, and a function that copies wide characters copies zero wide characters.