Espacios de nombres
Variantes
Acciones

setlocale

De cppreference.com
< c‎ | locale
Definido en la cabecera <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.

Contenido

[editar] 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

[editar] 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.

[editar] 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.

[editar] Ejemplo

#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秒

[editar] 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

[editar] Véase también

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