toupper(3) Library Functions Manual toupper(3) NOM toupper, tolower, toupper_l, tolower_l - Convertir en majuscules ou minuscules BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include 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 fonctionnalites pour la glibc (consulter 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 equivalent en majuscule, si une representation en majuscule existe dans les parametres regionaux actuels. Sinon, elle renvoie c. La fonction toupper_l realise la meme operation, mais utilise les parametres regionaux references par l'identifiant de parametres regionaux locale. Si c est une lettre majuscule, tolower() renvoie son equivalent en minuscule, si une representation en minuscule existe dans les parametres regionaux actuels. Sinon, elle renvoie c. La fonction tolower_l realise la meme operation, mais utilise les parametres regionaux references par l'identifiant de parametres regionaux locale. Si c n'est ni un caractere non signe (unsigned char), ni EOF, le comportement de ces fonctions est imprevisible. Le comportement de toupper_l() et tolower_l() est non defini si locale est l'objet de parametres regionaux LC_GLOBAL_LOCALE (consultez duplocale(3)) ou n'est pas un identifiant d'objet de parametres regionaux valable. VALEUR RENVOYEE La valeur renvoyee est celle de la lettre convertie, ou bien c si la conversion n'est pas possible. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +---------------------------------+--------------------------+---------+ |Interface | Attribut | Valeur | +---------------------------------+--------------------------+---------+ |toupper(), tolower(), | Securite des threads | MT-Safe | |toupper_l(), tolower_l() | | | +---------------------------------+--------------------------+---------+ STANDARDS toupper() tolower() C11, POSIX.1-2008. toupper_l() tolower_l() POSIX.1-2008. HISTORIQUE toupper() tolower() C89, 4.3BSD, POSIX.1-2001. toupper_l() tolower_l() POSIX.1-2008. NOTES Les standards requierent que l'argument c de ces fonctions soit EOF ou une valeur representable par un unsigned char. Si l'argument c est de type char, il doit faire l'objet d'une conversion forcee en unsigned char comme montre dans l'exemple suivant : char c; ... res = toupper((unsigned char) c); Cela est necessaire car char pourrait etre equivalent a signed char. Dans ce cas, un octet dont le premier bit serait utilise aurait une extension de signe lors d'une conversion en int, resultant en une valeur en dehors de l'intervalle des unsigned char. La definition de << majuscule >> et << minuscule >> depend des parametres regionaux. Par exemple, les parametres regionaux par defaut << C >> n'ont pas d'information sur les accents, donc aucune conversion n'est effectuee. Dans certaines langues, des lettres minuscules n'ont pas d'equivalent majuscule, comme par exemple le caractere allemand ss. VOIR AUSSI isalpha(3), newlocale(3), setlocale(3), towlower(3), towupper(3), uselocale(3), locale(7) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Jean-Pierre Giraud Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 toupper(3)