WCSXFRM(3) BSD Library Functions Manual WCSXFRM(3)

NAME
     wwccssxxffrrmm, wwccssxxffrrmmll - transform a wide string under locale

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     sizet
     wwccssxxffrrmm(wchart * restrict dst, const wchart * restrict src, sizet n);

     ##iinncclluuddee <>

     sizet
     wwccssxxffrrmmll(wchart * restrict dst, const wchart * restrict src, sizet n,
         localet loc);

DESCRIPTION
     The wwccssxxffrrmm() function transforms a null-terminated wide character string
     pointed to by src according to the current locale collation order then
     copies the transformed string into dst.  No more than n wide 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 transfor-
     mation), dst is permitted to be a NULL pointer.

     Comparing two strings using wwccssccmmpp() after wwccssxxffrrmm() is equivalent to
     comparing two original strings with wwccssccoollll().

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

RETURN VALUES
     Upon successful completion, wwccssxxffrrmm() 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), strxfrm(3), wcscmp(3), wcscoll(3), xlocale(3)

STANDARDS     The wwccssxxffrrmm() function conforms to ISO/IEC 9899:1999 (``ISO C99'').

BUGS
     The current implementation of wwccssxxffrrmm() only works in single-byte
     LCCTYPE locales, and falls back to using wwccssnnccppyy() in locales with
     extended character sets.

     Comparing two strings using wwccssccmmpp() after wwccssxxffrrmm() is not always equiv-
     alent to comparison with wwccssccoollll(); wwccssxxffrrmm() only stores information
     about primary collation weights into dst, whereas wwccssccoollll() compares
     characters using both primary and secondary weights.

BSD                             October 4, 2002                            BSD