X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=release%2Fman3%2Ficonv_open.3;h=c5703685c0e51e78b659b3191ccf70591d84570c;hb=d6ffc03b1c10eddeb4564716656cf89586cce455;hp=6b175a89e6f1f97d9e6a2365303f88f1499ae44c;hpb=7e089fcc022461849bbc09437103cc337a88dd9c;p=linuxjm%2FLDP_man-pages.git

diff --git a/release/man3/iconv_open.3 b/release/man3/iconv_open.3
index 6b175a89..c5703685 100644
--- a/release/man3/iconv_open.3
+++ b/release/man3/iconv_open.3
@@ -1,9 +1,11 @@
 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
 .\" 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.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"   GNU glibc-2 source code and manual
@@ -13,85 +15,56 @@
 .\" 2007-03-31 Bruno Haible, Describe the glibc/libiconv //TRANSLIT
 .\" and //IGNORE extensions for 'tocode'.
 .\"
-.\" Japanese Version Copyright (c) 2000 Yuichi SATO
-.\"         all rights reserved.
-.\" Translated Tue Jul 11 19:02:58 JST 2000
-.\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
-.\" Updated 2007-06-01, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.50
+.\"*******************************************************************
 .\"
-.\"WORD:	allocate	³ä¤êÅö¤Æ¤ë
-.\"WORD:	descriptor	¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.\"WORD:	conversion	ÊÑ´¹
-.\"WORD:	sequence	ʸ»úÎó
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH ICONV_OPEN 3  2008-08-11 "GNU" "Linux Programmer's Manual"
-.SH ̾Á°
-iconv_open \- ʸ»ú¥»¥Ã¥ÈÊÑ´¹¤Î¤¿¤á¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò³ä¤êÅö¤Æ¤ë
-.SH ½ñ¼°
+.\"*******************************************************************
+.TH ICONV_OPEN 3 2008\-08\-11 GNU "Linux Programmer's Manual"
+.SH 名前
+iconv_open \- 文字セット変換のためのディスクリプタを割り当てる
+.SH 書式
 .nf
-.B #include <iconv.h>
+\fB#include <iconv.h>\fP
 .sp
-.BI "iconv_t iconv_open(const char *" tocode ", const char *" fromcode );
+\fBiconv_t iconv_open(const char *\fP\fItocode\fP\fB, const char *\fP\fIfromcode\fP\fB);\fP
 .fi
-.SH ÀâÌÀ
-.BR iconv_open ()
-´Ø¿ô¤Ï¡¢Ê¸»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥° \fIfromcode\fP ¤«¤é
-ʸ»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥° \fItocode\fP ¤Ø¤Î¥Ð¥¤¥Èʸ»úÎóÊÑ´¹¤ËŬ¤·¤¿
-ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò³ä¤êÅö¤Æ¤ë¡£
+.SH 説明
+\fBiconv_open\fP()  関数は、文字エンコーディング \fIfromcode\fP から 文字エンコーディング \fItocode\fP
+へのバイト文字列変換に適した 変換ディスクリプタを割り当てる。
 .PP
-\fIfromcode\fP ¤È \fItocode\fP ¤Ë»È¤¦¤³¤È¤Î¤Ç¤­¤ëÃͤȡ¢
-¥µ¥Ý¡¼¥È¤µ¤ì¤ëÁȤ߹ç¤ï¤»¤Ï¡¢¥·¥¹¥Æ¥à¤Ë°Í¸¤¹¤ë¡£
-GNU C ¥é¥¤¥Ö¥é¥ê¤Ç¤Ï¡¢»È¤¦¤³¤È¤Î¤Ç¤­¤ëÃͤÏ
-\fBiconv \-\-list\fP ¥³¥Þ¥ó¥É¤Ç¥ê¥¹¥È¤µ¤ì¡¢
-¥ê¥¹¥È¤µ¤ì¤¿¤¹¤Ù¤Æ¤ÎÃͤÎÁȤ߹ç¤ï¤»¤¬¥µ¥Ý¡¼¥È¤µ¤ì¤ë¡£
-¤µ¤é¤Ë¡¢ GNU C ¥é¥¤¥Ö¥é¥ê¤È GNU libiconv ¥é¥¤¥Ö¥é¥ê¤Ç¤Ï¡¢
-°Ê²¼¤ÎÀÜÈø¼­¤¬¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¡£
-.TP
+\fIfromcode\fP と \fItocode\fP に使うことのできる値と、 サポートされる組み合わせは、システムに依存する。 GNU C
+ライブラリでは、使うことのできる値は \fBiconv \-\-list\fP コマンドでリストされ、 リストされたすべての値の組み合わせがサポートされる。
+さらに、 GNU C ライブラリと GNU libiconv ライブラリでは、 以下の接尾辞がサポートされている。
+.TP 
 //TRANSLIT
-\fItocode\fP ¤Î¸å¤í¤Ëʸ»úÎó "//TRANSLIT" ¤¬ÉÕ¤¤¤Æ¤¤¤ë¾ì¹ç¡¢
-ËÝÌõ (transliteration) ¤¬Í­¸ú¤Ë¤Ê¤ë¡£¤³¤Î¾ì¹ç¡¢
-ÊÑ´¹Àè¤Îʸ»ú¥»¥Ã¥È¤Çɽ¸½¤Ç¤­¤Ê¤¤Ê¸»ú¤ò¡¢¤½¤Îʸ»ú¤ÈƱ¤¸¤è¤¦¤Ë¸«¤¨¤ë
-ʸ»ú (Ê£¿ôʸ»ú¤Î¾ì¹ç¤â¤¢¤ë) ¤Çɽ¸½¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
-.TP
+\fItocode\fP の後ろに文字列 "//TRANSLIT" が付いている場合、 翻訳 (transliteration) が有効になる。この場合、
+変換先の文字セットで表現できない文字を、その文字と同じように見える 文字 (複数文字の場合もある) で表現することができる。
+.TP 
 //IGNORE
-\fItocode\fP ¤Î¸å¤í¤Ëʸ»úÎó "//IGNORE" ¤¬ÉÕ¤¤¤Æ¤¤¤ë¾ì¹ç¡¢
-ÊÑ´¹Àè¤Îʸ»ú¥»¥Ã¥È¤Çɽ¸½¤Ç¤­¤Ê¤¤Ê¸»ú¤ÏÌۤäÆ̵»ë¤µ¤ì¤ë¡£
+\fItocode\fP の後ろに文字列 "//IGNORE" が付いている場合、 変換先の文字セットで表現できない文字は黙って無視される。
 .PP
-¤³¤Î´Ø¿ô¤òÆɤó¤ÇÆÀ¤é¤ì¤¿ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¡¢
-.BR iconv (3)
-¤Ç
-²¿Å٤Ǥâ»È¤¦¤³¤È¤¬¤Ç¤­¤ë¡£
-¤³¤ì¤Ï
-.BR iconv_close (3)
-¤ò»È¤Ã¤Æ²òÊü¤µ¤ì¤ë¤Þ¤ÇÍ­¸ú¤Ç¤¢¤ë¡£
+この関数を読んで得られた変換ディスクリプタは、 \fBiconv\fP(3)  で 何度でも使うことができる。 これは \fBiconv_close\fP(3)
+を使って解放されるまで有効である。
 .PP
-ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÏÊÑ´¹¾õÂÖ¤ò»ý¤Ä¡£
-.BR iconv_open ()
-¤òÍѤ¤¤ÆÀ¸À®¤µ¤ì¤¿¸å¡¢ÊÑ´¹¾õÂ֤Ͻé´ü¾õÂ֤Ǥ¢¤ë¡£
-.BR iconv (3)
-¤ò»È¤¦¤³¤È¤Ë¤è¤ê¡¢¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÎÊÑ´¹¾õÂÖ¤¬Êѹ¹¤µ¤ì¤ë¡£
-(ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¥Þ¥ë¥Á¥¹¥ì¥Ã¥É¤Ç
-Ʊ»þ¤Ë»È¤¦¤³¤È¤¬¤Ç¤­¤Ê¤¤¤³¤È¤ò°ÕÌ£¤·¤Æ¤¤¤ë¡£)
-ÊÑ´¹¾õÂÖ¤ò½é´ü¾õÂÖ¤ËÌ᤹¤Ë¤Ï¡¢
-\fIinbuf\fP °ú¤­¿ô¤ò NULL ¤È¤·¤Æ
-.BR iconv (3)
-¤òÍѤ¤¤ë¤³¤È¡£
-.SH ÊÖ¤êÃÍ
-.BR iconv_open ()
-´Ø¿ô¤Ï¡¢¿·¤¿¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤Î¾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï \fIerrno\fP ¤òÀßÄꤷ¡¢
-.I (iconv_t)\ \-1
-¤òÊÖ¤¹¡£
-.SH ¥¨¥é¡¼
-¾¤Î¤¤¤í¤¤¤í¤Ê¥¨¥é¡¼¤Î¤¦¤Á¡¢°Ê²¼¤Î¥¨¥é¡¼¤¬µ¯¤³¤ê¤¦¤ë¡£
-.TP
-.B EINVAL
-\fIfromcode\fP ¤«¤é \fItocode\fP ¤Ø¤ÎÊÑ´¹¤Ï¡¢¤³¤Î¼ÂÁõ¤Ç¤Ï¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
-.SH ¥Ð¡¼¥¸¥ç¥ó
-¤³¤Î´Ø¿ô¤Ï¥Ð¡¼¥¸¥ç¥ó 2.1 °Ê¹ß¤Î glibc ¤ÇÍøÍѲÄǽ¤Ç¤¢¤ë¡£
-.SH ½àµò
-UNIX98, POSIX.1-2001.
-.SH ´ØÏ¢¹àÌÜ
-.BR iconv (1),
-.BR iconv (3),
-.BR iconv_close (3)
+変換ディスクリプタは変換状態を持つ。 \fBiconv_open\fP()  を用いて生成された後、変換状態は初期状態である。 \fBiconv\fP(3)
+を使うことにより、ディスクリプタの変換状態が変更される。 (変換ディスクリプタはマルチスレッドで 同時に使うことができないことを意味している。)
+変換状態を初期状態に戻すには、 \fIinbuf\fP 引き数を NULL として \fBiconv\fP(3)  を用いること。
+.SH 返り値
+\fBiconv_open\fP()  関数は、新たに割り当てられた変換ディスクリプタを返す。 エラーの場合、この関数は \fIerrno\fP を設定し、
+\fI(iconv_t)\ \-1\fP を返す。
+.SH エラー
+他のいろいろなエラーのうち、以下のエラーが起こりうる。
+.TP 
+\fBEINVAL\fP
+\fIfromcode\fP から \fItocode\fP への変換は、この実装ではサポートされていない。
+.SH バージョン
+この関数はバージョン 2.1 以降の glibc で利用可能である。
+.SH 準拠
+UNIX98, POSIX.1\-2001.
+.SH 関連項目
+\fBiconv\fP(1), \fBiconv\fP(3), \fBiconv_close\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.51 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。