catgets(3C)                                                     catgets(3C)

NAME
     catgets - Programmeldung lesen

SYNTAX
     #include <nltypes.h>

     char *catgets(nlcatd catd, int setnum, int msgnum, const char *s);

BESCHREIBUNG
     catgets() versucht, die Meldung msgnum aus der Menge setnum aus dem
     Meldungskatalog catd zu lesen. catd ist ein Verzeichnisdeskriptor, der
     von einem vorherigen Aufruf von catopen() zurückgegeben wird. s zeigt
     auf eine voreingestellte Meldungszeichenkette, welche durch catgets()
     zurückgeliefert wird, wenn die Funktion fehlschlägt.

ERGEBNIS
     Wenn die angegebene Meldung erfolgreich gelesen werden kann, liefert
     catgets() einen Zeiger auf einen internen Pufferbereich, der die Mel-
     dungszeichenkette mit Endenull enthält. Ist der Aufruf nicht erfolg-
     reich, weil der Meldungskatalog catd momentan nicht verfügbar ist,
     wird ein Zeiger auf s zurückgeliefert und möglicherweise wird errno
     gesetzt, um den Fehler anzuzeigen.

FEHLER
     Die folgenden Beschreibungen der Fehlercodes sind funktionsspezifisch.
     Eine allgemeingültige Beschreibung finden Sie in introprm2(2) bzw. in
     errno(5).

     Die Funktion catgets() kann bei einer der folgenden Bedingungen fehl-
     schlagen:

     EBADF     Das Argument catd ist kein gültiger Deskriptor für den Mel-
               dungskatalog, der zum Lesen geöffnet ist.

     EINTR     Die Leseoperation wurde aufgrund eines empfangenen Signals
               beendet, und es wurden keine Daten übertragen.

     EINVAL    Der durch catd angegebene Meldungskatalog ist beschädigt.

     ENOMSG    Die durch setnum und msgnum angegebene Meldung ist im Mel-
               dungskatalog nicht enthalten.

SIEHE AUCH
     catclose(3C), catopen(3C), nltypes(5).











Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98