Transforms a locale-specific character array.
#include <string.h> size_t strxfrm(char *dest, const char *source, size_t n);
dest
A pointer to a memory area to copy the transformed string to.
source
A pointer to the character string to transform.
n
The maximum number of characters in source to transform.
This function copies characters from the character array pointed to by source to the character array pointed to by dest, transforming each character as specified by the LC_COLLATE component of the current locale. The transformation creates a string in dest so that applying the strcmp() function to two transformed strings returns a value greater than, equal to, or less than zero, corresponding to the result of the strcoll() function applied to the same two original strings.
The EWL implementation of this function ignores the current locale. Instead, this function copies a maximum of n characters from the character array pointed to by source to the character array pointed to by dest using the strncpy() function. It is included in the string library to conform to the ISO/IEC C Standard Library specification.
The function returns the length of dest after it has received source.
This facility may not be available on some configurations of the EWL.