Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

locale

NOME

locale - Descrizione del supporto multi-linguistico

SINTASSI

 #include <locale.h>
 

DESCRIZIONE

Un locale è un insieme di regole linguistiche e culturali che coprono campi come la lingua dei messaggi, insiemi di caratteri, convenzioni lessicografiche, ecc. Un programma deve poter determinare il suo locale e agire di conseguenza per poter essere adattato a culture diverse.

L'header <locale.h> dichiara i tipi di dati, funzioni e macro utili per questo scopo.

Le funzioni che vengono dichiarate sono setlocale() per impostare il locale corrente e localeconv() per ottenere informazioni sul modo di formattare i numeri.

Le differenti categorie di informazioni locali di cui un programma potrebbe aver bisogno vengono dichiarate come macro. Usandole come primo argomento alla funzione setlocale() è possibile impostare uno dei seguenti locali

LC_COLLATE

viene usato per modificare il comportamento delle funzioni strcoll() e strxfrm(), che servono per confrontare stringhe nell'alfabeto locale. Ad esempio, la «ß» tedesca viene ordinata lessicograficamente come «ss».

LC_CTYPE

modifica il comportamento delle funzioni che maneggiano e classificano caratteri, come isupper() e toupper(), e le funzioni per caratteri a più byte come mblen() o wctomb().

LC_MONETARY

cambia l'informazione restituita da localeconv(), la quale descrive il modo in cui i numeri vengono normalmente stampati, compresi dettagli come l'uso del punto o della virgola decimale. Questa informazione è usata internamente dalla funzione strfmon() .

LC_MESSAGES

cambia il linguaggio in cui i messaggi vengono mostrati e la forma delle risposte positive o negative. La libreria C di GNU contiene la funzione rpmatch() per facilitare l'impiego di queste informazioni.

LC_NUMERIC

cambia l'informazione usata dalle famiglie di funzioni printf() e scanf(), quando viene loro richiesto di usare le impostazioni locali. Queste informazioni possono anche essere lette tramite la funzione localeconv().

LC_TIME

modifica il comportamento della funzione strftime() onde mostrare l'ora in una forma localmente accettabile; per esempio, in buona parte d'Europa si usano le 24 ore, a differenza delle 12 ore degli USA.

LC_ALL

Vale per tutte le macro precedenti.

Se il secondo argomento a setlocale() è la stringa vuota "", allora il locale di default è determinato come segue:

1.

Se è presente una variabile ambientale non nulla LC_ALL, viene usato il valore di LC_ALL.

2.

Se una variabile ambientale con lo stesso nome di una delle categorie precedenti esiste ed è non nulla, il suo valore viene usato per quella categoria.

3.

Se è presente una variabile ambientale non nulla LANG, viene usato il valore di LANG.

I valori che descrivono la formattazione locale dei numeri è dispobili in una struct lconv restituita dalla funzione localeconv(), che è così dichiarata:

 struct lconv
 {
   /* Numeric (non-monetary) information.  */
 
   char *decimal_point;          /* Decimal point character.  */
   char *thousands_sep;          /* Thousands separator.  */
   /* Each element is the number of digits in each group;
      elements with higher indices are farther left.
      An element with value CHAR_MAX means that no further grouping is done.
      An element with value 0 means that the previous element is used
      for all groups farther left.  */
   char *grouping;
 
   /* Monetary information.  */
 
   /* First three chars are a currency symbol from ISO 4217.
      Fourth char is the separator.  Fifth char is ' '.  */
   char *int_curr_symbol;
   char *currency_symbol;        /* Local currency symbol.  */
   char *mon_decimal_point;      /* Decimal point character.  */
   char *mon_thousands_sep;      /* Thousands separator.  */
   char *mon_grouping;           /* Like `grouping' element (above).  */
   char *positive_sign;          /* Sign for positive values.  */
   char *negative_sign;          /* Sign for negative values.  */
   char int_frac_digits;         /* Int'l fractional digits.  */
   char frac_digits;             /* Local fractional digits.  */
   /* 1 if currency_symbol precedes a positive value, 0 if succeeds.  */
   char p_cs_precedes;
   /* 1 if a space separates currency_symbol from a positive value.  */
   char p_sep_by_space;
   /* 1 if currency_symbol precedes a negative value, 0 if succeeds.  */
   char n_cs_precedes;
   /* 1 if a space separates currency_symbol from a negative value.  */
   char n_sep_by_space;
   /* Positive and negative sign positions:
      0 Parentheses surround the quantity and currency_symbol.
      1 The sign string precedes the quantity and currency_symbol.
      2 The sign string succeeds the quantity and currency_symbol.
      3 The sign string immediately precedes the currency_symbol.
      4 The sign string immediately succeeds the currency_symbol.  */
   char p_sign_posn;
   char n_sign_posn;
 };
 

CONFORME A

POSIX.1

VEDERE ANCHE

setlocale(3), localeconv(3), locale(1), localedef(1) , rpmatch(3), strfmon(3), strcoll(3), strxfrm(3), strftime(3)