gets, gets_s

 

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

 

Datei-Ein-/Ausgabe

Typen und Objekte
stdinstdoutstderr          FILE fpos_t
Funktionen Datei-Zugriff fopenfopen_s (C11) freopenfreopen_s (C11)   fwide (C95) setbuf setvbuf fclose fflush Unformatierte Ein-/Ausgabe fgetc fgets fputc fputs getchar getsgets_s (bis C11)(C11) putchar puts ungetc fgetwcgetwc (C95)(C95) fgetws (C95) fputwcputwc (C95)(C95) fputws (C95) getwchar (C95) putwchar (C95) ungetwc (C95) Formatierte Eingabe scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11) wscanffwscanfswscanfwscanf_sfwscanf_sswscanf_s (C95)(C95)(C95)(C11)(C11)(C11) vscanfvfscanfvsscanfvscanf_svfscanf_svsscanf_s (C99)(C99)(C99)(C11)(C11)(C11) vwscanfvfwscanfvswscanfvwscanf_svfwscanf_svswscanf_s (C99)(C99)(C99)(C11)(C11)(C11)	Direkte Ein-/Ausgabe fread fwrite Formatierte Ausgabe printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11) wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11)   vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (C99)(C11)(C11)(C11)(C11) vwprintfvfwprintfvswprintfvwprintf_svfwprintf_svswprintf_svsnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11) Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove tmpfiletmpfile_s (C11) rename tmpnamtmpnam_s (C11)

 

Definiert in Header <stdio.h>
char* gets( char* str );	(1)	(entfernt in C11)
char* gets_s( char* str, rsize_t n );	(2)	(seit C11)

1) Liest von stdin in das von str gezeigte Zeichenarray, bis ein Zeilenumbruchzeichen gefunden wird oder das Ende der Datei erreicht ist. Ein Nullzeichen wird unmittelbar nach dem letzten in das Array gelesenen Zeichen geschrieben. Das Zeilenumbruchzeichen wird verworfen, aber nicht in den Puffer geschrieben.

2) Liest Zeichen von stdin, bis ein Zeilenumbruch gefunden wird oder das Ende der Datei erreicht ist. Schreibt höchstens n - 1 Zeichen in das von str gezeigte Array und schreibt immer das abschließende Nullzeichen (es sei denn, str ist ein Nullzeiger). Das Zeilenumbruchzeichen, falls gefunden, wird verworfen und zählt nicht zur Anzahl der in den Puffer geschriebenen Zeichen.

Die folgenden Fehler werden zur Laufzeit erkannt und rufen die aktuell installierte Constraint-Handler-Funktion auf

• n ist null;
• n ist größer als RSIZE_MAX;
• str ist ein Nullzeiger;
• Zeilenumbruch oder EOF nicht angetroffen nach dem Speichern von n - 1 Zeichen im Puffer.

In jedem Fall liest gets_s zuerst die Zeichen von stdin bis zum Zeilenumbruchzeichen, dem Dateiende oder einem Lesefehler, verwirft sie und ruft dann den Constraint-Handler auf.

Wie bei allen grenzgeprüften Funktionen ist gets_s nur dann garantiert verfügbar, wenn __STDC_LIB_EXT1__ von der Implementierung definiert ist und wenn der Benutzer __STDC_WANT_LIB_EXT1__ vor dem Einbinden von <stdio.h> auf die ganzzahlige Konstante 1 setzt.

Parameter

str	-	ein Zeichenarray, in das die Zeichen von stdin geschrieben werden sollen
n	-	maximale Anzahl von Zeichen, die in das von str gezeigte Array geschrieben werden können

Rückgabewert

str bei Erfolg, ein Nullzeiger bei Fehler.

Wenn der Fehler durch das Ende der Datei verursacht wurde, wird zusätzlich der eof-Indikator (siehe feof()) für stdin gesetzt. Wenn der Fehler durch einen anderen Fehler verursacht wurde, wird der error-Indikator (siehe ferror()) für stdin gesetzt.

Hinweise

Die Funktion gets() führt keine Grenzenprüfung durch, daher ist diese Funktion extrem anfällig für Pufferüberlaufangriffe. Sie kann nicht sicher verwendet werden (es sei denn, das Programm läuft in einer Umgebung, die einschränkt, was auf stdin erscheinen kann). Aus diesem Grund wurde die Funktion im dritten Korrigendum zum C99-Standard als veraltet markiert und im C11-Standard vollständig entfernt. fgets() und gets_s() sind die empfohlenen Ersatzfunktionen.

WARNUNG: Verwenden Sie niemals gets().

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• K.3.5.4.1 Die Funktion gets_s (S. TBD)

• C17-Standard (ISO/IEC 9899:2018)

• K.3.5.4.1 Die Funktion gets_s (S. TBD)

• C11-Standard (ISO/IEC 9899:2011)

• K.3.5.4.1 Die Funktion gets_s (S. 602-603)

• C99-Standard (ISO/IEC 9899:1999)

• 7.19.7.7 Die Funktion gets (S. 298)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.9.7.7 Die Funktion gets

Siehe auch

scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11)	liest formatierte Eingaben aus stdin, einem Dateistream oder einem Puffer (Funktion)
fgets	liest einen Zeichenstring aus einem Dateistream (Funktion)
fputs	schreibt einen Zeichenstring in einen Dateistream (Funktion)
getlinegetwlinegetdelimgetwdelim (Dynamischer Speicher-TR)	liest von einem Stream in einen automatisch skalierten Puffer bis zum Trennzeichen/Zeilenende (Funktion)
C++ Dokumentation für gets