standard.C.string.strxfrm

strxfrm is available since version 1.0.

Prototype:

number strxfrm(string strDest, string strSource, number count)

Parameters

strDest
Destination string.
strSource
Source string.
count
Maximum number of characters to place in strDest.

Description:

Transform a string based on locale-specific information. The strxfrm function transforms the string pointed to by strSource into a new collated form that is stored in strDest. No more than count characters, including the null character, are transformed and placed into the resulting string. The transformation is made using the current locale's LC_COLLATE category setting.

Return value:

Returns the length of the transformed string, not counting the terminating null character. If the return value is greater than or equal to count, the content of strDest is unpredictable.