function
<cstring>
strxfrm
size_t strxfrm ( char * destination, const char * source, size_t num );
Transform string using locale
Transforms the C 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.
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 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 string, not including the terminating null-character.
size_t is an unsigned integral type.
See also
- strncpy
- Copy characters from string (function)
- strncmp
- Compare characters of two strings (function)
- strcoll
- Compare two strings using locale (function)