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
|
.\" 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
.\"
.\" Traduction 31/08/2000 par Christophe Blaess (ccb@club-internet.fr)
.\" LDP 1.31
.TH ICONV_OPEN 3 "31 Aot 2000" "GNU" "Manuel du programmeur Linux"
.SH NOM
iconv_open \- Allouer un descripteur pour une conversion de jeux de caractres.
.SH SYNOPSIS
.nf
.B #include <iconv.h>
.sp
.BI "iconv_t iconv_open (const char* " tocode ", const char* " fromcode );
.fi
.SH DESCRIPTION
La fonction \fBiconv_open\fP alloue un descripteur de conversion adapt la transformation
d'une squence d'octets depuis le codage de caractres \fIfromcode\fP dans le codage
\fItocode\fP.
.PP
Les valeurs autorises pour \fIfromcode\fP et \fItocode\fP et leurs combinaisons acceptes
dpendent du systme. Pour la bibliothque C GNU, les valeurs permises sont fournies par
la commande \fBiconv --list\fP et toutes les combinaisons de ces valeurs sont supportes.
[NDT] Apparement ce n'est pas toujours vrai, puisque cette commande \fBiconv --list\fP
affiche le commentaire suivant :
La liste suivante contient tous les jeux des codes de caractres connus. Ceci
ne signifie pas ncessairement que toutes les combinaisons de ces noms peuvent
tre utilises dans les paramtres FROM et TO des commandes[...]
.PP
Le descripteur de conversion fourni peut tre utilis autant de fois que voulu avec
\fBiconv\fP. Il reste valide jusqu' sa libration avec \fBiconv_close\fP.
.PP
Un descripteur contient un tat de conversion. Lors de sa cration avec
\fBiconv_open\fP, il se trouve dans l'tat initial. L'utilisation de \fBiconv\fP
modifie l'tat du descripteur. On ne doit donc pas utiliser simultanment un descripteur
de conversion dans plusieurs threads. Pour revenir l'tat initial, on peut employer
\fBiconv\fP avec un argument \fIinbuf\fP NULL.
.SH "VALEUR RENVOYE"
La fonction \fBiconv_open\fP renvoie un nouveau descripteur de conversion. En cas d'erreur,
elle remplit \fBerrno\fP et renvoie (iconv_t)(-1).
.SH ERREURS
Les erreurs suivantes peuvent - entre autres - se prsenter :
.TP
.B EINVAL
La conversion depuis \fIfromcode\fP vers \fItocode\fP n'est pas supporte par l'implmentation.
.SH "CONFORMIT "
UNIX98
.SH "VOIR AUSSI"
.BR iconv (3),
.BR iconv_close (3),
.BR iconv (1)
.SH TRADUCTION
Christophe Blaess, 2000.
|
