Función de la biblioteca C -uselocale()
Biblioteca estándar de C - <locale.h>
Descripción
uselocale()Es una función de la biblioteca estándar de C que se utiliza para establecer u obtener el objeto de localización actual de un subproceso. Esta función permite que el programa utilice diferentes configuraciones regionales en diferentes subprocesos, lo que admite la localización en entornos multiproceso.
Declaración
La siguiente es la declaración de la función uselocale():
#include <locale.h> locale_t uselocale(locale_t newloc);
Parámetros
newloc: el que se va a establecer como objeto de localización del subproceso actuallocale_tobjeto.- Si es
LC_GLOBAL_LOCALE, se utiliza la configuración regional global. - Si es
NULL, no se modifica el objeto de localización actual, solo se devuelve el objeto de localización actual. - Otros objetos de localización válidos
locale_tserán establecidos como el objeto de localización del subproceso actual.
- Si es
Valor de retorno
- En caso de éxito, devuelve el anterior
locale_tobjeto (el objeto de localización del subproceso actual). - En caso de error, devuelve
LC_GLOBAL_LOCALEy establece el código de error apropiado.
Ejemplo
El siguiente ejemplo demuestra cómo usar freelocale() para liberar el objeto de localización creado con newlocale():
Ejemplo
#include <locale.h>
#include <xlocale.h> // Necesario al usar extensiones GNU
int main() {
// Crear un nuevo objeto de localización usando la configuración regional "en_US.UTF-8"
locale_t newloc = newlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0);
if (newloc == (locale_t)0) {
perror("newlocale");
return 1;
}
// Obtener e imprimir la información de localización actual
struct lconv *lc = localeconv();
printf("Default locale decimal point: %s\n", lc->decimal_point);
printf("Default locale thousands separator: %s\n", lc->thousands_sep);
// Establecer el objeto de localización del subproceso actual como el nuevo objeto de localización
locale_t oldloc = uselocale(newloc);
// Obtener e imprimir la nueva información de localización
lc = localeconv();
printf("New locale decimal point: %s\n", lc->decimal_point);
printf("New locale thousands separator: %s\n", lc->thousands_sep);
// Restaurar el objeto de localización anterior
uselocale(oldloc);
// Obtener e imprimir la información de localización restaurada
lc = localeconv();
printf("Restored locale decimal point: %s\n", lc->decimal_point);
printf("Restored locale thousands separator: %s\n", lc->thousands_sep);
// Liberar el nuevo objeto de localización
freelocale(newloc);
return 0;
}
Compilemos y ejecutemos el programa anterior, esto producirá el siguiente resultado:
Default locale decimal point: . Default locale thousands separator: New locale decimal point: . New locale thousands separator: , Restored locale decimal point: . Restored locale thousands separator:
Análisis del código
-
Crear un nuevo objeto de localización:
- Usando
newlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0)se crea un nuevo objeto de localización, estableciendo la configuración regional en "en_US.UTF-8".
- Usando
-
Imprimir la información de localización predeterminada:
- Usando
localeconv()se obtiene e imprime la información de localización predeterminada actual, como el carácter del punto decimal y el separador de miles.
- Usando
-
Establecer el objeto de localización del subproceso:
- Usando
uselocale(newloc)se establece el objeto de localización del subproceso actual como el nuevo objeto de localización creado, y se guarda el objeto de localización anterior.
- Usando
-
Imprimir la nueva información de localización:
- Usando
localeconv()se obtiene e imprime la nueva información de localización, verificando si el cambio fue exitoso.
- Usando
-
Restaurar el objeto de localización anterior:
- Usando
uselocale(oldloc)se restaura el objeto de localización anterior.
- Usando
-
Liberar el objeto de localización:
- Usando
freelocale(newloc)se libera el nuevo objeto de localización creado, evitando fugas de memoria.
- Usando
Notas
uselocale()La función es parte del estándar POSIX.1-2008; asegúrese de que su plataforma admita esta función.- El uso en un entorno multiproceso
uselocale()puede establecer un objeto de localización independiente para cada subproceso, pero se debe prestar atención a la consistencia de datos entre subprocesos y a las condiciones de carrera. - Usando
freelocale()se liberan los objetos de localización que ya no sean necesarios, evitando fugas de memoria.
Resumen
uselocale()La función permite establecer y obtener el objeto de localización del subproceso actual, logrando así soporte de localización en entornos multiproceso. Mediante el uso combinado denewlocale()、uselocale()yfreelocale()funciones, los programadores pueden gestionar y cambiar de manera flexible la configuración de localización del programa, proporcionando soporte de configuración regional independiente para diferentes subprocesos.