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
|
.\" 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 Tue Jul 11 19:02:58 JST 2000
.\" by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
.\"
.\"WORD: conversion Ѵ
.\"WORD: descriptor ǥץ
.\"WORD: sequence ʸ
.\"WORD:
.\"
.TH ICONV 3 2001-11-15 "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 ϡؿ \fBiconv_open\fP Ȥä
ѴǥץǤʤФʤʤ
.PP
˻ȤΤϡ
\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
\fBiconv\fP ؿ 1 ٤ 1 ĤΥޥХʸѴ롣
ơʸѴˡѴ줿ϥХȤο
\fI*inbuf\fP ä\fI*inbytesleft\fP 롣
ޤѴ줿ϥХȤο
\fI*outbuf\fP ä\fI*outbytesleft\fP 롣
ˡ\fIcd\fP ˴ޤޤѴ֤롣
Ѵϡ 4 Ĥξߤ롣
.PP
1. Ϥ̵ʥޥХʸä硣
ξ硢ؿ \fBerrno\fP \fBEILSEQ\fP ꤷ(size_t)(-1) ֤
\fI*inbuf\fP ϡ̵ʥޥХʸƬؤޤޤˤʤ롣
.PP
2. ϥХʸѴ졢\fI*inbytesleft\fP 0 ˤʤä硣
ξ硢\fBiconv\fP ϡƽФδ֤ĵѴԤ줿֤
.PP
3. ϤԴʥޥХʸꡢ
ϥХʸθǽλƤ硣
ξ硢ؿϡ\fBerrno\fP \fBEINVAL\fP ꤷ(size_t)(-1) ֤
\fI*inbuf\fP ϡԴʥޥХʸƬؤޤޤˤ롣
.PP
4. ϥХåե˼Ѵ줿ʸΤζʤ硣
ξ硢\fBerrno\fP \fBE2BIG\fP ꤵ졢(size_t)(-1) ֤롣
.PP
̤ΥȤƤϡ
\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 ϤȤƽФ롣
ΥꥻåȤ줿ʸФơϥХåե˶ʤ硢
δؿ \fBerrno\fP \fBE2BIG\fP ꤷ(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 Ǥ
Ȥ礬롣
ξ硢\fBiconv\fP ؿϡ\fIcd\fP Ѵ֤֤ˤ롣
.SH ֤
\fBiconv\fP ؿϡƽФδ֤ĵդˡѴ줿ʸ֤
ĤޤꡢĵѴϥȤʤ
顼ξ硢δؿ \fBerrno\fP ꤷ(iconv_t)(-1) ֤
.SH 顼
¾Τʥ顼Τ顢ʲΥ顼ꤦ롣
.TP
.B E2BIG
\fI*outbuf\fP ˽ʬʶʤ
.TP
.B EILSEQ
Ϥ̵ʥޥХʸä
.TP
.B EINVAL
ϤԴʥޥХʸä
.SH
UNIX98
.SH Ϣ
.BR iconv_open (3),
.BR iconv_close (3)
|
