CArchive::ReadString

Articolo
06/10/2015

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.