strxfrm − Transformations 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ée 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 l’octet nul « \0 » final. Si la valeur renvoyée est supérieure ou égale à n, le contenu de dest est indéfini.

SVr4, BSD 4.3, C99.

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

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

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 10 novembre 1996 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 strxfrm ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.