TOUPPER(3)

NOM
toupper, tolower, toupper_l, tolower_l - Convertir en majuscules ou minuscules

SYNOPSIS
#include <ctype.h>

int toupper(int c);
int tolower(int c);
int toupper_l(int c, locale_t locale);
int tolower_l(int c, locale_t locale);

Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

toupper_l(), tolower_l() :
    Depuis la glibc 2.10 :
        _XOPEN_SOURCE >= 700
    Avant la glibc 2.10 :
        _GNU_SOURCE

DESCRIPTION
Ces fonctions convertissent les lettres minuscules en majuscules, et vice versa. Si c est une lettre minuscule, toupper() renvoie son équivalent en majuscule, si une représentation en majuscule existe dans les paramètres régionaux actuels. Sinon, elle renvoie c. La fonction toupper_l réalise la même opération, mais utilise les paramètres régionaux référencés par l’identifiant de paramètres régionaux locale. Si c est une lettre majuscule, tolower() renvoie son équivalent en minuscule, si une représentation en minuscule existe dans les paramètres régionaux actuels. Sinon, elle renvoie c. La fonction tolower_l réalise la même opération, mais utilise les paramètres régionaux référencés par l’identifiant de paramètres régionaux locale.

Si c n'est ni un caractère non signé (unsigned char), ni EOF, le comportement de ces fonctions est imprévisible. Le comportement de toupper_l() et tolower_l() est non défini si locale est l’objet de paramètres régionaux LC_GLOBAL_LOCALE (consultez duplocale(3)) ou n’est pas un identifiant d’objet de paramètres régionaux valable.

VALEUR RENVOYÉE
La valeur renvoyée est celle de la lettre convertie, ou bien c si la conversion n'est pas possible.

ATTRIBUTS

  Multithreading (voir pthreads(7))
Les fonctions toupper() et tolower() sont sûres dans un contexte multithread avec exceptions. Elles peuvent être utilisées de manière sûre tant que setlocale(3) n'est pas appelée pour modifier la locale pendant leur exécution.

CONFORMITÉ
toupper(), tolower() : C89, C99, 4.3BSD, POSIX.1-2001, POSIX.1-2008. toupper_l(), tolower_l() : POSIX.1-2008.

NOTES
La définition de « majuscule » et « minuscule » dépend des paramètres régionaux. Par exemple, les paramètres régionaux par défaut « C » n’ont pas d’information sur les accents, donc aucune conversion n’est effectuée.

Dans certaines langues, des lettres minuscules n'ont pas d'équivalent majuscule, comme par exemple le caractère allemand ß.

VOIR AUSSI
isalpha(3), newlocale(3), setlocale(3), uselocale(3), towlower(3), towupper(3), locale(7)

COLOPHON
Cette page fait partie de la publication 3.70 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».