cscanf

Nach oben zu conio.h - Index

Header-Datei

conio.h

Kategorie

Konsolen-Ein-/Ausgaberoutinen

Prototyp

int cscanf(char *format[, address, ...]);

Beschreibung

Liest Eingaben von der Konsole ein und formatiert diese.

cscanf liest direkt von der Konsole aus einer Reihe von Eingabefeldern Zeichen für Zeichen ein. Dann wird jedes Feld entsprechend dem Formatbezeichner formatiert, der cscanf in dem durch den Zeiger format bezeichneten Format-String übergeben wird. Schließlich speichert cscanf die formatierte Eingabe an der durch das Argument address bezeichneten Speicheradresse und zeigt die Eingabe auf dem Bildschirm an. Es müssen ebenso viele Formatbezeichner und Adressen wie Eingabefelder gegeben sein.

Anmerkung:  Nähere Informationen zu Formatbezeichnern finden Sie unter "scanf Formatbezeichner".

Aus verschiedenen Gründen kann cscanf mit dem Einlesen eines bestimmten Feldes aufhören, bevor das normale Feldendezeichen (Leerraum) erreicht wurde, oder insgesamt beendet werden. Eine Beschreibung der möglichen Ursachen hierfür finden Sie unter "scanf".

Anmerkung:  Verwenden Sie diese Funktion auf keinen Fall in Win32-GUI-Anwendungen.

Rückgabewert

cscanf gibt die Anzahl der Eingabefelder zurück, die erfolgreich eingelesen, konvertiert und gespeichert wurden. Der Rückgabewert beinhaltet keine Felder, die eingelesen, aber nicht gespeichert wurden. Wenn keine Felder gespeichert wurden, ist der Rückgabewert 0.

Wenn cscanf über das Dateiende hinaus zu lesen versucht, wird EOF zurückgegeben.

Beispiel

 #include <conio.h>
 int main(void)
 {
    char string[80];
    /* Bildschirminhalt löschen */
    clrscr();
    /* Benutzer zu einer Eingabe auffordern */
    cprintf("Enter a string with no spaces:");
    /* Eingabe lesen */
    cscanf("%s", string);
    /* Anzeigen, was gelesen wurde */
    cprintf("\r\nThe string entered is: %s", string);
    return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+