function
<cwchar>
wcsxfrm
size_t wcsxfrm (wchar_t* destination, const wchar_t* source, size_t num);
Transform wide string using locale
Transforms the C wide string pointed by source according to the current locale and copies the first num characters of the transformed string to destination, returning its length.
Alternativelly, the function can be used to only retrieve the length, by specifying a null pointer for destination and zero for num.
destination and source shall not overlap.
The behavior of this function depends on the LC_COLLATE category of the selected C locale.
This is the wide character equivalent of strncmp (<cstring>).
Parameters
- destination
- Pointer to the destination array where the content is to be copied.
It can be a null pointer if the argument for num is zero.
- source
- C wide string to be transformed.
- num
- Maximum number of characters to be copied to destination.
size_t is an unsigned integral type.
Return Value
The length of the transformed wide string, not including the terminating null wide character.
size_t is an unsigned integral type.
See also
- strxfrm
- Transform string using locale (function)
- wcscoll
- Compare two wide strings using locale (function)
- wcsncpy
- Copy characters from wide string (function)
- wcsncmp
- Compare characters of two wide strings (function)