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 ß.

COLOPHON

Cette page fait partie de la publication 3.65 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 à <[email protected]> ou par un rapport de bogue sur le paquet manpages-fr.

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