strxfrm

10,000+ views

GPL — licence
Edit / fork this page
Contents
  1. INTERFACE
  2. DESCRIPTION
  3. RETURN VALUES
  4. SEE ALSO
  5. STANDARDS

transform a string under locale

Computing C String.h

View versions (3)

INTERFACE

#include <string.h>
size_t strxfrm ( char * restrict dst, const char * restrict src, size_t n ) 
#include <xlocale.h>
size_t strxfrm_l ( char * restrict dst, const char * restrict src, size_t n, locale_t loc )

DESCRIPTION

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.

While the strxfrm function uses the current locale, the strxfrm_l function may be passed a locale directly. See xlocale for more information.

RETURN VALUES

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

SEE ALSO

strcmp, strcoll

STANDARDS

The strxfrm function conforms to ISO/IEC 9899:1990 ("ISO C90").