NOM

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

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

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 (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 é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

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ toupper(), tolower(), toupper_l(), tolower_l()                       │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

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 requièrent que l'argument c de ces fonctions soit EOF ou une valeur  représentable  par  un
       unsigned  char.  Si  l'argument  c  est  de  type  char, il doit faire l'objet d'une conversion forcée en
       unsigned char comme montré dans l'exemple suivant :

           char c;
           ...
           res = toupper((unsigned char) c);

       Cela est nécessaire car char pourrait être équivalent à signed char.  Dans  ce  cas,  un  octet  dont  le
       premier  bit  serait utilisé aurait une extension de signe lors d'une conversion en int, résultant en une
       valeur en dehors de l'intervalle des unsigned char.

       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), towlower(3), towupper(3), uselocale(3), locale(7)

TRADUCTION

       La   traduction   française   de   cette   page   de   manuel   a   été   créée   par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>,  François  Micaux,  Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,      Thomas      Huriaux      <thomas.huriaux@gmail.com>,     Nicolas     François
       <nicolas.francois@centraliens.net>,    Florentin    Duneau    <fduneau@gmail.com>,     Simon     Paillard
       <simon.paillard@resel.enst-bretagne.fr>,     Denis    Barbier    <barbier@debian.org>,    David    Prévot
       <david@tilapin.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous  reporter  à  la  GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si  vous  découvrez  un  bogue  dans la traduction de cette page de manuel, veuillez envoyer un message à
       debian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.9.1                     2 mai 2024                                         toupper(3)