.\" Copyright (C) 2001 Information-technology Promotion Agency (IPA)
.\" Copyright (C) 2001-2003
.\"   National Institute of Advanced Industrial Science and Technology (AIST)
.\" This file si aprt of the m17n library documentation.
.\" Permission is granted to copy, distribute and/or modify this document
.\" under the terms of the GNU Free Documentation License, Version 1.2 or
.\" any later version published by the Free Software Foundation; with no
.\" Invariant Section, Front-Cover Texts "The m17n library documentation",
.\" and no Back-Cover Texts.  A copy of the license is included in the
.\" appendix entitled "GNU Free Documentation License".
.TH "Locale" 3m17n "14 Jul 2007" "" "Version 1.4.0" "" "The m17n Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
Locale \- Locale objects and API for them.  

.PP
.SS "Typedefs"

.in +1c
.ti -1c
.RI "typedef \fBMLocale\fP \fBMLocale\fP"
.br
.RI "\fI\fCstruct\fP \fCMLocale\fP. \fP"
.in -1c
.SS "Functions"

.in +1c
.ti -1c
.RI "\fBMLocale\fP * \fBmlocale_set\fP (int category, const char *name)"
.br
.RI "\fISet the current locale. \fP"
.ti -1c
.RI "\fBMSymbol\fP \fBmlocale_get_prop\fP (\fBMLocale\fP *locale, \fBMSymbol\fP key)"
.br
.RI "\fIGet the value of a locale property. \fP"
.ti -1c
.RI "int \fBmtext_ftime\fP (\fBMText\fP *mt, const char *format, const struct tm *tm, \fBMLocale\fP *locale)"
.br
.RI "\fIFormat date and time. \fP"
.ti -1c
.RI "\fBMText\fP * \fBmtext_getenv\fP (const char *name)"
.br
.RI "\fIGet an environment variable. \fP"
.ti -1c
.RI "int \fBmtext_putenv\fP (\fBMText\fP *mt)"
.br
.RI "\fIChange or add an environment variable. \fP"
.ti -1c
.RI "int \fBmtext_coll\fP (\fBMText\fP *mt1, \fBMText\fP *mt2)"
.br
.RI "\fICompare two M-texts using the current locale. \fP"
.in -1c
.SS "Variables"

.in +1c
.ti -1c
.RI "\fBMSymbol\fP \fBMterritory\fP"
.br
.ti -1c
.RI "\fBMSymbol\fP \fBMmodifier\fP"
.br
.ti -1c
.RI "\fBMSymbol\fP \fBMcodeset\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
The m17n library represents locale related information as objects of type \fBMLocale\fP. 
.SH "Typedef Documentation"
.PP 
.SS "typedef struct \fBMLocale\fP \fBMLocale\fP"
.PP
The structure \fCMLocale\fP is used to hold information about name, language, territory, modifier, codeset, and the corresponding coding system of locales.
.PP
The contents of this structure are implementation dependent. Its internal structure is concealed from application programs.
.PP
\fBSee Also:\fP.RS 4
\fBmlocale_get_prop()\fP 
.RE
.PP

.SH "Variable Documentation"
.PP 
.SS "\fBMSymbol\fP \fBMterritory\fP"
.PP
The symbol whose name is 'territory'. 
.SS "\fBMSymbol\fP \fBMmodifier\fP"
.PP
The symbol whose name is 'modifier'. 
.SS "\fBMSymbol\fP \fBMcodeset\fP"
.PP
The symbol whose name is 'codeset'.