release/man3/nl_langinfo.3

   1 .\" Copyright (c) 2001 Markus Kuhn <mkuhn@acm.org>
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" References consulted:
  11 .\"   GNU glibc-2 manual
  12 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  13 .\"
  14 .\" Corrected prototype, 2002-10-18, aeb
  15 .\"
  16 .\"*******************************************************************
  17 .\"
  18 .\" This file was generated with po4a. Translate the source file.
  19 .\"
  20 .\"*******************************************************************
  21 .TH NL_LANGINFO 3 2010\-10\-03 GNU "Linux Programmer's Manual"
  22 .SH 名前
  23 nl_langinfo \- 言語とロケールの情報を問い合わせる
  24 .SH 書式
  25 .nf
  26 \fB#include <langinfo.h>\fP
  27 .sp
  28 \fBchar *nl_langinfo(nl_item \fP\fIitem\fP\fB);\fP
  29 .fi
  30 .SH 説明
  31 \fBnl_langinfo\fP()  関数は、 \fBlocaleconv\fP(3)  より柔軟なロケール情報へのアクセス方法を提供する。
  32 ロケールカテゴリの個々の要素や追加の要素を問い合わせることができる。
  33 .PP
  34 \fI<langinfo.h>\fP に定数として定義されていて、 \fIitem\fP に指定できるロケール要素の例を以下に示す:
  35 .TP
  36 \fBCODESET\fP\ (LC_CTYPE)
  37 選択されたロケールで用いられる文字エンコード名を示す文字列を返す。 文字エンコード名としては、"UTF\-8" や
  38 "ISO\-8859\-1"、"ANSI_X3.4\-1968" (これは US\-ASCII という名前の方がよく知られている) などがある。
  39 この文字列は、"locale charmap" を実行して得られるものと同じである。 文字エンコード名のリストを得るには、"locale \-m"
  40 を実行するとよい。 参考: \fBlocale\fP(1)
  41 .TP
  42 \fBD_T_FMT\fP\ (LC_TIME)
  43 ロケール固有の時間と日付を表現するときに、 \fBstrftime\fP(3)  で使用できる書式付き文字列を返す。
  44 .TP
  45 \fBD_FMT\fP\ (LC_TIME)
  46 ロケール固有の日付を表現するときに、 \fBstrftime\fP(3)  で使用できる書式付き文字列を返す。
  47 .TP
  48 \fBT_FMT\fP\ (LC_TIME)
  49 ロケール固有の時間を表現するときに、 \fBstrftime\fP(3)  で使用できる書式付き文字列を返す。
  50 .TP
  51 \fBDAY_\fP{1\(en7} (LC_TIME)
  52 曜日名 (週の \fIn\fP 番目の日の名前) を返す。[警告: この要素はアメリカの 慣習に従って DAY_1 が 日曜日となる。国際的な慣習 (ISO
  53 8601) では月曜日が 週の最初の日である。]
  54 .TP
  55 \fBABDAY_\fP{1\(en7} (LC_TIME)
  56 曜日 (週の \fIn\fP 番目の日) の省略名を返す。
  57 .TP
  58 \fBMON_\fP{1\(en12} (LC_TIME)
  59 \fIn\fP 番目の月の名前を返す。
  60 .TP
  61 \fBABMON_\fP{1\(en12} (LC_TIME)
  62 \fIn\fP 番目の月の省略名を返す。
  63 .TP
  64 \fBRADIXCHAR\fP\ (LC_NUMERIC)
  65 基数記号 (小数点やコンマなど) を返す。
  66 .TP
  67 \fBTHOUSEP\fP\ (LC_NUMERIC)
  68 千の位 (3 桁の数値) の区切り文字を返す。
  69 .TP
  70 \fBYESEXPR\fP\ (LC_MESSAGES)
  71 yes/no の質問に対する肯定の応答を認識するために、 \fBregex\fP(3)  関数で使用できる正規表現を返す。
  72 .TP
  73 \fBNOEXPR\fP\ (LC_MESSAGES)
  74 yes/no の質問に対する否定の応答を認識するために \fBregex\fP(3)  関数で使用できる正規表現を返す。
  75 .TP
  76 \fBCRNCYSTR\fP\ (LC_MONETARY)
  77 通貨記号を返す。 記号が数値の前に配置される場合は、"\-" が通貨記号に前置される。 数値の後に記号が配置される場合は "+" が、
  78 記号が基数文字と置き換わる場合は "." が前置される。
  79 .PP
  80 上記のリストは、要求できる定義のごく一部である。 詳細なリストは、 \fIGNU C ライブラリ・リファレンスマニュアル\fP を参照してほしい。
  81 .SH 返り値
  82 適切なカテゴリのロケールが \fBsetlocale\fP(3)  によって選択されていない場合は、 \fBnl_langinfo\fP()  は "C"
  83 ロケールのときに相当する文字列へのポインタを返す。
  84 .PP
  85 無効な \fIitem\fP の場合は、空文字列へのポインタが返される。
  86 .PP
  87 このポインタは静的なデータ領域を指し、その内容は次回の \fBnl_langinfo\fP()  や \fBsetlocale\fP(3)
  88 の呼び出しによって書き替わることがある。
  89 .SH 準拠
  90 SUSv2, POSIX.1\-2001.
  91 .SH 例
  92 以下のプログラムは、環境変数に基いて文字型 (character type) のロケール を設定し、端末の文字集合の問い合わせを行う。
  93 .LP
  94 .nf
  95 #include <langinfo.h>
  96 #include <locale.h>
  97 #include <stdio.h>
  98 #include <stdlib.h>
  99
 100 int
 101 main(int argc, char *argv[])
 102 {
 103     setlocale(LC_CTYPE,"");
 104     printf("%s\en",nl_langinfo(CODESET));
 105     exit(EXIT_SUCCESS);
 106 }
 107 .fi
 108 .SH 関連項目
 109 \fBlocale\fP(1), \fBlocaleconv\fP(3), \fBsetlocale\fP(3), \fBcharsets\fP(7),
 110 \fBlocale\fP(7)
 111 .br
 112 GNU C ライブラリ・リファレンスマニュアル
 113 .SH この文書について
 114 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 115 である。プロジェクトの説明とバグ報告に関する情報は
 116 http://www.kernel.org/doc/man\-pages/ に書かれている。