iconv_open_into |
iconv : Ouvrir dans |
|---|---|
| libiconv | iconv.h |
Syntaxe
| int iconv_open_into(const char* tocode, const char* fromcode, iconv_allocation_t* resultp); |
Paramètres
| Nom | Description |
|---|---|
| tocode | Ce paramètre permet d'indiquer une chaîne de caractères spécifiant l'encodage de destination (par exemple "UTF-8"). |
| fromcode | Ce paramètre permet d'indiquer une chaîne de caractères spécifiant l'encodage source (par exemple "ISO-8859-1"). |
| resultp | Ce paramètre permet d'indiquer un pointeur vers une structure de type iconv_allocation_t, permettant de gérer l'allocation mémoire personnalisée pour la conversion. |
Retour
La fonction iconv_open_into remplit *resultp et renvoie 0 en cas de réussite. En cas d'erreur, elle définit errno et renvoie -1.
Description
Cette fonction permet d'initialiser le descripteur pour la conversion de l'ensemble de caractères.
Remarques
- La fonction iconv_open_into initialise un descripteur de conversion permettant de convertir des séquences d'octets du codage de caractères fromcode vers le codage de caractères tocode. Ce descripteur est entreposé dans la mémoire pointée par resultp.
- Les valeurs autorisées pour fromcode et tocode sont les mêmes que pour la fonction iconv_open.
- Après un retour réussi de cette fonction, resultp peut être utilisé comme objet iconv_t avec la fonction iconv.
Erreurs
L'erreur suivante peut notamment se produire :
| Constante | Description |
|---|---|
| EINVAL | La conversion de fromcode vers tocode n'est pas prise en charge par l'implémentation. |
Conformité
Cette fonction est implémentée uniquement dans GNU libiconv et non dans les autres implémentations d'iconv. Elle n'est soutenue par aucune norme. Vous pouvez tester sa présence via (_LIBICONV_VERSION >= 0x010D).
Voir également
iconv_open, iconv
Dernière mise à jour : Mardi, le 25 mars 2025