iconv_open - Deskriptor für Zeichenumwandlung erzeugen

Definition	#include <iconv.h> iconv_t iconv_open(const char *tocode, const char *fromcode);
Beschreibung	iconv_open() gibt einen Umwandlungsdeskriptor zurück, der eine Umwandlung beschreibt. Diese Umwandlung erfolgt von dem Zeichensatz, auf den das Argument fromcode zeigt, in den Zeichensatz, auf den das Argument tocode zeigt. Bei statusabhängigen Codierungen befindet sich der Umwandlungsdeskriptor in einem ursprünglichen, vom Zeichensatz abhängigen Shift-Status. Er kann unmittelbar für die Funktion iconv() verwendet werden. Ein Umwandlungsdeskriptor bleibt in einem Prozess gültig, bis er von diesem Prozess geschlossen wird. iconv_open() verwendet die Funktion malloc() zur Zuweisung von Speicherplatz für interne Pufferbereiche. Die Funktion iconv_open() schlägt fehl, wenn für diese Puffer nicht genügend Speicherplatz zur Verfügung steht.
Returnwert	Umwandlungsdeskriptor
		der für spätere Aufrufe von iconv() verwendet werden kann, bei Erfolg.
	(iconv_t)-1	bei Fehler. errno wird gesetzt, um den Fehler anzuzeigen.
Fehler	iconv_open() schlägt fehl, wenn gilt:
	EMFILE	Im aufrufenden Prozess sind derzeit {OPEN_MAX}-Dateideskriptoren geöffnet.
	ENFILE ENOMEM EINVAL	Derzeit sind zu viele Dateien im System geöffnet. Es steht nicht genügend Speicher zur Verfügung. Die durch fromcode und tocode angegebene Umwandlung wird nicht von dieser Version unterstützt.

Siehe auch iconv(), iconv_close(), iconv.h.