cgets
Nach oben zu Conio.h - Index
Header-Datei
conio.h
Kategorie
Konsolen-Ein-/Ausgaberoutinen
Prototyp
char *cgets(char *str);
Beschreibung
Liest einen String von der Konsole.
cgets liest einen String von Zeichen von der Konsole und speichert den String (sowie die String-Länge) an dem Speicherort, auf den str zeigt.
cgets liest solange Zeichen ein, bis die Zeichenkombination Wagenrücklauf/Zeilenvorschub (CR/LF) auftritt oder die maximal zulässige Anzahl von Zeichen eingelesen wurde. Beim Einlesen ersetzt cgets die CR/LF-Kombination durch die Zeichenkombination \0 (Nullterminator), bevor der String gespeichert wird.
Weisen Sie str[0] vor dem Aufruf von cgets die maximale Länge des einzulesenden Strings zu. Nach Abschluss der Leseoperation wird str[1] die Anzahl der tatsächlich gelesenen Zeichen zugewiesen. Der Lesevorgang beginnt mit dem Zeichen an der Position str[2] und endet mit dem Nullterminator. Folglich muss str mindestens str[0] plus 2 Byte lang sein.
Hinweis: Verwenden Sie diese Funktion auf keinen Fall in Win32-GUI-Anwendungen.
Rückgabewert
Nach erfolgreicher Ausführung gibt cgets einen Zeiger auf str[2] zurück.
Beispiel
#include <stdio.h>
#include <conio.h>
int main(void)
{
char buffer[83];
char *p;
/* There is space for 80 characters plus the NULL terminator */
buffer[0] = 81;
printf("Input some chars:");
p = cgets(buffer);
printf("\ncgets read %d characters: \"%s\"\n", buffer[1], p);
printf("The returned pointer is %p, buffer[0] is at %p\n", p, &buffer);
/* Leave room for 5 characters plus the NULL terminator */
buffer[0] = 6;
printf("Input some chars:");
p = cgets(buffer);
printf("\ncgets read %d characters: \"%s\"\n", buffer[1], p);
printf("The returned pointer is %p, buffer[0] is at %p\n", p, &buffer);
return 0;
}
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ |
---|---|---|---|
+ |