.\" Copyright (c) 2001 Markus Kuhn <mkuhn@acm.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" References consulted:
.\"   GNU glibc-2 manual
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"
.\" Corrected prototype, 2002-10-18, aeb
.\"
.\" Japanese Version Copyright (c) 2001
.\"          UCHIDA Norihiro all rights reserved.
.\" Translated Sun Jul 15 2001
.\"          by UCHIDA Norihiro <KY4N-UCD@asahi-net.or.jp>
.\"
.TH NL_LANGINFO 3 2010-10-03 "GNU" "Linux Programmer's Manual"
.SH 名前
nl_langinfo \- 言語とロケールの情報を問い合わせる
.SH 書式
.nf
.B #include <langinfo.h>
.sp
.BI "char *nl_langinfo(nl_item " item );
.fi
.SH 説明
.BR nl_langinfo ()
関数は、
.BR localeconv (3)
より柔軟なロケール情報へのアクセス方法を提供する。
ロケールカテゴリの個々の要素や追加の要素を問い合わせることができる。
.PP
\fI<langinfo.h>\fP に定数として定義されていて、
\fIitem\fP に指定できるロケール要素の例を以下に示す:
.TP
.BR CODESET \ (LC_CTYPE)
選択されたロケールで用いられる文字エンコード名を示す文字列を返す。
文字エンコード名としては、"UTF-8" や "ISO-8859-1"、"ANSI_X3.4-1968"
(これは US-ASCII という名前の方がよく知られている) などがある。
この文字列は、"locale charmap" を実行して得られるものと同じである。
文字エンコード名のリストを得るには、"locale \-m" を実行するとよい。
参考:
.BR locale (1)
.TP
.BR D_T_FMT \ (LC_TIME)
ロケール固有の時間と日付を表現するときに、
.BR strftime (3)
で使用できる書式付き文字列を返す。
.TP
.BR D_FMT \ (LC_TIME)
ロケール固有の日付を表現するときに、
.BR strftime (3)
で使用できる書式付き文字列を返す。
.TP
.BR T_FMT \ (LC_TIME)
ロケール固有の時間を表現するときに、
.BR strftime (3)
で使用できる書式付き文字列を返す。
.TP
.BR DAY_ "{1\(en7} (LC_TIME)"
曜日名 (週の \fIn\fP 番目の日の名前) を返す。[警告: この要素はアメリカの
慣習に従って DAY_1 が 日曜日となる。国際的な慣習 (ISO 8601) では月曜日が
週の最初の日である。]
.TP
.BR ABDAY_ "{1\(en7} (LC_TIME)"
曜日 (週の \fIn\fP 番目の日) の省略名を返す。
.TP
.BR MON_ "{1\(en12} (LC_TIME)"
\fIn\fP 番目の月の名前を返す。
.TP
.BR ABMON_ "{1\(en12} (LC_TIME)"
\fIn\fP 番目の月の省略名を返す。
.TP
.BR RADIXCHAR \ (LC_NUMERIC)
基数記号 (小数点やコンマなど) を返す。
.TP
.BR THOUSEP \ (LC_NUMERIC)
千の位 (3 桁の数値) の区切り文字を返す。
.TP
.BR YESEXPR \ (LC_MESSAGES)
yes/no の質問に対する肯定の応答を認識するために、
.BR regex (3)
関数で使用できる正規表現を返す。
.TP
.BR NOEXPR \ (LC_MESSAGES)
yes/no の質問に対する否定の応答を認識するために
.BR regex (3)
関数で使用できる正規表現を返す。
.TP
.BR CRNCYSTR \ (LC_MONETARY)
通貨記号を返す。
記号が数値の前に配置される場合は、"\-" が通貨記号に前置される。
数値の後に記号が配置される場合は "+" が、
記号が基数文字と置き換わる場合は "." が前置される。
.PP
上記のリストは、要求できる定義のごく一部である。
詳細なリストは、
.I "GNU C ライブラリ・リファレンスマニュアル"
を参照してほしい。
.SH 返り値
適切なカテゴリのロケールが
.BR setlocale (3)
によって選択されていない場合は、
.BR nl_langinfo ()
は "C" ロケールのときに相当する文字列へのポインタを返す。
.PP
無効な \fIitem\fP の場合は、空文字列へのポインタが返される。
.PP
このポインタは静的なデータ領域を指し、その内容は次回の
.BR nl_langinfo ()
や
.BR setlocale (3)
の呼び出しによって書き替わることがある。
.SH 準拠
SUSv2, POSIX.1-2001.
.SH 例
以下のプログラムは、環境変数に基いて文字型 (character type) のロケール
を設定し、端末の文字集合の問い合わせを行う。
.LP
.nf
#include <langinfo.h>
#include <locale.h>
#include <stdio.h>
#include <stdlib.h>

int
main(int argc, char *argv[])
{
    setlocale(LC_CTYPE,"");
    printf("%s\\n",nl_langinfo(CODESET));
    exit(EXIT_SUCCESS);
}
.fi
.SH 関連項目
.BR locale (1),
.BR localeconv (3),
.BR setlocale (3),
.BR charsets (7),
.BR locale (7)
.br
GNU C ライブラリ・リファレンスマニュアル