[linuxjm/LDP_man-pages.git] / draft / man3 / nl_langinfo.3

.\" 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 2001-05-11 "GNU" "Linux Programmer's Manual"
.\"O .SH NAME
.\"O nl_langinfo \- query language and locale information
.SH ̾Á°
nl_langinfo \- ¸À¸ì¤È¥í¥±¡¼¥ë¤Î¾ðÊó¤òÌ䤤¹ç¤ï¤»¤ë
.\"O .SH SYNOPSIS
.SH ½ñ¼°
.nf
.B #include <langinfo.h>
.sp
.BI "char *nl_langinfo(nl_item " item );
.fi
.\"O .SH DESCRIPTION
.SH ÀâÌÀ
.\"O The
.\"O .BR nl_langinfo ()
.\"O function provides access to locale information
.\"O in a more flexible way than
.\"O .BR localeconv (3)
.\"O does.
.\"O Individual and additional elements of the locale categories can
.\"O be queried.
.BR nl_langinfo ()
´Ø¿ô¤Ï¡¢
.BR localeconv (3)
¤è¤ê½ÀÆð¤Ê¥í¥±¡¼¥ë¾ðÊó¤Ø¤Î¥¢¥¯¥»¥¹ÊýË¡¤òÄ󶡤¹¤ë¡£
¥í¥±¡¼¥ë¥«¥Æ¥´¥ê¤Î¸Ä¡¹¤ÎÍ×ÁǤäÄɲäÎÍ×ÁǤòÌ䤤¹ç¤ï¤»¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
.PP
.\"O Examples for the locale elements that can be specified in \fIitem\fP
.\"O using the constants defined in \fI<langinfo.h>\fP are:
\fI<langinfo.h>\fP ¤ËÄê¿ô¤È¤·¤ÆÄêµÁ¤µ¤ì¤Æ¤¤¤Æ¡¢
\fIitem\fP ¤Ë»ØÄê¤Ç¤­¤ë¥í¥±¡¼¥ëÍ×ÁǤÎÎã¤ò°Ê²¼¤Ë¼¨¤¹:
.TP
.BR CODESET \ (LC_CTYPE)
.\"O Return a string with the name of the character encoding used in the
.\"O selected locale, such as "UTF-8", "ISO-8859-1", or "ANSI_X3.4-1968"
.\"O (better known as US-ASCII).
.\"O This is the same string that you get with
.\"O "locale charmap".
.\"O For a list of character encoding names,
.\"O try "locale \-m", cf.\&
.\"O .BR locale (1).
ÁªÂò¤µ¤ì¤¿¥í¥±¡¼¥ë¤ÇÍѤ¤¤é¤ì¤ëʸ»ú¥¨¥ó¥³¡¼¥É̾¤ò¼¨¤¹Ê¸»úÎó¤òÊÖ¤¹¡£
ʸ»ú¥¨¥ó¥³¡¼¥É̾¤È¤·¤Æ¤Ï¡¢"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)
.\"O Return a string that can be used as a format string for
.\"O .BR strftime (3)
.\"O to represent time and date in a locale-specific way.
¥í¥±¡¼¥ë¸ÇÍ­¤Î»þ´Ö¤ÈÆüÉÕ¤òɽ¸½¤¹¤ë¤È¤­¤Ë¡¢
.BR strftime (3)
¤Ç»ÈÍѤǤ­¤ë½ñ¼°ÉÕ¤­Ê¸»úÎó¤òÊÖ¤¹¡£
.TP
.BR D_FMT \ (LC_TIME)
.\"O Return a string that can be used as a format string for
.\"O .BR strftime (3)
.\"O to represent a date in a locale-specific way.
¥í¥±¡¼¥ë¸ÇÍ­¤ÎÆüÉÕ¤òɽ¸½¤¹¤ë¤È¤­¤Ë¡¢
.BR strftime (3)
¤Ç»ÈÍѤǤ­¤ë½ñ¼°ÉÕ¤­Ê¸»úÎó¤òÊÖ¤¹¡£
.TP
.BR T_FMT \ (LC_TIME)
.\"O Return a string that can be used as a format string for
.\"O .BR strftime (3)
.\"O to represent a time in a locale-specific way.
¥í¥±¡¼¥ë¸ÇÍ­¤Î»þ´Ö¤òɽ¸½¤¹¤ë¤È¤­¤Ë¡¢
.BR strftime (3)
¤Ç»ÈÍѤǤ­¤ë½ñ¼°ÉÕ¤­Ê¸»úÎó¤òÊÖ¤¹¡£
.TP
.BR DAY_ "{1\(en7} (LC_TIME)"
.\"O Return name of the \fIn\fP-th day of the week. [Warning: this follows
.\"O the US convention DAY_1 = Sunday, not the international convention
.\"O (ISO 8601) that Monday is the first day of the week.]
ÍËÆü̾ (½µ¤Î \fIn\fP ÈÖÌܤÎÆü¤Î̾Á°) ¤òÊÖ¤¹¡£[·Ù¹ð: ¤³¤ÎÍ×ÁǤϥ¢¥á¥ê¥«¤Î
´·½¬¤Ë½¾¤Ã¤Æ DAY_1 ¤¬ ÆüÍËÆü¤È¤Ê¤ë¡£¹ñºÝŪ¤Ê´·½¬ (ISO 8601) ¤Ç¤Ï·îÍËÆü¤¬
½µ¤ÎºÇ½é¤ÎÆü¤Ç¤¢¤ë¡£]
.TP
.BR ABDAY_ "{1\(en7} (LC_TIME)"
.\"O Return abbreviated name of the \fIn\fP-th day of the week.
ÍËÆü (½µ¤Î \fIn\fP ÈÖÌܤÎÆü) ¤Î¾Êά̾¤òÊÖ¤¹¡£
.TP
.BR MON_ "{1\(en12} (LC_TIME)"
.\"O Return name of the \fIn\fP-th month.
\fIn\fP ÈÖÌܤηî¤Î̾Á°¤òÊÖ¤¹¡£
.TP
.BR ABMON_ "{1\(en12} (LC_TIME)"
.\"O Return abbreviated name of the \fIn\fP-th month.
\fIn\fP ÈÖÌܤηî¤Î¾Êά̾¤òÊÖ¤¹¡£
.TP
.BR RADIXCHAR \ (LC_NUMERIC)
.\"O Return radix character (decimal dot, decimal comma, etc.).
´ð¿ôµ­¹æ (¾®¿ôÅÀ¤ä¥³¥ó¥Þ¤Ê¤É) ¤òÊÖ¤¹¡£
.TP
.BR THOUSEP \ (LC_NUMERIC)
.\"O Return separator character for thousands (groups of three digits).
Àé¤Î°Ì (3 ·å¤Î¿ôÃÍ) ¤Î¶èÀÚ¤êʸ»ú¤òÊÖ¤¹¡£
.TP
.BR YESEXPR \ (LC_MESSAGES)
.\"O Return a regular expression that can be used with the
.\"O .BR regex (3)
.\"O function to recognize a positive response to a yes/no question.
yes/no ¤Î¼ÁÌä¤ËÂФ¹¤ë¹ÎÄê¤Î±þÅú¤òǧ¼±¤¹¤ë¤¿¤á¤Ë¡¢
.BR regex (3)
´Ø¿ô¤Ç»ÈÍѤǤ­¤ëÀµµ¬É½¸½¤òÊÖ¤¹¡£
.TP
.BR NOEXPR \ (LC_MESSAGES)
.\"O Return a regular expression that can be used with the
.\"O .BR regex (3)
.\"O function to recognize a negative response to a yes/no question.
yes/no ¤Î¼ÁÌä¤ËÂФ¹¤ëÈÝÄê¤Î±þÅú¤òǧ¼±¤¹¤ë¤¿¤á¤Ë
.BR regex (3)
´Ø¿ô¤Ç»ÈÍѤǤ­¤ëÀµµ¬É½¸½¤òÊÖ¤¹¡£
.TP
.BR CRNCYSTR \ (LC_MONETARY)
.\"O Return the currency symbol, preceded by "\-" if the symbol should
.\"O appear before the value, "+" if the symbol should appear after the
.\"O value, or "." if the symbol should replace the radix character.
Ä̲ߵ­¹æ¤òÊÖ¤¹¡£
µ­¹æ¤¬¿ôÃͤÎÁ°¤ËÇÛÃÖ¤µ¤ì¤ë¾ì¹ç¤Ï¡¢"\-" ¤¬Ä̲ߵ­¹æ¤ËÁ°ÃÖ¤µ¤ì¤ë¡£
¿ôÃͤθå¤Ëµ­¹æ¤¬ÇÛÃÖ¤µ¤ì¤ë¾ì¹ç¤Ï "+" ¤¬¡¢
µ­¹æ¤¬´ð¿ôʸ»ú¤ÈÃÖ¤­´¹¤ï¤ë¾ì¹ç¤Ï "." ¤¬Á°ÃÖ¤µ¤ì¤ë¡£
.PP
.\"O The above list covers just some examples of items that can be requested.
.\"O For a more detailed list, consult
.\"O .IR "The GNU C Library Reference Manual" .
¾åµ­¤Î¥ê¥¹¥È¤Ï¡¢Í×µá¤Ç¤­¤ëÄêµÁ¤Î¤´¤¯°ìÉô¤Ç¤¢¤ë¡£
¾ÜºÙ¤Ê¥ê¥¹¥È¤Ï¡¢
.I "GNU C ¥é¥¤¥Ö¥é¥ê¡¦¥ê¥Õ¥¡¥ì¥ó¥¹¥Þ¥Ë¥å¥¢¥ë"
¤ò»²¾È¤·¤Æ¤Û¤·¤¤¡£
.\"O .SH "RETURN VALUE"
.SH ÊÖ¤êÃÍ
.\"O If no locale has been selected for the appropriate category,
.\"O .BR nl_langinfo ()
.\"O returns a pointer to the corresponding string in the
.\"O "C" locale.
ŬÀڤʥ«¥Æ¥´¥ê¤Î¥í¥±¡¼¥ë¤¬ÁªÂò¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ï¡¢
.BR nl_langinfo ()
¤Ï "C" ¥í¥±¡¼¥ë¤Î¤È¤­¤ËÁêÅö¤¹¤ëʸ»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
.PP
.\"O If \fIitem\fP is not valid, a pointer to an empty string is returned.
̵¸ú¤Ê \fIitem\fP ¤Î¾ì¹ç¤Ï¡¢¶õʸ»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤¬ÊÖ¤µ¤ì¤ë¡£
.PP
.\"O This pointer may point to static data that may be overwritten on the
.\"O next call to \fBnl_langinfo\fP() or
.\"O .BR setlocale (3).
¤³¤Î¥Ý¥¤¥ó¥¿¤ÏÀÅŪ¤Ê¥Ç¡¼¥¿Îΰè¤ò»Ø¤·¡¢¤½¤ÎÆâÍƤϼ¡²ó¤Î
.BR nl_langinfo ()
¤ä
.BR setlocale (3)
¤Î¸Æ¤Ó½Ð¤·¤Ë¤è¤Ã¤Æ½ñ¤­Âؤï¤ë¤³¤È¤¬¤¢¤ë¡£
.\"O .SH "CONFORMING TO"
.SH ½àµò
SUSv2, POSIX.1-2001.
.\"O .SH "SEE ALSO"
.SH ´ØÏ¢¹àÌÜ
.BR locale (1),
.BR localeconv (3),
.BR setlocale (3),
.BR charsets (7),
.BR locale (7)
.br
.\"O The GNU C Library Reference Manual
GNU C ¥é¥¤¥Ö¥é¥ê¡¦¥ê¥Õ¥¡¥ì¥ó¥¹¥Þ¥Ë¥å¥¢¥ë