CStdioFile::ReadString
Lê dados de texto em um buffer, até um limite de nMaxcaracteres de – 1, do arquivo associado a CStdioFile objeto.
virtual LPTSTR ReadString(
LPTSTR lpsz,
UINT nMax
);
virtual BOOL ReadString(
CString& rString
);
Parâmetros
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, sem contar o caractere nulo de terminação.rString
Uma referência a um CString objeto que irá conter a seqüência de caracteres quando a função retorna.
Valor de retorno
Um ponteiro para o buffer que contém os dados de texto.NULO se participante do arquivo foi atingido sem ler todos os dados; ou se booliano, FALSE se participante do arquivo foi atingido sem ler todos os dados.
Comentários
Leitura é interrompida pelo primeiro caractere de nova linha.Se, nesse caso, menos de nMaxcaracteres de – 1 tiverem sido lidos, um caractere de nova linha é armazenado no buffer. Um caractere nulo ('\0') será acrescentado em ambos os casos.
CFile::Read também está disponível para entrada do modo de texto, mas não encerra em um emparelhar de return–linefeed carro.
.gif "Observação") Observação: |
|---|
O CString versão desta função remove a '\n' Se presente; o LPTSTR versão não permite. |
Exemplo
CStdioFile f(stdin);
TCHAR buf[100];
f.ReadString(buf, 99);
Requisitos
Cabeçalho: afx.h