I have forgotten
my Password

advanced search

Valid RSS

Computing › C › String.h ›

strxfrm

Transform a string under locale
Contents
  1. Interface
  2. Description
  3. Return Values
  4. See Also
  5. Standards
  6. Page Comments

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 \c n or more, the contents of \c dst are indeterminate.

See Also

reference:strcmp, reference:strcoll

Standards

The strxfrm function conforms to ISO/IEC 9899:1990 ("ISO C90").
Last Modified: 18 Dec 11 @ 15:03     Page Rendered: 2021-12-20 21:54:24