CStdioFile::ReadString

Liest Textdaten in einen Puffer, bis zu einer Tiefe von nMax- Zeichen 1, aus der Datei, die mit dem CStdioFile-Objekt zugeordnet ist.

virtual LPTSTR ReadString(
   LPTSTR lpsz,
   UINT nMax 
);
virtual BOOL ReadString(
   CString& rString
);

Parameter

  • lpsz
    Gibt einen Zeiger auf einen vom Benutzer bereitgestellten Puffer an, der eine auf NULL endende Textzeichenfolge empfängt.

  • nMax
    Gibt die maximale Anzahl von Zeichen an, die zum Lesen und nicht zählt das NULL.

  • rString
    Ein Verweis auf einen CString-Objekt, das die Zeichenfolge enthält, wenn die Funktion zurückgibt.

Rückgabewert

Ein Zeiger auf den Puffer, der die Textdaten enthält.NULL, wenn Dateiende erreicht wurde, ohne Daten zu lesen, oder wenn boolescher Wert, FALSE, wenn Dateiende erreicht wurde, ohne Daten zu lesen.

Hinweise

Lesen werden das erste Zeilenendemarke kurz aufgehalten bei.Wenn, in diesem Fall, nMax- weniger als 1 Zeichen sind, ein Zeilenumbruchzeichen gespeichert wird im Puffer gelesen wurde.Ein NULL-Zeichen ("\ 0 ") wird in jedem Fall angefügt.

CFile::Read ist auch für Textmoduseingabe verfügbar, aber sie endet nicht auf einem Wagenrücklauf/Zeilenvorschub-Paar.

HinweisHinweis

Die CString-Version dieser Funktion entfernt '\n', falls vorhanden die LPTSTR-Version jedoch nicht.

Beispiel

CStdioFile f(stdin);
TCHAR buf[100];

f.ReadString(buf, 99);

Anforderungen

Header: afx.h

Siehe auch

Referenz

CStdioFile-Klasse

Hierarchien-Diagramm

CStdioFile::WriteString

CFile::Read