MLocale* mlocale_set |
( |
int |
category, |
|
|
const char * |
name | |
|
) |
| | |
|
関数 mlocale_set() は現在のロケールの一部を設定したり問い合わせたりする。ここで一部とは category で指定され、setlocale() の有効な第一引数となるものでなくてはならない。
locale が NULL でなければ、指定した部分のロケールがlocale に設定される。 locale がシステムにサポートされていなければ、設定は行われず、現在のロケールは変わらない。
locale が NULL ならば、現在のロケールの指定した部分を問い合わせる。
- 戻り値:
呼び出しに成功すれば、mlocale_set() はロケールに対応する opaque ロケールオブジェクトを返す。ロケールの名前は関数 mlocale_get_prop() によって得ることができる。
そうでなければ NULL を返す。
- エラー:
MERROR_LOCALE
|
int mtext_ftime |
( |
MText * |
mt, |
|
|
const char * |
format, |
|
|
const struct tm * |
tm, |
|
|
MLocale * |
locale | |
|
) |
| | |
|
関数 mtext_ftime() は時刻データ (broken-down time) tm をformat で指定された形式に清書し、結果をM-text mt に付加する。フォーマットは NULL でなければ ロケール locale に、または現在のロケール(LC_TIME) に従う。
引数 tm と format の意味は strftime() の場合と同じ。
- 参照:
- strftime()
|
MText* mtext_getenv |
( |
const char * |
name |
) |
|
|
関数 mtext_getenv() は name で指される文字列と合致する文字列を環境変数のリスト中から探す。
見つかった場合には、その値を現在のロケール(LC_CTYPE) に従って M-text にデコードし、そのM-text を返す。
見つからなければ、NULL を返す。 |
int mtext_putenv |
( |
MText * |
mt |
) |
|
|
関数 mtext_putenv() は M-text mt に従って、環境変数の値を変更したり追加したりする。この関数は、現在のロケール (LC_CTYPE) に従ってmt をエンコードし、それを引数として関数 putenv を呼ぶ。
- 戻り値:
- この関数は、成功した場合には 0 を、エラーが起これば -1 を返す。
|
|
関数 mtext_coll() は2つの M-text mt1 と mt2 を比較する。戻り値は負の整数値, 0, 正の整数値のいずれかであり、それぞれ mt1 が mt2 より小さい、同じ、大きい場合に相当する。比較は現在のロケール (LC_COLLATE) に基づいて行われる。
この関数は M-text のテキストプロパティとして自動的にキャッシュされる情報を利用するので、2度目以降の同じ比較は1度目より速く実行される。 |
|