STRXFRM

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 12 avril 1993
Index Menu principal

NOM

strxfrm - Transformations de chaînes

SYNOPSIS

#include <string.h>

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

DESCRIPTION

La fonction strxfrm() transforme la chaîne src de telle manière que le résultat de strcmp(3) sur deux chaînes ayant été modifiées par strxfrm() soit le même que le résultat de strcoll(3) 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 des paramètres régionaux en vigueur. (voir setlocale(3)).

VALEUR RENVOYÉE

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.

CONFORMITÉ

SVr4, BSD 4.3, C89, C99.

NOTES

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

VOIR AUSSI

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

TRADUCTION

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 17 juillet 2008.

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.

Dernière mise à jour : 17 juillet 2008