1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
.\" -*- nroff -*-
.\" (c) 1993 por Thomas Koenig (ig25@rz.uni-karlsruhe.de)
.\"
.\" Permisso dada para fazer e distribuir cpias verbatim deste
.\" manual, fornecida a nota de copyright, e esta nota de permisso
.\" estando preservada em todas as cpias.
.\"
.\" Permisso dada para cpia e distribuio de verses modificadas
.\" deste manual sob as condies de cpia verbatim, desde que todo o
.\" trabalho derivado resultante seja distribudo sob os termos de uma
.\" nota de permisso idntica a esta.
.\"
.\" Como o kernel e as bibliotecas do Linux esto mudando constantemente,
.\" esta pgina de manual pode estar incorreta ou desatualizada. O(s)
.\" autor(es) no assumem responsabilidade por erros, omisses ou danos
.\" resultantes do uso da informao contida aqui. O(s) autor(es) pode(m)
.\" no ter tomado o mesmo nvel de cuidado na produo deste manual,
.\" que licenciado livre de custos, do que poderiam no caso de um trabalho
.\" profissional.
.\"
.\" Verses formatadas ou processadas deste manual, se desacompanhada da
.\" fonte, deve reconhecer o copyright e os autores do trabalho.
.\"
.\" Modificado em Sab Jul 24 17:28:34 1993 por Rik Faith (faith@cs.unc.edu)
.\" Modificado em Dom Jun 01 17:16:34 1997 por Jochen Hein (jochen.hein@delphi.central.de)
.TH LOCALE 7 "24/04/1993" "Linux" "Manual do Programador Linux"
.SH NOME
locale \- Descrio de suporte multi-linguagem
.SH SINOPSE
.nf
.B #include <locale.h>
.fi
.SH DESCRIO
Um locale um conjunto de regras de linguagem e cultura. Elas cobrem aspectos
tais como linguagem para mensagens, conjuntos diferentes de caracteres,
convenes lexicogrficas, etc. Um programa precisa ser capaz de determinar
seu locale e atuar de acordo, para ser portvel para diferentes culturas.
.PP
O cabealho
.B <locale.h>
declara tipos de dados, funes e macros que so teis nesta
tarefa.
.PP
As funes que ele declara so
.B setlocale()
para configurar o locale corrente, e
.B localeconv()
para adquirir informao sobre formatao de nmeros.
.PP
H categorias diferentes para informao de local que um programa
possa precisar; elas so declaradas como macros. Usando-as como o primeiro
argumento para a funo
.B setlocale()
, possvel configurar um dos locales desejados:
.TP
.B LC_COLLATE
Isto usado para mudar o comportamento das funes
.B strcoll()
e
.BR strxfrm() ,
que so usadas para comparar strings no alfabeto local. Por exemplo,
o 's' afiado da lngua alem colocado na lista como "ss".
.TP
.B LC_CTYPE
Isto muda o comportamento da manipulao de caracteres e das funces de
classificao, tais como
.B isupper()
e
.BR toupper() ,
e as funes de caracter multi\-byte, tais como
.B mblen()
ou
.BR wctomb() .
.TP
.B LC_MONETARY
muda a informao retornada por
.B localeconv()
, que descreve a maneira como os nmeros geralmente impressos, com detalhes
tais como ponto versus vrgula para separao de decimais. Esta informao
usada internamente pela funo
.BR strfmon() .
.TP
.B LC_MESSAGES
muda as mensagens de linguagem que so exibidas, e a aparncia de uma
resposta afirmativa ou negativa. A biblioteca GNU C contm a funo
.B rpmatch()
para facilitar o uso dessa informao.
.TP
.B LC_NUMERIC
muda a informao usada pela famlia de funes
.B printf()
e
.B scanf()
, quando elas so avisadas para usar as
configuraes de locale. Esta informao tambm pode ser lida com a funo
.B localeconv()
.
.TP
.B LC_TIME
muda o comportamento da funo
.B strftime()
para exibir a hora corrente em um formato localmente aceitvel; por exemplo,
a maioria da Europa usa o relgio de 24 horas, em vez do relgio de 12 horas
como nos EUA.
.TP
.B LC_ALL
Tudo o que est acima.
.PP
Se o segundo argumento de
.B setlocale()
uma string vazia,
.BR """""" ,
para o locale padro, ele determinado atravs dos seguintes passos:
.IP 1.
Se h uma varivel de ambiente
.BR LC_ALL
no-nula, o valor de
.B LC_ALL
usado.
.IP 2.
Se existe uma varivel de ambiente com o mesmo nome que uma das categorias
acima, e ela no nula, seu valor usado para aquela categoria.
.IP 3.
Se h uma varivel de ambiente
.BR LANG
no-nula, o valor de
.B LANG
usado.
.PP
Valores relativos a formatao numrica local se faz disponvel em uma estrutura
.B struct lconv
retornada pela funo
.B localeconv(),
que tem a seguinte declarao:
.nf
struct lconv
{
/* Informao numrica (no-monetria) */
char *decimal_point; /* caractere de separao de decimais */
char *thousands_sep; /* separador de milhar */
/* Cada elemento um nmero de dgitos em cada grupo;
elementos com ndices maiores esto esquerda.
Um elemento com valor CHAR_MAX significa que mais nenhum agrupamento est feito.
Um elemento com valor 0 significa que o elemento anterior usado para
todos os grupos esquerda */
char *grouping;
/* Informao monetria */
/* Os primeiros trs caracteres so o smbolo monetrio do ISO 4217.
O quarto caractere o separador. O quinto '\0'. */
char *int_curr_symbol;
char *currency_symbol; /* Smbolo monetrio local. */
char *mon_decimal_point; /* Caractere de separao decimal. */
char *mon_thousands_sep; /* Separador de milhar. */
char *mon_grouping; /* Elemento de agrupamento (acima). */
char *positive_sign; /* Sinal para valores positivos. */
char *negative_sign; /* Sinal para valores negativos. */
char int_frac_digits; /* Dgitos fracionrios internacionais. */
char frac_digits; /* Dgitos fracionrios locais. */
/* 1 se currency_symbol precede um valor positivo, 0 se sucede. */
char p_cs_precedes;
/* 1 se um espao separa currency_symbol de um valor positivo. */
char p_sep_by_space;
/* 1 se currency_symbol precede um valor negativo, 0 se sucede. */
char n_cs_precedes;
/* 1 se um espao separa currency_symbol de um valor negativo. */
char n_sep_by_space;
/* Posies dos sinais positivo e negativo:
0 Parnteses rodeiam o valor e o currency_symbol.
1 A string de sinal precede o valor e o currency_symbol.
2 A string de sinal suceede o valor e o currency_symbol.
3 A string de sinal precede imediatamente o currency_symbol.
4 A string de sinal sucede imediatamente o currency_symbol. */
char p_sign_posn;
char n_sign_posn;
};
.fi
.SH "CONFORME"
POSIX.1
.SH "VEJA TAMBM"
.BR setlocale (3),
.BR localeconv (3),
.BR locale (1),
.BR localedef (1),
.BR rpmatch (3),
.BR strfmon (3),
.BR strcoll (3),
.BR strxfrm (3),
.BR strftime (3)
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWRubens de Jesus Nogueira <darkseid99@usa.net> (traduo)\fR
\&\fR\&\f(CWAndr L. Fassone Canova <lonelywolf@blv.com.br> (reviso)\fR
|
