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