close
Espacios de nombres
Variantes

    setlocale

    De cppreference.com
    < c | locale
     
    C
     
    Soporte de localización
     
    <tbody> </tbody>
    Definido en el archivo de encabezado <locale.h>
    char* setlocale( int category, const char* locale);

    La función setlocale} instala la localización del sistema especificada o su parte como la nueva localización C. Las modificaciones permanecen en efecto e influyen en la ejecución de todas las funciones de la biblioteca C sensible a la localización hasta la siguiente llamada a setlocale. Si locale es un puntero nulo, setlocale consulta la localización C actual sin modificarla.

    Parametros

    category - es el identificador de categoría de la localización, una de las macros LC_xxx. Puede ser nulo.
    locale - identificador de locale específico del sistema. Puede ser "" para la ubicación preferida por el usuario o "C" para la ubicación mínima

    Valor de retorno

    Puntero a una cadena limitada con terminación nula que identifica la localización de C después de aplicar los cambios, si los hubiera, o un puntero nulo en caso de fallo.

    Una copia de la cadena devuelta junto con la categoría utilizada en esta llamada a setlocale puede utilizarse más adelante en el programa para restaurar la localización al estado original al final de esta llamada.

    Observaciones

    Durante el arranque del programa, el equivalente de setlocale(LC_ALL, "C"); se ejecuta antes de que se ejecute cualquier código de usuario.

    Aunque el tipo de retorno es char*, modificar los caracteres apuntados es un comportamiento indefinido.

    Dado que setlocale modifica el estado global que afecta a la ejecución de funciones dependientes de la localización, es un comportamiento no definido llamarlo desde un hilo, mientras que otro hilo está ejecutando cualquiera de las siguientes funciones: fprintf, isprint, iswdigit, localeconv, tolower, fscanf, ispunct, iswgraph, mblen, toupper, isalnum, isspace, iswlower, mbstowcs, towlower, isalpha, isupper, iswprint, mbtowc, towupper, isblank, iswalnum, iswpunct, setlocale, wcscoll, iscntrl, iswalpha, iswspace, strcoll, wcstod, isdigit, iswblank, iswupper, strerror, wcstombs, isgraph, iswcntrl, iswxdigit, strtod, wcsxfrm, islower, iswctype, isxdigit.

    POSIX también define una localización llamada "POSIX", que es siempre accesible y es exactamente equivalente a la localización mínima "C" por defecto.

    POSIX también especifica que el puntero devuelto, no sólo el contenido de la cadena apuntada, puede ser invalidado por llamadas posteriores a setlocale.

    Ejemplo

    Ejecuta este código
    #include <stdio.h>
#include <locale.h>
#include <time.h>
#include <wchar.h>
 
int main(void)
{
    // the C locale will be UTF-8 enabled English;
    // decimal dot will be German
    // date and time formatting will be Japanese
    setlocale(LC_ALL, "en_US.UTF-8");
    setlocale(LC_NUMERIC, "de_DE.utf8");
    setlocale(LC_TIME, "ja_JP.utf8");
 
    wchar_t str[100];
    time_t t = time(NULL);
    wcsftime(str, 100, L"%A %c", localtime(&t));
    wprintf(L"Numero: %.2f\nFecha: %Ls\n", 3.14, str);
}

    Posible salida: 

    Numero: 3,14
Fecha: 月曜日 2017年09月25日 13時00分15秒

    Referencias

    • Standard C11 (ISO/IEC 9899:2011):
    • 7.11.1.1 The setlocale function (p: 224-225)
    • Standard C99 (ISO/IEC 9899:1999):
    • 7.11.1.1 The setlocale function (p: 205-206)
    • Standard C89/C90 (ISO/IEC 9899:1990):
    • 4.4.1.1 The setlocale function

    Véase también

    		 categorías de locale para setlocale
    (constante de macro) [editar]
    Documentación de C++ para setlocale