nl_langinfoのヘルプ・マニュアル
日本語 英語
nl_langinfo --help
man nl_langinfo
NL_LANGINFO(3) Linux Programmer’s Manual NL_LANGINFO(3)
名前
nl_langinfo - 言語とロケールの情報を問い合わせる
書式
#include
char *nl_langinfo(nl_item item);
説明
nl_langinfo() 関数は、 localeconv(3) より柔軟なロケール情報へのアクセス
方法を提供する。ロケールカテゴリの個々の要素や追加の要素を問い合わせ る
ことができる。
に定数として定義されていて、 item に指定できるロケール要素
の例を以下に示す:
CODESET (LC_CTYPE)
選択されたロケールで用いられる文字エンコード名を示す文字列を返す
。 文 字 エ ン コ ー ド 名 と し て は 、"UTF-8" や "ISO-8859-1"
、"ANSI_X3.4-1968" (これは US-ASCII という名前の方がよく知られて
い る) などがある。この文字列は、"locale charmap" を実行して得ら
れるものと同じである。文字エンコード名の リ ス ト を 得 る に は
、"locale -m" を実行するとよい。参考: locale(1)
D_T_FMT (LC_TIME)
ロ ケール固有の時間と日付を表現するときに、 strftime(3) で使用で
きる書式付き文字列を返す。
D_FMT (LC_TIME)
ロケール固有の日付を表現するときに、 strftime(3) で使用できる 書
式付き文字列を返す。
T_FMT (LC_TIME)
ロ ケール固有の時間を表現するときに、 strftime(3) で使用できる書
式付き文字列を返す。
DAY_{1–7} (LC_TIME)
曜日名 (週の n 番目の日の名前) を返す。[警告: この要素はアメリカ
の慣習に従って DAY_1 が 日曜日となる。国際的な慣習 (ISO 8601) で
は月曜日が週の最初の日である。]
ABDAY_{1–7} (LC_TIME)
曜日 (週の n 番目の日) の省略名を返す。
MON_{1–12} (LC_TIME)
n 番目の月の名前を返す。
ABMON_{1–12} (LC_TIME)
n 番目の月の省略名を返す。
RADIXCHAR (LC_NUMERIC)
基数記号 (小数点やコンマなど) を返す。
THOUSEP (LC_NUMERIC)
千の位 (3 桁の数値) の区切り文字を返す。
YESEXPR (LC_MESSAGES)
yes/no の質問に対する肯定の応答を認識するために、 regex(3) 関 数
で使用できる正規表現を返す。
NOEXPR (LC_MESSAGES)
yes/no の質問に対する否定の応答を認識するために regex(3) 関数で
使用できる正規表現を返す。
CRNCYSTR (LC_MONETARY)
通貨記号を返す。記号が数値の前に配置される場合は、"-" が通貨記号
に 前置される。数値の後に記号が配置される場合は "+" が、記号が基
数文字と置き換わる場合は "." が前置される。
上記のリストは、要求できる定義のごく一部である。詳細なリストは、 GNU C
ライブラリ・リファレンスマニュアルを参照してほしい。
返り値
適切なカテゴリのロケールが選択されていない場合は、 nl_langinfo() は "C"
ロケールのときに相当する文字列へのポインタを返す。
無効な item の場合は、空文字列へのポインタが返される。
このポインタは静的なデータ領域を指し、その内容は次回の nl_langinfo() や
setlocale(3) の呼び出しによって書き替わることがある。
準拠
SUSv2, POSIX.1-2001.
関連項目
locale(1), localeconv(3), setlocale(3), charsets(7), locale(7)
GNU C ライブラリ・リファレンスマニュアル
GNU 2001-05-11 NL_LANGINFO(3)
NL_LANGINFO(3) Linux Programmer’s Manual NL_LANGINFO(3)
NAME
nl_langinfo - query language and locale information
SYNOPSIS
#include
char *nl_langinfo(nl_item item);
DESCRIPTION
The nl_langinfo() function provides access to locale information in a
more flexible way than localeconv(3) does. Individual and additional
elements of the locale categories can be queried.
Examples for the locale elements that can be specified in item using
the constants defined in are:
CODESET (LC_CTYPE)
Return a string with the name of the character encoding used in
the selected locale, such as "UTF-8", "ISO-8859-1", or
"ANSI_X3.4-1968" (better known as US-ASCII). This is the same
string that you get with "locale charmap". For a list of char-
acter encoding names, try "locale -m", cf. locale(1).
D_T_FMT (LC_TIME)
Return a string that can be used as a format string for strf-
time(3) to represent time and date in a locale-specific way.
D_FMT (LC_TIME)
Return a string that can be used as a format string for strf-
time(3) to represent a date in a locale-specific way.
T_FMT (LC_TIME)
Return a string that can be used as a format string for strf-
time(3) to represent a time in a locale-specific way.
DAY_{1–7} (LC_TIME)
Return name of the n-th day of the week. [Warning: this follows
the US convention DAY_1 = Sunday, not the international conven-
tion (ISO 8601) that Monday is the first day of the week.]
ABDAY_{1–7} (LC_TIME)
Return abbreviated name of the n-th day of the week.
MON_{1–12} (LC_TIME)
Return name of the n-th month.
ABMON_{1–12} (LC_TIME)
Return abbreviated name of the n-th month.
RADIXCHAR (LC_NUMERIC)
Return radix character (decimal dot, decimal comma, etc.).
THOUSEP (LC_NUMERIC)
Return separator character for thousands (groups of three dig-
its).
YESEXPR (LC_MESSAGES)
Return a regular expression that can be used with the regex(3)
function to recognize a positive response to a yes/no question.
NOEXPR (LC_MESSAGES)
Return a regular expression that can be used with the regex(3)
function to recognize a negative response to a yes/no question.
CRNCYSTR (LC_MONETARY)
Return the currency symbol, preceded by "-" if the symbol should
appear before the value, "+" if the symbol should appear after
the value, or "." if the symbol should replace the radix charac-
ter.
The above list covers just some examples of items that can be
requested. For a more detailed list, consult The GNU C Library Refer-
ence Manual.
RETURN VALUE
If no locale has been selected for the appropriate category, nl_lang-
info() returns a pointer to the corresponding string in the "C" locale.
If item is not valid, a pointer to an empty string is returned.
This pointer may point to static data that may be overwritten on the
next call to nl_langinfo() or setlocale(3).
Codeset for en_US defaults to ISO-8859-1 (Latin-1). The Latin-1
default has historical reasons, since all Unix systems originally used
only 8-bit character encoding. For more information about ISO-8859-1
see charsets(7).
CONFORMING TO
SUSv2, POSIX.1-2001.
SEE ALSO
locale(1), localeconv(3), setlocale(3), charsets(7), locale(7)
The GNU C Library Reference Manual
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
GNU 2001-05-11 NL_LANGINFO(3)