OSDN Git Service

Retire LDP man-pages repository
[linuxjm/LDP_man-pages.git] / draft / man3 / iconv_open.3
diff --git a/draft/man3/iconv_open.3 b/draft/man3/iconv_open.3
deleted file mode 100644 (file)
index e0b8583..0000000
+++ /dev/null
@@ -1,77 +0,0 @@
-.\" 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
-.\"
-.\" 2007-03-31 Bruno Haible, Describe the glibc/libiconv //TRANSLIT
-.\" and //IGNORE extensions for 'tocode'.
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\"
-.\" 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
-.\"
-.TH ICONV_OPEN 3 2008\-08\-11 GNU "Linux Programmer's Manual"
-.SH 名前
-iconv_open \- 文字セット変換のためのディスクリプターを割り当てる
-.SH 書式
-.nf
-\fB#include <iconv.h>\fP
-.sp
-\fBiconv_t iconv_open(const char *\fP\fItocode\fP\fB, const char *\fP\fIfromcode\fP\fB);\fP
-.fi
-.SH 説明
-\fBiconv_open\fP()  関数は、文字エンコーディング \fIfromcode\fP から 文字エンコーディング \fItocode\fP
-へのバイト文字列変換に適した 変換ディスクリプターを割り当てる。
-.PP
-\fIfromcode\fP と \fItocode\fP に使うことのできる値と、 サポートされる組み合わせは、システムに依存する。 GNU C
-ライブラリでは、使うことのできる値は \fIiconv \-\-list\fP コマンドでリストされ、 リストされたすべての値の組み合わせがサポートされる。
-さらに、 GNU C ライブラリと GNU libiconv ライブラリでは、 以下の接尾辞がサポートされている。
-.TP 
-//TRANSLIT
-\fItocode\fP の後ろに文字列 "//TRANSLIT" が付いている場合、 翻訳 (transliteration) が有効になる。この場合、
-変換先の文字セットで表現できない文字を、その文字と同じように見える 文字 (複数文字の場合もある) で表現することができる。
-.TP 
-//IGNORE
-\fItocode\fP の後ろに文字列 "//IGNORE" が付いている場合、 変換先の文字セットで表現できない文字は黙って無視される。
-.PP
-この関数を読んで得られた変換ディスクリプターは、 \fBiconv\fP(3)  で 何度でも使うことができる。 これは \fBiconv_close\fP(3)
-を使って解放されるまで有効である。
-.PP
-変換ディスクリプターは変換状態を持つ。 \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.79 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。