1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
.\" Copyright (c) Bruno Haible <haible@clisp.cons.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 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
.\"
.\" 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
.\"
.\"WORD: conversion Ѵ
.\"WORD: descriptor ǥץ
.\"WORD: sequence ʸ
.\"WORD:
.\"
.TH ICONV 3 2008-09-08 "GNU" "Linux Programmer's Manual"
.SH ̾
iconv \- ʸåѴԤ
.SH
.nf
.B #include <iconv.h>
.sp
.BI "size_t iconv(iconv_t " cd ,
.BI " char **" inbuf ", size_t *" inbytesleft ,
.BI " char **" outbuf ", size_t *" outbytesleft );
.fi
.SH
\fIcd\fP ϡؿ
.BR iconv_open (3)
Ȥä
ѴǥץǤʤФʤʤ
.PP
˻ȤΤϡ
\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
.BR iconv ()
ؿ 1 ٤ 1 ĤΥޥХʸѴ롣
ơʸѴˡѴ줿ϥХȤο
\fI*inbuf\fP ä\fI*inbytesleft\fP 롣
ޤѴ줿ϥХȤο
\fI*outbuf\fP ä\fI*outbytesleft\fP 롣
ˡ\fIcd\fP ˴ޤޤѴ֤롣
Ϥʸǥ֤ľ硢
.BR iconv ()
ؿϥХȤФѴˤбƤꡢ
ХȽϤȼ鷺Ѵ֤뤳ȤǤ롣
Ѵϡ 4 Ĥξߤ롣
.PP
1. Ϥ̵ʥޥХʸä硣
ξ硢ؿ \fIerrno\fP \fBEILSEQ\fP ꤷ
.I (size_t)\ \-1
֤
\fI*inbuf\fP ϡ̵ʥޥХʸƬؤޤޤˤʤ롣
.PP
2. ϥХʸѴ졢\fI*inbytesleft\fP 0 ˤʤä硣
ξ硢
.BR iconv ()
ϡƽФδ֤ĵѴԤ줿֤
.PP
3. ϤԴʥޥХʸꡢ
ϥХʸθǽλƤ硣
ξ硢ؿϡ\fIerrno\fP \fBEINVAL\fP ꤷ
.I (size_t)\ \-1
֤
\fI*inbuf\fP ϡԴʥޥХʸƬؤޤޤˤ롣
.PP
4. ϥХåե˼Ѵ줿ʸΤζʤ硣
ξ硢\fIerrno\fP \fBE2BIG\fP ꤵ졢
.I (size_t)\ \-1
֤롣
.PP
̤ΥȤƤϡ
\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 롣
.PP
3 ܤΥƤϡ
\fIinbuf\fP NULLޤ \fI*inbuf\fP NULL Ǥ롣
ġ\fIoutbuf\fP NULLޤ \fI*outbuf\fP NULL Ǥ
Ȥ礬롣
ξ硢
.BR iconv ()
ؿϡ\fIcd\fP Ѵ֤֤ˤ롣
.SH ֤
.BR iconv ()
ؿϡƽФδ֤ĵդˡѴ줿ʸ֤
ĤޤꡢĵѴϥȤʤ
顼ξ硢δؿ \fIerrno\fP ꤷ
.I (size_t)\ \-1
֤
.SH 顼
¾Τʥ顼Τ顢ʲΥ顼ꤦ롣
.TP
.B E2BIG
\fI*outbuf\fP ˽ʬʶʤ
.TP
.B EILSEQ
Ϥ̵ʥޥХʸä
.TP
.B EINVAL
ϤԴʥޥХʸä
.SH С
δؿϥС 2.1 ʹߤ glibc ѲǽǤ롣
.SH
POSIX.1-2001.
.SH Ϣ
.BR iconv_close (3),
.BR iconv_open (3)
|
