LOCALE(7)

NAZWA
locale - opis obsługi wielu języków

STRESZCZENIE
#include <locale.h>

OPIS
Locale to zestaw reguł językowych i kulturalnych. Pokrywają one aspekty takie jak język komunikatów, różne zestawy znaków, konwencje leksykograficzne itd. Program musi umieć określić swoje locale i zachowywać się odpowiednio, aby można go było przenieść do innych kultur.

Nagłówek <locale.h> deklaruje typy danych, funkcje i makra przydatne w tym przedsięwzięciu.

Funkcje deklarowane to setlocale() ustawiająca bieżące locale i localeconv() pobierająca informacje o formatowaniu liczb.

Istnieją różne kategorie lokalnej informacji której potrzebować może program; zadeklarowane są one jako makra. Używając ich jako pierwszy argument funkcji setlocale() możliwe jest ustawienie jednego z poniższych na żądane locale:

LC_COLLATE
    Używane do zmiany zachowania funkcji strcoll() i strxfrm(), które używane są do porównywania łańcuchów w alfabecie lokalnym. Na przykład niemieckie scharfes s sortowane jest jako "ss".

LC_CTYPE
    Zmienia zachowanie operacji na znakach i funkcji klasyfikacyjnych, takich jak isupper() i toupper(), oraz znakowych funkcji wielobajtowych takich jak mblen() i wctomb()

LC_MONETARY
    Zmienia informację zwracaną przez localeconv() która opisuje sposób w jaki zwykle drukowane są liczby, ze szczegółami takimi jak kropka dziesiętna vs. przecinek dziesiętny. Informacja ta jest używana wewnętrznie przez funkcję strfmon()

LC_MESSAGES
    Zmienia język w którym wyświetlane są komunikaty oraz to jak wygląda odpowiedź twierdząca i przecząca. Biblioteka GNU C zawiera funkcje gettext(), ngettext() oraz rpmatch() ułatwiające użycie tych informacji. Funkcje GNU z rodziny gettext słuchają również zmiennej LANGUAGE.

LC_NUMERIC
    Zmienia informacje używane przez rodzinę funkcji printf() i scanf() , kiedy radzi im się żeby używały ustawień locale. Informacja ta może być także odczytana funkcją localeconv() .

LC_TIME
    Zmienia zachowanie funkcji strftime() , wyświetlającej bieżący czas w formie lokalnie akceptowalnej; na przykład, większość Europy używa zegara 24-godzinnego, vs. 12-godzinnego w USA.

LC_ALL
    Wszystko powyżej.

Jeśli drugim argumentem setlocale() jest łańcuch pusty "" oznaczający locale domyślne, ustala się je wedle poniższych kroków:

1.  Jeśli istnieje niepusta zmienna środowiskowa LC_ALL, używana jest wartość LC_ALL

2.  Jeśli istnieje i jest niepusta zmienna środowiskowa o tej samej nazwie co jedna z kategorii powyżej, dla tej kategorii używana jest jej wartość.

3.  Jeśli istnieje niepusta zmienna środowiskowa LANG, używana jest wartość LANG

Wartości dotyczące lokalnego formatowania dostępne są w strukturze lconv zwracanej przez funkcję localeconv() . lconv ma następującą deklarację:
struct lconv
{
  /* Informacja numeryczna (nie-monetarna)  */
  char *decimal_point;		/* Znak dziesiętny  */
  char *thousands_sep;		/* Separator tysięcy  */
  /* Każdy element to ilość cyfr w danej grupie, elementy z większymi
     indeksami są bardziej na lewo.  Element o wartości CHAR_MAX
     oznacza że nie następuje dalsze grupowanie.  Element o wartości
     0 oznacza że dla wszystkich grup bardziej na lewo używany jest
     element poprzedni. */
  char *grouping;
  /* Informacja monetarna  */
  /* Pierwsze trzy znaki to symbol waluty z ISO 4217. Czwarty znak to
     separator.  Piąty to ' '.  */
  char *int_curr_symbol;
  char *currency_symbol;	/* Symbol lokalnej waluty  */
  char *mon_decimal_point;	/* Znak dziesiętny  */
  char *mon_thousands_sep;	/* Separator tysięcy  */
  char *mon_grouping;		/* Jak element 'grupujący' (wyżej)  */
  char *positive_sign;		/* Znak dla wartości dodatnich  */
  char *negative_sign;		/* Znak dla wartości ujemnych  */
  char int_frac_digits;		/* Międzynar. cyfry dziesiętne  */
  char frac_digits;		/* Lokalne cyfry dziesiętne  */
  /* 1 jeśli symbol waluty poprzedza wartość dodatnią, 0 jeśli następuje */
  char p_cs_precedes;
  /* 1 jeśli symbol waluty oddziela od wartości dodatniej spacja */
  char p_sep_by_space;
  /* 1 jeśli symbol waluty poprzedza wartość ujemną, 0 jeśli następuje */
  char n_cs_precedes;
  /* 1 jeśli symbol waluty oddziela od wartości ujemnej spacja */
  char n_sep_by_space;
  /* Dodatnie i ujemne pozycje znaku:
     0 Wartość i symbol waluty w nawiasach
     1 Znak poprzedza wartość i symbol waluty
     2 Znak następuje po wartości i symbolu waluty
     3 Znak następuje tuż przez symbolem waluty
     4 Znak następuje tuż po symbolu waluty */
  char p_sign_posn;
  char n_sign_posn;
};

ZGODNE Z
POSIX.1
Funkcje GNU gettext są zdefiniowane w LI18NUX2000.

ZOBACZ TAKŻE
setlocale(3), localeconv(3), locale(1), localedef(1), nl_langinfo(3), gettext(3), ngettext(3), rpmatch(3), strfmon(3), strcoll(3), strxfrm(3), strftime(3)