wcsxfrm(3)                                                   wcsxfrm(3)

  wcsxfrm()

  NAME

    wcsxfrm() - transform a wide-character string under locale

  SYNOPSIS

    #include 

    size_t wcsxfrm (wchar_t *dst, const wchar_t *src, size_t n)

  DESCRIPTION

    The wcsxfrm(3) function transforms a wide-character string, src, to the
    current locale and stores at most n wide-character codes of it in dst. The
    transformed string will still compare properly.

    This function is a subset of wcscoll(3)'s functionality, and is primarily
    a tool for efficient comparisons. When many comparisons must be made,
    using wcsxfrm(3) and wcscmp(3) can be faster than using wcscoll(3).

    In the C and POSIX locales, it is nearly identical to wcsncmp(3), but the
    return value is different.

  RETURN VALUE

    wcsxfrm(3) returns the length of the transformed wide-character string.

  SEE ALSO

    memcmp(3)

    wcscasecmp(3)

    wcscmp(3)

    wcscoll(3)

  USAGE NOTES

    The wcsxfrm function is thread safe.

    The wcsxfrm function is not async-signal safe.