#include <sys.socket.h>
Kernighan-Ritchie-C:
char *soc_gets(s, n, d);
char *s;
int n, d;
ANSI-C:
char* soc_gets(char* s, int n, int d);
Beschreibung
Die Funktion soc_gets() wird nur in den Adressfamilien AF_INET und AF_INET6 unterstützt und kann nur auf Stream-Sockets angewendet werden.
Die Funktion soc_gets() liest einen Character-String, bestehend aus den ersten maximal n-1 Zeichen des Eingabepuffers von Socket d, in den Puffer s. Gelesen wird maximal bis zum ersten Zeilenwechsel (dargestellt durch die Sequenz 0x15 in EBCDIC) oder bis zum Ende des Eingabepuffers von Socket d oder dem Erreichen von n-1 Zeichen. Der im Puffer s zurückgelieferte Character-String wird durch das Null-Byte terminiert.
Returnwert
Zeiger auf den Ergebnisstring:
bei Erfolg.
Null-Zeiger:
Bei Lesefehler.
Fehleranzeige durch errno
EWOULDBLOCK
Der Socket ist als nicht-blockierend markiert, und die geforderte Operation würde blockieren.