STRXFRM(3) BSD Library Functions Manual STRXFRM(3)

NAME
     ssttrrxxffrrmm, ssttrrxxffrrmmll - transform a string under locale

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     sizet
     ssttrrxxffrrmm(char * restrict dst, const char * restrict src, sizet n);

     ##iinncclluuddee <>

     sizet
     ssttrrxxffrrmmll(char * restrict dst, const char * restrict src, sizet n,
         localet loc);

DESCRIPTION
     The ssttrrxxffrrmm() 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 ssttrrccmmpp() after ssttrrxxffrrmm() is equal to compar-
     ing two original strings with ssttrrccoollll().

     While the ssttrrxxffrrmm() function uses the current locale, the ssttrrxxffrrmmll()
     function may be passed a locale directly. See xlocale(3) for more infor-
     mation.

RETURN VALUES
     Upon successful completion, ssttrrxxffrrmm() returns the length of the trans-
     formed string not including the terminating null character.  If this
     value is n or more, the contents of dst are indeterminate.

SEE ALSO
     setlocale(3), strcmp(3), strcoll(3), wcsxfrm(3), xlocale(3)

STANDARDS     The ssttrrxxffrrmm() function conforms to ISO/IEC 9899:1990 (``ISO C90'').

BSD                              June 4, 1993                              BSD