CStdioFile::ReadString

Odczytuje dane tekstowe do bufora, do limitu nMax–1 znaków z pliku skojarzone z CStdioFile obiektu.

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

Parametry

  • lpsz
    Określa wskaźnik do buforu dostarczone przez użytkownika, który będzie odbierał ciąg zakończony znakiem null.

  • nMax
    Określa maksymalną liczbę znaków do odczytu, nie licząc kończącego znaku null.

  • rString
    Odwołanie do CString obiekt, który będzie zawierać ciąg, gdy funkcja zwraca.

Wartość zwracana

Wskaźnik bufor zawierający dane tekstowe.NULL , jeżeli osiągnięto koniec pliku bez czytania żadnych danych; lub jeśli jest to wartość logiczna, FALSE , jeżeli osiągnięto koniec pliku bez odczytywania danych.

Uwagi

Odczyt jest zatrzymana przez pierwszy znak nowego wiersza.Jeżeli w tym przypadku mniej niż nMaxzostały odczytane znaki –1, znak nowego wiersza jest przechowywane w buforze.Znak null (\0) jest dołączany w każdym przypadku.

CFile::Read jest również dostępna dla wprowadzania w trybie tekstowym, ale nie kończy się na parę ze zmianą wiersza przewozu.

[!UWAGA]

CString Wersja tej funkcji usuwa '\n' Jeśli obecne; LPTSTR nie obsługuje wersji.

Przykład

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

f.ReadString(buf, 99);

Wymagania

Nagłówek: afx.h

Zobacz też

Informacje

Klasa CStdioFile

Diagram hierarchii

CStdioFile::WriteString

CFile::Read