getline, getwline, getdelim, getwdelim

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Technische Spezifikationen

Erweiterungen für eingebettete Prozessoren

Erweiterungen für dynamischen Speicher

Gleitkommaerweiterungen Teil 1: Binäre Gleitkommazahlen

Gleitkommaerweiterungen Teil 4: Ergänzende Funktionen

 

Erweiterungen für dynamischen Speicher

fmemopen

open_memstreamopen_wmemstream

asprintfaswprintfvasprintfvaswprintf

getlinegetwlinegetdelimgetwdelim

strdup

strndup

 

Definiert in Header <stdio.h>
ssize_t getline(char **lineptr, size_t *n, FILE *stream);	(1)	(Dynamischer Speicher-TR)
ssize_t getwline(wchar_t **lineptr, size_t *n, FILE *stream);	(2)	(Dynamischer Speicher-TR)
ssize_t getdelim(char ** restrict lineptr, size_t * restrict n,                  int delimiter, FILE *stream);	(3)	(Dynamischer Speicher-TR)
ssize_t getwdelim(wchar_t ** restrict lineptr, size_t * restrict n,                  wint_t delimiter, FILE * stream);	(4)	(Dynamischer Speicher-TR)

1) Entspricht getdelim(lineptr, n, '\n', stream)

2) Entspricht getwdelim(lineptr, n, L'\n', stream)

3) Liest aus dem Stream stream, als ob mit fgetc, bis delimiter angetroffen wird, wobei die Zeichen im Puffer der Größe *n, auf den *lineptr zeigt, gespeichert werden. Die Größe wird automatisch, als ob mit realloc, erhöht, um die gesamte Eingabe, einschließlich des Trennzeichens, aufzunehmen und eine Nullterminierung hinzuzufügen. *lineptr kann null sein, in diesem Fall wird *n ignoriert und getline weist einen neuen Puffer zu, als ob mit malloc. Das Verhalten ist undefiniert, wenn delimiter einen Wert hat, der außerhalb des Bereichs von unsigned char oder EOF liegt.

4) Gleiche wie (3), außer dass die Zeichen gelesen werden, als ob mit fgetwc, und dass delimiter ein gültiges wchar_t oder WEOF sein muss.

Wenn *lineptr nicht null ist, ist das Verhalten undefiniert, wenn *lineptr kein Zeiger ist, der an free übergeben werden kann, oder wenn *n kleiner ist als die Größe des von *lineptr verwiesenen Speicherbereichs.

Wie alle Funktionen aus dem Dynamic Memory TR ist getline nur dann garantiert verfügbar, wenn __STDC_ALLOC_LIB__ von der Implementierung definiert ist und wenn der Benutzer __STDC_WANT_LIB_EXT2__ vor dem Einbinden von stdio.h auf die ganzzahlige Konstante 1 setzt.

Parameter

lineptr	-	Zeiger auf einen Zeiger auf den initialen Puffer oder auf einen Nullzeiger
n	-	Zeiger auf die Größe des initialen Puffers
Trennzeichen	-	das Trennzeichen
stream	-	gültiger Eingabestream, geöffnet mit fopen

Rückgabewert

Die Anzahl der im Puffer gespeicherten Zeichen, einschließlich des Trennzeichens, aber ohne den Nullterminator.

Bei einem Fehler wird -1 zurückgegeben und feof oder ferror für stream gesetzt.

Anmerkungen

Diese Funktionen sind identisch mit ihren POSIX-Versionen, mit der Ausnahme, dass es erlaubt, aber nicht erforderlich ist, errno bei einem Fehler zu setzen.

Beispiel

Führen Sie diesen Code aus

#ifdef __STDC_ALLOC_LIB__
#define __STDC_WANT_LIB_EXT2__ 1
#else
#define _POSIX_C_SOURCE 200809L
#endif
 
#include <stdio.h>
#include <stdlib.h>
void get_y_or_n(void)
{
    char *response = NULL;
    size_t len;
    printf("Continue? [y] n: ");
    if((getline(&response, &len, stdin) < 0) || (len && response[0] == 'n')) {
        free(response);
        exit(0);
    }
    free(response);
    return;
}
int main(void) 
{
    get_y_or_n();
}

Ausgabe

Continue? [y] n:

Siehe auch

fgets	liest einen Zeichenstring aus einem Dateistream (Funktion)
getsgets_s (entfernt in C11)(C11)	liest einen Zeichenstring aus stdin (Funktion)
fgetws (C95)	liest einen Weitzeichenstring aus einem Dateistream (Funktion)
malloc	alloziert Speicher (Funktion)