---
name: "m17nLocale"
section: "3m17n"
platform: "linux"
package: "m17n-docs"
version: "1.8.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/m17nLocale"
---

# m17nLocale(3m17n)

\- Locale objects and API for them.

## NAME

m17nLocale\_-\_Lo -  - Locale objects and API for them.

## SYNOPSIS

### Typedefs

typedef struct **MLocale** **MLocale**\
 `struct` `MLocale`.

### Functions

**MPlist** \* **mlanguage\_list** (void)\
 List 3-letter language codes.  MSymbol **mlanguage\_code** (MSymbol language, int len)\
 Get a language code.  **MPlist** \* **mlanguage\_name\_list** (MSymbol language, MSymbol target, MSymbol script, MSymbol territory)\
 Return the language names written in the specified language.  **MText** \* **mlanguage\_text** (MSymbol language)\
 Return the language name written in that language.  **MPlist** \* **mscript\_list** (void)\
 List script names.  **MPlist** \* **mscript\_language\_list** (MSymbol script)\
 List languages that use a specified script.  **MLocale** \* **mlocale\_set** (int category, const char \*name)\
 Set the current locale.  MSymbol **mlocale\_get\_prop** (**MLocale** \*locale, MSymbol key)\
 Get the value of a locale property.  int **mtext\_ftime** (**MText** \*mt, const char \*format, const struct tm \*tm, **MLocale** \*locale)\
 Format date and time.  **MText** \* **mtext\_getenv** (const char \*name)\
 Get an environment variable.  int **mtext\_putenv** (**MText** \*mt)\
 Change or add an environment variable.  int **mtext\_coll** (**MText** \*mt1, **MText** \*mt2)\
 Compare two M-texts using the current locale.

### Variables

MSymbol **Miso639\_1**\
 MSymbol **Miso639\_2**\
 MSymbol **Mterritory**\
 MSymbol **Mmodifier**\
 MSymbol **Mcodeset**\

## Detailed Description

Locale objects and API for them.

The m17n library represents locale related information as objects of type **MLocale**. \

## Typedef Documentation

### typedef struct MLocale MLocale

`struct` `MLocale`. The structure `MLocale` is used to hold information about name, language, territory, modifier, codeset, and the corresponding coding system of locales.

The contents of this structure are implementation dependent. Its internal structure is concealed from application programs. \

**SEE ALSO**

**mlocale\_get\_prop()** \

## Variable Documentation

### MSymbol Miso639\_1

### MSymbol Miso639\_2

### MSymbol Mterritory

The symbol whose name is 'territory'.

### MSymbol Mmodifier

The symbol whose name is 'modifier'.

### MSymbol Mcodeset

The symbol whose name is 'codeset'.

## Author

Generated automatically by Doxygen for The m17n Library from the source code.

## COPYRIGHT

Copyright (C) 2001 Information-technology Promotion Agency (IPA)\
 Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)\
 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License  \<http://www.gnu.org/licenses/fdl.html\>.