gets, _getws

Nach oben zu stdio.h - Index

Header-Datei

stdio.h

Kategorie

Konsolen-Ein-/Ausgaberoutinen

Prototyp

char *gets(char *s);

wchar_t *_getws(wchar_t *s); // Unicode-Version

Beschreibung

Liest einen String aus stdin.

gets liest einen durch ein Zeilenvorschubzeichen terminierten String aus dem Standardeingabe-Stream stdin und speichert ihn in s. Das Zeilenvorschubzeichen wird in s durch ein Null-Zeichen (\0) ersetzt.

Der Eingabestring kann bestimmte Whitespace-Zeichen enthalten (Leerzeichen, Tabulatorzeichen). gets kehrt zurück, wenn ein Zeilenvorschubzeichen angetroffen wird; alles bis zu diesem Zeichen wird nach s kopiert.

Die Länge des von gets gelesenen Strings ist nicht beschränkt. Ist der gelesene String ausreichend lang, können Daten überschrieben und zerstört werden. Die Funktion fgets bietet eine bessere Kontrolle über die Eingabestrings.

Anmerkung:  Für Win32-GUI-Anwendungen muss stdin umgeleitet werden.

Rückgabewert

Bei erfolgreicher Ausführung gibt gets den als Parameter angegebenen String s zurück.

Wurde das Dateiende erreicht oder trat ein Fehler auf, wird NULL zurückgegeben.

Beispiel

 #include <stdio.h>
 int main(void)
 {
    char string[80];
    printf("Input a string:");
    gets(string);
    printf("The string input was: %s\n", string);
    return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
gets	+	+	+	+
_getws		+