Share via


CArchive::ReadString

Call this member function to read text data into a buffer from the file associated with the CArchive object.

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

Parameters

  • rString
    A reference to a CString that will contain the resultant string after it is read from the file associated with the CArchive object.

  • lpsz
    Specifies a pointer to a user-supplied buffer that will receive a null-terminated text string.

  • nMax
    Specifies the maximum number of characters to read. Should be one less than the size of the lpsz buffer.

Return Value

In the version that returns BOOL, TRUE if successful; FALSE otherwise.

In the version that returns an LPTSTR, a pointer to the buffer containing the text data; NULL if end-of-file was reached.

Remarks

In the version of the member function with the nMax parameter, the buffer will hold up to a limit of nMax - 1 characters. Reading is stopped by a carriage return-linefeed pair. Trailing newline characters are always removed. A null character ('\0') is appended in either case.

CArchive::Read is also available for text-mode input, but it does not terminate on a carriage return-linefeed pair.

Example

See the example for CArchive::WriteString.

Requirements

Header: afx.h

See Also

Reference

CArchive Class

Hierarchy Chart

CArchive::Read

CArchive::Write

CArchive::WriteString

CArchiveException Class