NOMBRE

       toupper, tolower, toupper_l, tolower_l - convert uppercase or lowercase

SINOPSIS

       #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);

   Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

       toupper_l(), tolower_l():
           Desde glibc 2.10:
                  _XOPEN_SOURCE >= 700
           Antes de glibc 2.10:
                  _GNU_SOURCE

DESCRIPCIÓN

       These functions convert lowercase letters to uppercase, and vice versa.

       If  c  is a lowercase letter, toupper()  returns its uppercase equivalent, if an uppercase representation
       exists in the current locale.  Otherwise, it returns c.  The  toupper_l()   function  performs  the  same
       task, but uses the locale referred to by the locale handle locale.

       If  c  is an uppercase letter, tolower()  returns its lowercase equivalent, if a lowercase representation
       exists in the current locale.  Otherwise, it returns c.  The  tolower_l()   function  performs  the  same
       task, but uses the locale referred to by the locale handle locale.

       If c is neither an unsigned char value nor EOF, the behavior of these functions is undefined.

       The  behavior  of  toupper_l()   and  tolower_l()   is  undefined  if locale is the special locale object
       LC_GLOBAL_LOCALE (see duplocale(3))  or is not a valid locale object handle.

VALOR DEVUELTO

       El valor devuelto es la letra "convertida", o c si no se pudo realizar la conversión.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
       ┌──────────────────────────┬────────────────────┬───────────────────┐
       │ Interfaz                 │ Atributo           │ Valor             │
       ├──────────────────────────┼────────────────────┼───────────────────┤
       │ toupper(), tolower(),    │ Seguridad del hilo │ Multi-hilo seguro │
       │ toupper_l(), tolower_l() │                    │                   │
       └──────────────────────────┴────────────────────┴───────────────────┘

CONFORME A

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

       toupper_l(), tolower_l(): POSIX.1-2008.

NOTAS

       The standards require that the argument c  for  these  functions  is  either  EOF  or  a  value  that  is
       representable  in the type unsigned char.  If the argument c is of type char, it must be cast to unsigned
       char, as in the following example:

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

       This is necessary because char may be the equivalent signed char, in which case a byte where the top  bit
       is  set  would  be  sign  extended  when converting to int, yielding a value that is outside the range of
       unsigned char.

       Hay que tener en cuenta que los detalles de qué es mayúscula o minúscula dependen de  cada  lengua.   Por
       ejemplo,  en  la  localización  "C"  por  omisión no existe la letra "umlaut", por lo que no se le aplica
       conversión.

       En algunas localizaciones no inglesas existen letras minúsculas que no tienen  su  correspondiente  letra
       mayúscula; por ejemplo la s aguda alemana.

VÉASE TAMBIÉN

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

COLOFÓN

       Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del
       proyecto,   información   sobre   cómo   informar   errores  y  la  última  versión  de  esta  página  en
       https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

       La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars <mpi79470@alu.um.es>

       Esta traducción es documentación libre;  lea  la  GNU General Public License Version 3  o  posterior  con
       respecto a las condiciones de copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción  de esta página del manual, envíe un correo electrónico a
       debian-l10n-spanish@lists.debian.org.

GNU                                            15 Septiembre 2017                                     TOUPPER(3)