locale

Autres langues

Langue: it

Autres versions - même langue

Version: 24 aprile 1993 (openSuse - 09/10/07)

Autres sections - même nom

Section: 7 (Divers)

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)