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 .\"
  22 .\" Japanese Version Copyright (c) 2001
  23 .\"          UCHIDA Norihiro all rights reserved.
  24 .\" Translated Sun Jul 15 2001
  25 .\"          by UCHIDA Norihiro <KY4N-UCD@asahi-net.or.jp>
  26 .\"
  27 .TH NL_LANGINFO 3 2014\-05\-28 GNU "Linux Programmer's Manual"
  28 .SH 名前
  29 nl_langinfo \- 言語とロケールの情報を問い合わせる
  30 .SH 書式
  31 .nf
  32 \fB#include <langinfo.h>\fP
  33 .sp
  34 \fBchar *nl_langinfo(nl_item \fP\fIitem\fP\fB);\fP
  35 .fi
  36 .SH 説明
  37 \fBnl_langinfo\fP()  関数は、 \fBlocaleconv\fP(3)  より柔軟なロケール情報へのアクセス方法を提供する。
  38 ロケールカテゴリの個々の要素や追加の要素を問い合わせることができる。
  39 .PP
  40 \fI<langinfo.h>\fP に定数として定義されていて、 \fIitem\fP に指定できるロケール要素の例を以下に示す:
  41 .TP
  42 \fBCODESET\fP\ (LC_CTYPE)
  43 選択されたロケールで用いられる文字エンコード名を示す文字列を返す。 文字エンコード名としては、"UTF\-8" や
  44 "ISO\-8859\-1"、"ANSI_X3.4\-1968" (これは US\-ASCII という名前の方がよく知られている) などがある。
  45 この文字列は、"locale charmap" を実行して得られるものと同じである。 文字エンコード名のリストを得るには、"locale \-m"
  46 を実行するとよい。 参考: \fBlocale\fP(1)
  47 .TP
  48 \fBD_T_FMT\fP\ (LC_TIME)
  49 ロケール固有の時間と日付を表現するときに、 \fBstrftime\fP(3)  で使用できる書式付き文字列を返す。
  50 .TP
  51 \fBD_FMT\fP\ (LC_TIME)
  52 ロケール固有の日付を表現するときに、 \fBstrftime\fP(3)  で使用できる書式付き文字列を返す。
  53 .TP
  54 \fBT_FMT\fP\ (LC_TIME)
  55 ロケール固有の時間を表現するときに、 \fBstrftime\fP(3)  で使用できる書式付き文字列を返す。
  56 .TP
  57 \fBDAY_\fP{1\(en7} (LC_TIME)
  58 曜日名 (週の \fIn\fP 番目の日の名前) を返す。[警告: この要素はアメリカの 慣習に従って DAY_1 が 日曜日となる。国際的な慣習 (ISO
  59 8601) では月曜日が 週の最初の日である。]
  60 .TP
  61 \fBABDAY_\fP{1\(en7} (LC_TIME)
  62 曜日 (週の \fIn\fP 番目の日) の省略名を返す。
  63 .TP
  64 \fBMON_\fP{1\(en12} (LC_TIME)
  65 \fIn\fP 番目の月の名前を返す。
  66 .TP
  67 \fBABMON_\fP{1\(en12} (LC_TIME)
  68 \fIn\fP 番目の月の省略名を返す。
  69 .TP
  70 \fBRADIXCHAR\fP\ (LC_NUMERIC)
  71 基数記号 (小数点やコンマなど) を返す。
  72 .TP
  73 \fBTHOUSEP\fP\ (LC_NUMERIC)
  74 千の位 (3 桁の数値) の区切り文字を返す。
  75 .TP
  76 \fBYESEXPR\fP\ (LC_MESSAGES)
  77 yes/no の質問に対する肯定の応答を認識するために、 \fBregex\fP(3)  関数で使用できる正規表現を返す。
  78 .TP
  79 \fBNOEXPR\fP\ (LC_MESSAGES)
  80 yes/no の質問に対する否定の応答を認識するために \fBregex\fP(3)  関数で使用できる正規表現を返す。
  81 .TP
  82 \fBCRNCYSTR\fP\ (LC_MONETARY)
  83 通貨記号を返す。 記号が数値の前に配置される場合は、"\-" が通貨記号に前置される。 数値の後に記号が配置される場合は "+" が、
  84 記号が基数文字と置き換わる場合は "." が前置される。
  85 .PP
  86 上記のリストは、要求できる定義のごく一部である。 詳細なリストは、 \fIGNU C ライブラリ・リファレンスマニュアル\fP を参照してほしい。
  87 .SH 返り値
  88 適切なカテゴリのロケールが \fBsetlocale\fP(3)  によって選択されていない場合は、 \fBnl_langinfo\fP()  は "C"
  89 ロケールのときに相当する文字列へのポインタを返す。
  90 .PP
  91 無効な \fIitem\fP の場合は、空文字列へのポインタが返される。
  92 .PP
  93 このポインタは静的なデータ領域を指し、その内容は次回の \fBnl_langinfo\fP()  や \fBsetlocale\fP(3)
  94 の呼び出しによって書き替わることがある。
  95 .SH 準拠
  96 SUSv2, POSIX.1\-2001.
  97 .SH 例
  98 The following program sets the character type and the numeric locale
  99 according to the environment and queries the terminal character set and the
 100 radix character.
 101 .LP
 102 .nf
 103 #include <langinfo.h>
 104 #include <locale.h>
 105 #include <stdio.h>
 106 #include <stdlib.h>
 107
 108 int
 109 main(int argc, char *argv[])
 110 {
 111     setlocale(LC_CTYPE, "");
 112     setlocale(LC_NUMERIC, "");
 113     printf("%s\en", nl_langinfo(CODESET));
 114     printf("%s\en", nl_langinfo(RADIXCHAR));
 115     exit(EXIT_SUCCESS);
 116 }
 117 .fi
 118 .SH 関連項目
 119 \fBlocale\fP(1), \fBlocaleconv\fP(3), \fBsetlocale\fP(3), \fBcharsets\fP(7),
 120 \fBlocale\fP(7)
 121 .br
 122 GNU C ライブラリ・リファレンスマニュアル
 123 .SH この文書について
 124 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.68 の一部
 125 である。プロジェクトの説明とバグ報告に関する情報は
 126 http://www.kernel.org/doc/man\-pages/ に書かれている。