NAME    [Toc]    [Back]

     strxfrm -- transform a string under locale

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <string.h>

     size_t
     strxfrm(char * restrict dst, const char * restrict src, size_t n);

DESCRIPTION    [Toc]    [Back]

     The strxfrm() function transforms a null-terminated string pointed to by
     src according to the current locale collation if any, then copies the
     transformed string into dst.  Not more than n characters are copied into
     dst, including the terminating null character added.  If n is set to 0
     (it helps to determine an actual size needed for transformation), dst is
     permitted to be a NULL pointer.

     Comparing two strings using strcmp() after strxfrm() is equal to comparing
 two original strings with strcoll().

RETURN VALUES    [Toc]    [Back]

     Upon successful completion, strxfrm() returns the length of the transformed
 string not including the terminating null character.  If this
     value is n or more, the contents of dst are indeterminate.

SEE ALSO    [Toc]    [Back]

     setlocale(3), strcmp(3), strcoll(3), wcsxfrm(3)

STANDARDS    [Toc]    [Back]

     The strxfrm() function conforms to ISO/IEC 9899:1990 (``ISO C89'').


FreeBSD 5.2.1			 June 4, 1993			 FreeBSD 5.2.1