strxfrm − Transformation de chaînes.

#include <string.h>

size_t strxfrm (char *dest, const char *src, size_t n);

La fonction strxfrm() transforme la chaîne src de telle manière que le résultat de strcmp() sur deux chaînes ayant été modifiées par strxfrm() soit le même que le résultat de strcoll() sur les deux chaînes avant leur transformation. Les n premiers caractères de la chaîne transformée sont placés dans dest. La transformation est effectué en considérant la catégorie LC_COLLATE de la localisation en cours. (voir setlocale(3)).

La fonction strxfrm() renvoie le nombre d’octets nécessaires pour stocker la chaîne transformée dest sans compter le caractère nul ‘\0’ final. Si la valeur renvoyée est supérieure ou égale à n, le contenu de dest est indéfini.

SVID 3, BSD 4.3, ISO 9899

Dans les localisations "POSIX" ou "C", strxfrm() est équivalent à une copie avec strncpy().

bcmp(3), memcmp(3), strcasecmp(3), strcmp(3), strcoll(3), setlocale(3)

Christophe Blaess, 1997.