CArchive::ReadString

Articolo
03/05/2013

Chiamare la funzione membro per leggere i dati di testo in un buffer dal file associato all'oggetto CArchive.

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

Parametri

rString
Un riferimento a CString che conterrà la stringa risultante dopo che viene letto dal file associato all'oggetto di CArchive.
lpsz
Specifica un puntatore a un buffer fornito dall'utente che riceverà una stringa di testo con terminazione null.
nMax
Specifica il numero massimo di caratteri da leggere.Deve essere uno meno la dimensione del buffer di lpsz .

Valore restituito

Nella versione che restituisce BOOL, TRUE se eseguita correttamente, FALSE in caso contrario.

Nella versione che restituisce LPTSTR, un puntatore a un buffer che contiene i dati di testo; Se NULL di fine file è stato raggiunto.

Note

Nella versione della funzione membro con il parametro nMax, il buffer sosterrà al limite nMax a 1 caratteri.La lettura viene interrotta da una coppia ritorno a capo-avanzamento riga.I caratteri di nuova riga finale vengono rimossi sempre.Un carattere null (" \ 0 ") viene aggiunto in entrambi i casi.

CArchive::Read è disponibile anche per l'input di " text-mode ", ma non termina in una coppia ritorno a capo-avanzamento riga.