LOCALE(7)

JMÉNO
locale - Popis vícejazykové podpory

POUŽITÍ
#include <locale.h>

POPIS
Locale je množina jazykových a kulturních pravidel pro popis takových aspektu jako jsou jazyk pro zprávy, různé znakové sady, abecední řazení atd. Každý program musí mít možnost zjistit jeho locale a chovat se podle jím daných pravidel.

Hlavičkový soubor <locale.h> deklaruje datové typy, funkce a makra, která tuto přenositelnost usnadňuje.

Deklarované funkce: setlocale(3) pro nastavení aktuálního lacale a localeconv(3) pro zjištění informací o formátování čísel.

Různé kategorie pro lokální informace jsou definovány jako makra. Jestliže se použijí jako první argument pro funkci setlocale(3) je možno nastavit jednu z požadovaných kategorií:

LC_COLLATE
    Mění chování funkcí strcoll(3) a strxfrm(3), které se používají na porovnání řetězců v lokální abecedě, Například, ostré německé s se třídí jako "ss".

LC_CTYPE
    Mění chování klasifikačních funkcí a maker jako isupper(3) a toupper(3), a funkcí pro vícebytové znaky jako je mblen(3) nebo wctomb(3).

LC_MONETARY
    Mění návratovou hodnotu funkce localeconv(3), která popisuje způsob jak jsou tištěna čísla, včetně detailů o desetinné tečce či čárce. Interně je tato informace použita ve funkci strfmon(3).

LC_MESSAGES
    mění jazyk zpráv a určuje jak vypadá pozitivní a negativní odpověď v daném jazyce. GNU C-lib obsahuje pro tento účel funkce gettext(3), ngettext(3), and rpmatch(3). Funkce z GNU gettext se rovněž řídí proměnnou prostředí LANGUAGE (která obsahuje dvojtečkou oddělovaný seznam locales), je-li tato nastavena na platné locale jiné než "C".

LC_NUMERIC
    Mění chování funkcí printf(3) a scanf(3) kdykoli mají použít nastavení locale. Tuto informaci lze také číst pomocí funkce localeconv(3).

LC_TIME
    mění chování funkcí strftime(3), která zobrazuje současný čas podle lokálních pravidel; například v Evropě se běžně používá 24 hodinový den, zatímco v USA 12 hodinový.

LC_ALL
    Nastavuje vše.

Jestliže je druhý argument pro setlocale(3) prázdný řetězec, "", hledá se základní locale takto:

1.  Jestliže je nastavena proměnná prostředí LC_ALL, použije se LC_ALL .

2.  Jestliže existuje proměnná prostředí, která se jmenuje stejně jako některá z kategorií, použije se tato.

3.  Jestliže je nastavena proměnná prostředí LANG, použije se hodnota LANG .

Hodnoty pro číselnou konverzi jsou nastaveny ve struct lconv , kterou vrací funkce localeconv(3), má následující deklaraci:
struct lconv {
      /* Číselná (nikoli peněžní) informace */
      char *decimal_point;		/* Znak pro desetinnou čárku  */
  char *thousands_sep;		/* Oddělovač tisíců  */
  char *grouping; /* Každý prvek označuje počet číslic ve skupině;
                     významnější hodnoty se zobrazují více vlevo.
                     Pozice CHAR_MAX určuje odkud se již žádné
                     oddělování nečiní. Prvek s hodnotou 0 označuje,
                     že předchozí prvek se použije odtud doleva. */
      /* Peněžní informace.  */
      char *int_curr_symbol; /* První tři znaky jsou symbolem měny podle
                            ISO 4217. Čtvrtý znak je oddělovač, pátý
                            je '\0'. */
  char *currency_symbol;	/* Lokální symbol pro měnu  */
  char *mon_decimal_point;	/* desetinná čárka  */
  char *mon_thousands_sep;	/* Viz thousands_sep nahoře  */
  char *mon_grouping;		/* Viz grouping nahoře  */
  char *positive_sign;		/* Kladné znaménko  */
  char *negative_sign;		/* Záporné znaménko */
  char int_frac_digits;		/* Mezinárodní počet des. míst  */
  char frac_digits;		/* Lokální počet des. míst */
  char p_cs_precedes;           /* 1 když znak měny předchází číslo,
                                   0 když jej následuje */
  char p_sep_by_space;          /* 1 když mezera odděluje
                                   currency_symbol od desetinné čárky */
  char n_cs_precedes;           /* 1 když currency_symbol předchází
                                   záporné hodnoty, 0 když následuje */
  char n_sep_by_space;          /* 1 když mezera odděluje
                                   currency_symbol od záporné hodnoty */
  /* Kladné a záporné znaménko:
     0 Závorky kolem hodnoty a symbolu měny.
     1 Znaménko před hodnotou i symbolem měny.
     2 Znaménko následuje za hodnotou i symbolem měny.
     3 Znaménko bezprostředně před symbolem měny.
     4 Znaménko bezprostředně následuje symbolem měny. */
  char p_sign_posn;
  char n_sign_posn;
};

SPLŇUJE STANDARDY
POSIX.1-2001. Funkce GNU gettext jsou specifikovány v LI18NUX2000.

DALŠÍ INFORMACE
locale(1), localedef(1), gettext(3), localeconv(3), ngettext(3), nl_langinfo(3), rpmatch(3), setlocale(3), strcoll(3), strfmon(3), strftime(3), strxfrm(3)

TIRÁŽ
Tato stránka je součástí projektu Linux man-pages. Popis projektu a informace o hlášení chyb najdete na http://www.kernel.org/doc/man-pages/.