CArchive::ReadString

telefonar Essa função de membro para ler dados de texto em um buffer de arquivo associado a CArchive objeto.

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

Parâmetros

  • rString
    Uma referência a um CString que irá conter a seqüência de caracteres resultante depois é lido do arquivo associado ao objeto CArchive.

  • lpsz
    Especifica um ponteiro para um buffer fornecido pelo usuário que vai receber uma seqüência de caracteres de texto terminada com caractere nulo.

  • nMax
    Especifica o número máximo de caracteres a serem lidos.Deve ser uma menor que o dimensionar do lpsz buffer.

Valor de retorno

Na versão retorna Bool, TRUE se for bem-sucedido; FALSE outra forma.

Na versão que retorna um LPTSTR, um ponteiro para o buffer que contém os dados de texto NULO se participante do arquivo foi atingido.

Comentários

Na versão da função de membro com o nMax parâmetro, o buffer irá armazenar um limite de nMax -1 caractere. Leitura é interrompida por um emparelhar de avanço de linha de retorno de carro.Caracteres de nova linha à direita sempre são removidos.Um caractere nulo ('\0') será acrescentado em ambos os casos.

CArchive::Read também está disponível para a entrada do modo de texto, mas não encerra em um emparelhar de avanço de linha de retorno de carro.

Exemplo

Consulte o exemplo para CArchive::WriteString.

Requisitos

Cabeçalho: afx.h

Consulte também

Referência

Classe CArchive

Gráfico de hierarquia

CArchive::Read

CArchive::gravar

CArchive::WriteString

Classe CArchiveException

Outros recursos

CArchive membros