iconv_open(3C)                                               iconv_open(3C)

NAME
     iconvopen - Zuweisungen für die Code-Umwandlung

SYNTAX
     #include <iconv.h>

     iconvt iconvopen(const char *tocode, const char *fromcode);

BESCHREIBUNG
     Die Funktion iconvopen() gibt einen Umwandlungsdeskriptor zurück, der
     eine Umwandlung beschreibt. Diese Umwandlung erfolgt von dem Zeichen-
     satz, der mit der Zeichenkette angegeben ist, auf die das Argument
     fromcode zeigt,  in den Zeichensatz, der mit der Zeichenkette angege-
     ben ist, auf die das Argument tocode zeigt. Bei statusabhängigen
     Codierungen befindet sich der Umwandlungsdeskriptor in einem ursprüng-
     lichen, vom Zeichensatz abhängigen Shift-Status. Er kann unmittelbar
     für die Funktion iconv() verwendet werden.

     Die Einstellungen von fromcode und tocode sowie die zulässigen Kombi-
     nationen sind von der jeweiligen Implementation abhängig.

     Ein Umwandlungsdeskriptor bleibt in einem Prozeß gültig, bis er von
     diesem Prozeß geschlossen wird.

     Wird ein Dateideskriptor zur Implementierung von Umwandlungsdeskripto-
     ren verwendet, so wird das Flag FDCLOEXEC gesetzt.

     iconvopen() verwendet die Funktion malloc() zur Zuweisung von Spei-
     cherplatz für interne Pufferbereiche. Die Funktion iconvopen()
     schlägt fehl, wenn für diese Puffer nicht genügend Speicherplatz zur
     Verfügung steht.

     Portierbare Anwendungen müssen davon ausgehen, daß Umwandlungsdeskrip-
     toren nach einem Aufruf einer der Funktionen exec ungültig sind.

     Die Funktion iconvopen() schlägt fehl, wenn:

     EMFILE    Im aufrufenden Prozeß sind derzeit OPENMAX Dateideskripto-
               ren geöffnet.

     ENFILE    Derzeit sind zu viele Dateien im System geöffnet.

     ENOMEM    Es steht nicht genügend Speicher zur Verfügung.

     EINVAL    Die durch fromcode und tocode angegebene Umwandlung wird
               nicht von der Implementation unterstützt.

ERGEBNIS
     Nach erfolgreicher Beendigung gibt iconvopen() einen Umwandlungsde-
     skriptor zurück, der für spätere Aufrufe von iconv() verwendet werden
     kann. Andernfalls gibt iconvopen() (iconvt)-1 zurück. errno wird auf
     den Fehler gesetzt.



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

iconv_open(3C)                                               iconv_open(3C)

SIEHE AUCH
     iconv(3C), iconvclose(3C).




















































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98