Share via


CStdioFile::ReadString

Lee el texto a datos en un búfer, hasta un límite de nMax– 1 caracteres, el archivo asociado al objeto de CStdioFile .

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

Parámetros

  • lpsz
    Especifica un puntero a un búfer usuario- proporcionado recibir una cadena de texto terminada en null.

  • nMax
    Especifica el número máximo de caracteres para leer, sin contar el carácter null de terminación.

  • rString
    Una referencia a un objeto de CString que contendrá la cadena cuando finaliza la función.

Valor devuelto

Un puntero al búfer que contiene los datos de texto.NULL si es final de archivo se tuvo acceso sin leer ningún dato; o si es booleano, FALSE si es final de archivo se tuvo acceso sin leer ningún dato.

Comentarios

La lectura es detenido por el primer carácter de nueva línea.Si, en ese caso, menor que nMax– se han leído los caracteres 1, un carácter de nueva línea se almacenan en el búfer.Un carácter null (“\ 0 ") se anexa a cualquier caso.

CFile::Read también está disponible para la entrada del modo de texto, pero no termina en un par de retorno- avance de línea de carro.

[!NOTA]

La versión de CString de esta función quita '\n' si existe; la versión de LPTSTR no.

Ejemplo

CStdioFile f(stdin);
TCHAR buf[100];

f.ReadString(buf, 99);

Requisitos

encabezado: afx.h

Vea también

Referencia

Clase de CStdioFile

Gráfico de jerarquía

CStdioFile::WriteString

CFile::Read