History of strxfrm

== Syntax ==

:int strxfrm(char * dest, const char * src, int n)

== Arguments ==

:dest

::The string to which the source string is to be copied.

:src

::The string which is to be copied to the destination string.

:n

::The maximum number of characters to copy to the destination string.

== Return ==

:The length of the transformed string, even if higher than n.

== Description ==

:Transforms the string src according to the current locale and copies up to the first n characters to dest. The string is transformed in such a way that the strcmp function may be used on the transformed strings to determine the correct collating sequence according to the locale-specific collating conventions set by (setlocale)?.

:Returns the number of characters needed to store the transformed string, even if greater than n.

:If n is zero, no part of the string is copied to dest (which now may also be NULL). Use this to find out the size required for dest.

=== Also see ===

:strcmp, (setlocale)?