OSDN Git Service

(split) LDP: Restore and add Copyrights for draft pages
[linuxjm/LDP_man-pages.git] / draft / man3 / iconv.3
index 4c6147b..fabb4fc 100644 (file)
 .\" 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
 .\"   OpenGroup's Single UNIX specification
 .\"    http://www.UNIX-systems.org/online.html
+.\"
 .\" 2000-06-30 correction by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
 .\" 2000-11-15 aeb, fixed prototype
 .\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
 .\" Japanese Version Copyright (c) 2000 Yuichi SATO
 .\"         all rights reserved.
 .\" Translated 2000-07-11, Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
 .\" Updated 2008-09-14, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.09
+.\" Updated 2012-05-30, Akihiro MOTOKI <amotoki@gmail.com>
 .\"
-.\"WORD:       conversion      ÊÑ´¹
-.\"WORD:       descriptor      ¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼
-.\"WORD:       sequence        Ê¸»úÎó
-.\"WORD:       
-.\"
-.TH ICONV 3 2008-09-08 "GNU" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O iconv \- perform character set conversion
-iconv \- Ê¸»ú¥»¥Ã¥ÈÊÑ´¹¤ò¹Ô¤¦
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.TH ICONV 3 2012\-05\-10 GNU "Linux Programmer's Manual"
+.SH 名前
+iconv \- 文字セット変換を行う
+.SH 書式
 .nf
-.B #include <iconv.h>
+\fB#include <iconv.h>\fP
 .sp
-.BI "size_t iconv(iconv_t " cd ,
-.BI "             char **" inbuf ", size_t *" inbytesleft ,
-.BI "             char **" outbuf ", size_t *" outbytesleft );
+\fBsize_t iconv(iconv_t \fP\fIcd\fP\fB,\fP
+\fB             char **\fP\fIinbuf\fP\fB, size_t *\fP\fIinbytesleft\fP\fB,\fP
+\fB             char **\fP\fIoutbuf\fP\fB, size_t *\fP\fIoutbytesleft\fP\fB);\fP
 .fi
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The argument \fIcd\fP must be a conversion descriptor created using the
-.\"O function
-.\"O .BR iconv_open (3).
-°ú¤­¿ô \fIcd\fP ¤Ï¡¢´Ø¿ô
-.BR iconv_open (3)
-¤ò»È¤Ã¤ÆÀ¸À®¤µ¤ì¤ë
-ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.PP
-.\"O The main case is when \fIinbuf\fP is not NULL and \fI*inbuf\fP is not NULL.
-.\"O In this case, the
-.\"O .BR iconv ()
-.\"O function converts the multibyte sequence
-.\"O starting at \fI*inbuf\fP to a multibyte sequence starting at \fI*outbuf\fP.
-.\"O At most \fI*inbytesleft\fP bytes, starting at \fI*inbuf\fP, will be read.
-.\"O At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written.
-¼ç¤Ë»È¤ï¤ì¤ë¤Î¤Ï¡¢
-¡Ö\fIinbuf\fP ¤¬ NULL ¤Ç¤Ê¤¯¡¢¤«¤Ä \fI*inbuf\fP ¤¬ NULL ¤Ç¤Ê¤¤¡×
-¤È¤¤¤¦¾ì¹ç¤Ç¤¢¤ë¡£
-¤³¤Î¾ì¹ç¡¢
-.BR iconv ()
-´Ø¿ô¤Ï¡¢
-\fI*inbuf\fP ¤Ç»Ï¤Þ¤ë¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤ò
-\fI*outbuf\fP ¤Ç»Ï¤Þ¤ë¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤ËÊÑ´¹¤¹¤ë¡£
-\fI*inbuf\fP ¤òÀèƬ¤È¤·¤ÆºÇÂç \fI*inbytesleft\fP ¥Ð¥¤¥È¤¬Æɤ߹þ¤Þ¤ì¡¢
-\fI*outbuf\fP ¤òÀèƬ¤È¤·¤ÆºÇÂç \fI*outbytesleft\fP ¥Ð¥¤¥È¤¬½ñ¤­½Ð¤µ¤ì¤ë¡£
-.PP
-.\"O The
-.\"O .BR iconv ()
-.\"O function converts one multibyte character at a time, and for
-.\"O each character conversion it increments \fI*inbuf\fP and decrements
-.\"O \fI*inbytesleft\fP by the number of converted input bytes, it increments
-.\"O \fI*outbuf\fP and decrements \fI*outbytesptr\fP by the number of converted
-.\"O output bytes, and it updates the conversion state contained in \fIcd\fP.
-.\"O If the character encoding of the input is stateful, the
-.\"O .BR iconv ()
-.\"O function can also convert a sequence of input bytes
-.\"O to an update to the conversion state without producing any output bytes;
-.\"O such input is called a \fIshift sequence\fP.
-.\"O The conversion can stop for four reasons:
-.BR iconv ()
-´Ø¿ô¤Ï 1 Å٤ˠ1 ¤Ä¤Î¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»ú¤òÊÑ´¹¤¹¤ë¡£
-¤½¤·¤Æ¡¢³Æʸ»úÊÑ´¹Ëè¤Ë¡¢ÊÑ´¹¤µ¤ì¤¿ÆþÎϥХ¤¥È¤Î¿ô¤À¤±
-\fI*inbuf\fP ¤òÁý²Ã¤µ¤»¡¢\fI*inbytesleft\fP ¤ò¸º¾¯¤µ¤»¤ë¡£
-¤Þ¤¿¡¢ÊÑ´¹¤µ¤ì¤¿½ÐÎϥХ¤¥È¤Î¿ô¤À¤±
-\fI*outbuf\fP ¤òÁý²Ã¤µ¤»¡¢\fI*outbytesleft\fP ¤ò¸º¾¯¤µ¤»¤ë¡£
-¤µ¤é¤Ë¡¢\fIcd\fP ¤Ë´Þ¤Þ¤ì¤ëÊÑ´¹¾õÂÖ¤ò¹¹¿·¤¹¤ë¡£
-ÆþÎϤÎʸ»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥°¤¬¤¬¾õÂÖ¤ò»ý¤Ä¾ì¹ç¡¢
-.BR iconv ()
-´Ø¿ô¤ÏÆþÎϥХ¤¥È¤ÎÎó¤ËÂФ·¤ÆÊÑ´¹¤Ë¤âÂбþ¤·¤Æ¤ª¤ê¡¢
-¥Ð¥¤¥È½ÐÎϤòȼ¤ï¤º¤ËÊÑ´¹¾õÂÖ¤ò¹¹¿·¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
-ÊÑ´¹¤Ï¡¢¼¡¤Î 4 ¤Ä¤Î¾ì¹ç¤ËÄä»ß¤¹¤ë¡£
-.PP
-.\"O 1. An invalid multibyte sequence is encountered in the input.
-.\"O In this case
-.\"O it sets \fIerrno\fP to \fBEILSEQ\fP and returns
-.\"O .IR (size_t)\ \-1 .
-.\"O \fI*inbuf\fP
-.\"O is left pointing to the beginning of the invalid multibyte sequence.
-1. ÆþÎϤË̵¸ú¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎ󤬤¢¤Ã¤¿¾ì¹ç¡£
-¤³¤Î¾ì¹ç¡¢´Ø¿ô¤Ï \fIerrno\fP ¤ò \fBEILSEQ\fP ¤ËÀßÄꤷ¡¢
-.I (size_t)\ \-1
-¤òÊÖ¤¹¡£
-\fI*inbuf\fP ¤Ï¡¢Ìµ¸ú¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤ÎÀèƬ¤ò»Ø¤·¤¿¤Þ¤Þ¤Ë¤Ê¤ë¡£
-.PP
-.\"O 2. The input byte sequence has been entirely converted,
-.\"O that is, \fI*inbytesleft\fP has gone down to 0.
-.\"O In this case
-.\"O .BR iconv ()
-.\"O returns the number of
-.\"O nonreversible conversions performed during this call.
-2. ÆþÎϥХ¤¥Èʸ»úÎ󤬴°Á´¤ËÊÑ´¹¤µ¤ì¡¢\fI*inbytesleft\fP ¤¬ 0 ¤Ë¤Ê¤Ã¤¿¾ì¹ç¡£
-¤³¤Î¾ì¹ç¡¢
-.BR iconv ()
-¤Ï¡¢¸Æ½Ð¤·¤Î´Ö¤ËÈó²ÄµÕÊÑ´¹¤¬¹Ô¤ï¤ì¤¿²ó¿ô¤òÊÖ¤¹¡£
+.SH 説明
+\fBiconv\fP() 関数は、ある文字エンコーディングの文字シーケンス列を別の文字
+エンコーディングの文字シーケンスに変換する。\fIcd\fP 引き数は変換ディスク
+リプタ (conversion descriptor) であり、以前は \fBiconv_open\fP(3) を呼び出
+すことで生成されていた。変換ディスクリプタは \fBiconv\fP() が変換に使用す
+る文字エンコーディングを定義するものである。 \fIinbuf\fP 引き数は入力シー
+ケンスの先頭バイトを指す変数のアドレスであり、\fIinbytesleft\fP は入力シー
+ケンスのバッファのバイト数を示す。\fIoutbuf\fP 引き数は出力バッファで利用
+できる先頭バイトを指す変数のアドレスであり、 \fIoutbytesleft\fP は出力
+バッファのバイト数を示す。
 .PP
-.\"O 3. An incomplete multibyte sequence is encountered in the input, and the
-.\"O input byte sequence terminates after it.
-.\"O In this case it sets \fIerrno\fP to
-.\"O \fBEINVAL\fP and returns
-.\"O .IR (size_t)\ \-1 .
-.\"O \fI*inbuf\fP is left pointing to the
-.\"O beginning of the incomplete multibyte sequence.
-3. ÆþÎϤËÉÔ´°Á´¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎ󤬤¢¤ê¡¢
-ÆþÎϥХ¤¥Èʸ»úÎ󤬤½¤Î¸å¤Ç½ªÎ»¤·¤Æ¤¤¤ë¾ì¹ç¡£
-¤³¤Î¾ì¹ç¡¢´Ø¿ô¤Ï¡¢\fIerrno\fP ¤ò \fBEINVAL\fP ¤ËÀßÄꤷ¡¢
-.I (size_t)\ \-1
-¤òÊÖ¤¹¡£
-\fI*inbuf\fP ¤Ï¡¢ÉÔ´°Á´¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤ÎÀèƬ¤ò»Ø¤·¤¿¤Þ¤Þ¤Ë¤µ¤ì¤ë¡£
+主に使われるのは、 「\fIinbuf\fP が NULL でなく、かつ \fI*inbuf\fP が NULL でない」 という場合である。 この場合、
+\fBiconv\fP()  関数は、 \fI*inbuf\fP で始まるマルチバイト文字列を \fI*outbuf\fP で始まるマルチバイト文字列に変換する。
+\fI*inbuf\fP を先頭として最大 \fI*inbytesleft\fP バイトが読み込まれ、 \fI*outbuf\fP を先頭として最大
+\fI*outbytesleft\fP バイトが書き出される。
 .PP
-.\"O 4. The output buffer has no more room for the next converted character.
-.\"O In this case it sets \fIerrno\fP to \fBE2BIG\fP and returns
-.\"O .IR (size_t)\ \-1 .
-4. ½ÐÎϥХåե¡¡¼¤Ë¼¡¤ÎÊÑ´¹¤µ¤ì¤¿Ê¸»úÎó¤Î¤¿¤á¤Î¶õ¤­¤¬¤Ê¤¤¾ì¹ç¡£
-¤³¤Î¾ì¹ç¡¢\fIerrno\fP ¤¬ \fBE2BIG\fP ¤ËÀßÄꤵ¤ì¡¢
-.I (size_t)\ \-1
-¤¬ÊÖ¤µ¤ì¤ë¡£
+\fBiconv\fP()  関数は 1 度に 1 つのマルチバイト文字を変換する。 そして、各文字変換毎に、変換された入力バイトの数だけ \fI*inbuf\fP
+を増加させ、\fI*inbytesleft\fP を減少させる。 また、変換された出力バイトの数だけ \fI*outbuf\fP
+を増加させ、\fI*outbytesleft\fP を減少させる。 さらに、\fIcd\fP に含まれる変換状態を更新する。
+入力の文字エンコーディングがが状態を持つ場合、 \fBiconv\fP()  関数は入力バイトの列に対して変換にも対応しており、
+バイト出力を伴わずに変換状態を更新することができる。 変換は、次の 4 つの場合に停止する。
+.IP 1. 3
+入力に無効なマルチバイト文字列があった場合。この場合、
+関数は \fIerrno\fP を \fBEILSEQ\fP に設定し、 \fI(size_t)\ \-1\fP を返す。
+\fI*inbuf\fP は、無効なマルチバイト文字列の先頭を指したままになる。
+.IP 2.
+入力バイト文字列が完全に変換され、\fI*inbytesleft\fP が 0 になった場合。
+この場合、 \fBiconv\fP() は呼出しの間に非可逆変換が行われた回数を返す。
+.IP 3.
+入力に不完全なマルチバイト文字列があり、入力バイト文字列がその後で終了
+している場合。この場合、関数は、\fIerrno\fP を \fBEINVAL\fP に設定し、
+\fI(size_t)\ \-1\fP を返す。 \fI*inbuf\fP は、不完全なマルチバイト文字列の先頭
+を指したままにされる。
+.IP 4.
+出力バッファーに次の変換された文字列のための空きがない場合。 この場合、
+\fIerrno\fP が \fBE2BIG\fP に設定され、 \fI(size_t)\ \-1\fP が返される。
 .PP
-.\"O A different case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, but
-.\"O \fIoutbuf\fP is not NULL and \fI*outbuf\fP is not NULL.
-.\"O In this case, the
-.\"O .BR iconv ()
-.\"O function attempts to set \fIcd\fP's conversion state to the
-.\"O initial state and store a corresponding shift sequence at \fI*outbuf\fP.
-.\"O At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written.
-.\"O If the output buffer has no more room for this reset sequence, it sets
-.\"O \fIerrno\fP to \fBE2BIG\fP and returns
-.\"O .IR (size_t)\ \-1 .
-.\"O Otherwise it increments
-.\"O \fI*outbuf\fP and decrements \fI*outbytesptr\fP by the number of bytes
-.\"O written.
-Ê̤Υ±¡¼¥¹¤È¤·¤Æ¤Ï¡¢
-¡Ö\fIinbuf\fP ¤¬ NULL¡¢¤Þ¤¿¤Ï \fI*inbuf\fP ¤¬ NULL ¤Ç¤¢¤ë¡£
-¤·¤«¤·¡¢\fIoutbuf\fP ¤¬ NULL ¤Ç¤Ê¤¯¡¢¤«¤Ä \fI*outbuf\fP ¤¬ NULL ¤Ç¤Ê¤¤¡×
-¤È¤¤¤¦¾ì¹ç¤¬¤¢¤ë¡£
-¤³¤Î¾ì¹ç¡¢
-.BR iconv ()
-´Ø¿ô¤Ï¡¢\fIcd\fP ¤ÎÊÑ´¹¾õÂÖ¤ò½é´ü¾õÂ֤ˤ·¤Æ¡¢
-Âбþ¤¹¤ë¥·¥Õ¥Èʸ»úÎó¤ò \fI*outbuf\fP ¤ËÊݸ¤·¤è¤¦¤È¤¹¤ë¡£
-ºÇÂç \fI*outbytesleft\fP ¥Ð¥¤¥È¤¬¡¢\fI*outbuf\fP ¤ò»Ï¤á¤È¤·¤Æ½ñ¤­½Ð¤µ¤ì¤ë¡£
-¤³¤Î¥ê¥»¥Ã¥È¤µ¤ì¤¿Ê¸»úÎó¤ËÂФ·¤Æ¡¢½ÐÎϥХåե¡¡¼¤Ë¶õ¤­¤¬¤Ê¤¤¾ì¹ç¡¢
-¤³¤Î´Ø¿ô¤Ï \fIerrno\fP ¤ò \fBE2BIG\fP ¤ËÀßÄꤷ¡¢
-.I (size_t)\ \-1
-¤òÊÖ¤¹¡£
-¤½¤ì°Ê³°¤Î¾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï¡¢½ñ¤­¹þ¤Þ¤ì¤¿¥Ð¥¤¥È¤Î¿ô¤À¤±
-\fI*outbuf\fP ¤òÁý²Ã¤µ¤»¡¢\fI*outbytesleft\fP ¤ò¸º¾¯¤µ¤»¤ë¡£
+別のケースとしては、 「\fIinbuf\fP が NULL、または \fI*inbuf\fP が NULL である。 しかし、\fIoutbuf\fP が NULL
+でなく、かつ \fI*outbuf\fP が NULL でない」 という場合がある。 この場合、 \fBiconv\fP()  関数は、\fIcd\fP
+の変換状態を初期状態にして、 対応するシフト文字列を \fI*outbuf\fP に保存しようとする。 最大 \fI*outbytesleft\fP
+バイトが、\fI*outbuf\fP を始めとして書き出される。 このリセットされた文字列に対して、出力バッファーに空きがない場合、 この関数は
+\fIerrno\fP を \fBE2BIG\fP に設定し、 \fI(size_t)\ \-1\fP を返す。 それ以外の場合、この関数は、書き込まれたバイトの数だけ
+\fI*outbuf\fP を増加させ、\fI*outbytesleft\fP を減少させる。
 .PP
-.\"O A third state is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, and
-.\"O \fIoutbuf\fP is NULL or \fI*outbuf\fP is NULL.
-.\"O In this case, the
-.\"O .BR iconv ()
-.\"O function sets \fIcd\fP's conversion state to the initial state.
-3 ÈÖÌܤΥ±¡¼¥¹¤·¤Æ¤Ï¡¢
-¡Ö\fIinbuf\fP ¤¬ NULL¡¢¤Þ¤¿¤Ï \fI*inbuf\fP ¤¬ NULL ¤Ç¤¢¤ë¡£
-¤«¤Ä¡¢\fIoutbuf\fP ¤¬ NULL¡¢¤Þ¤¿¤Ï \fI*outbuf\fP ¤¬ NULL ¤Ç¤¢¤ë¡×
-¤È¤¤¤¦¾ì¹ç¤¬¤¢¤ë¡£
-¤³¤Î¾ì¹ç¡¢
-.BR iconv ()
-´Ø¿ô¤Ï¡¢\fIcd\fP ¤ÎÊÑ´¹¾õÂÖ¤ò½é´ü¾õÂ֤ˤ¹¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O The
-.\"O .BR iconv ()
-.\"O function returns the number of characters converted in a
-.\"O nonreversible way during this call; reversible conversions are not counted.
-.\"O In case of error, it sets \fIerrno\fP and returns
-.\"O .IR (size_t)\ \-1 .
-.BR iconv ()
-´Ø¿ô¤Ï¡¢¸Æ½Ð¤·¤Î´Ö¤ËÈó²ÄµÕ¤ÊÊýË¡¤ÇÊÑ´¹¤µ¤ì¤¿Ê¸»ú¿ô¤òÊÖ¤¹¡£
-¤Ä¤Þ¤ê¡¢²ÄµÕÊÑ´¹¤Ï¥«¥¦¥ó¥È¤µ¤ì¤Ê¤¤¡£
-¥¨¥é¡¼¤Î¾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï \fIerrno\fP ¤òÀßÄꤷ¡¢
-.I (size_t)\ \-1
-¤òÊÖ¤¹¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.\"O The following errors can occur, among others:
-¾¤Î¤¤¤í¤¤¤í¤Ê¥¨¥é¡¼¤Î¤¦¤Á¤«¤é¡¢°Ê²¼¤Î¥¨¥é¡¼¤¬µ¯¤³¤ê¤¦¤ë¡£
-.TP
-.B E2BIG
-.\"O There is not sufficient room at \fI*outbuf\fP.
-\fI*outbuf\fP ¤Ë½½Ê¬¤Ê¶õ¤­¤¬¤Ê¤¤¡£
-.TP
-.B EILSEQ
-.\"O An invalid multibyte sequence has been encountered in the input.
-ÆþÎϤË̵¸ú¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎ󤬤¢¤Ã¤¿¡£
-.TP
-.B EINVAL
-.\"O An incomplete multibyte sequence has been encountered in the input.
-ÆþÎϤËÉÔ´°Á´¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎ󤬤¢¤Ã¤¿¡£
-.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
-.\"O This function is available in glibc since version 2.1.
-¤³¤Î´Ø¿ô¤Ï¥Ð¡¼¥¸¥ç¥ó 2.1 °Ê¹ß¤Î glibc ¤ÇÍøÍѲÄǽ¤Ç¤¢¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-POSIX.1-2001.
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR iconv_close (3),
-.BR iconv_open (3)
+3 番目のケースしては、 「\fIinbuf\fP が NULL、または \fI*inbuf\fP が NULL である。 かつ、\fIoutbuf\fP が
+NULL、または \fI*outbuf\fP が NULL である」 という場合がある。 この場合、 \fBiconv\fP()  関数は、\fIcd\fP
+の変換状態を初期状態にする。
+.SH 返り値
+\fBiconv\fP()  関数は、呼出しの間に非可逆な方法で変換された文字数を返す。 つまり、可逆変換はカウントされない。 エラーの場合、この関数は
+\fIerrno\fP を設定し、 \fI(size_t)\ \-1\fP を返す。
+.SH エラー
+他のいろいろなエラーのうちから、以下のエラーが起こりうる。
+.TP 
+\fBE2BIG\fP
+\fI*outbuf\fP に十分な空きがない。
+.TP 
+\fBEILSEQ\fP
+入力に無効なマルチバイト文字列があった。
+.TP 
+\fBEINVAL\fP
+入力に不完全なマルチバイト文字列があった。
+.SH バージョン
+この関数はバージョン 2.1 以降の glibc で利用可能である。
+.SH 準拠
+POSIX.1\-2001.
+.SH 注意
+\fIinbuf\fP と \fIoutbuf\fP は \fIchar\ **\fP 型だが、これらの変数が指す
+オブジェクトが C の文字列、つまり文字の配列として解釈されることを意味
+するわけではない。文字バイトシーケンスの解釈は変換関数の内部で行われる。
+エンコーディングによっては、バイト 0 もマルチバイト文字の有効な
+構成要素の場合がある。
+
+\fBiconv\fP() の呼び出し元は、 \fBiconv\fP() に渡すポインタが、
+必要な文字集合の文字にアクセスするのに適したものとなっていることを
+保証しなければならない。これには、アライメントに関して厳しい制限が
+あるプラットフォームにおいて正しいアライメントになっていることを
+保証するといったことも含まれる。
+.SH 関連項目
+\fBiconv_close\fP(3), \fBiconv_open\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。