HOWTO · C++

Cómo leer un archivo línea por línea en C++

En este artículo, exploraremos cuatro enfoques comunes para leer un archivo línea por línea en C++: usar ifstream con getline(), la función getline() de la biblioteca de C, la función fgets() e istream_iterator.

En esta página

Leer un archivo línea por línea en C++ es una operación fundamental en muchas tareas de programación, como el procesamiento de datos, el análisis de texto y el análisis de archivos. Ya sea que trabajes con archivos de texto pequeños o con grandes conjuntos de datos, saber cómo realizar esta tarea es importante.

En este artículo, exploraremos cuatro enfoques comunes para leer un archivo línea por línea en C++: usar ifstream con getline(), la función getline() de la biblioteca de C, la función fgets() e istream_iterator.

Por qué leer un archivo línea por línea

Leer un archivo línea por línea suele preferirse a leerlo todo de una vez, especialmente cuando se trata de archivos grandes. Al procesar una línea a la vez, puedes gestionar eficientemente el uso de la memoria y manejar archivos de prácticamente cualquier tamaño.

Este enfoque es particularmente útil para tareas en las que necesitas procesar cada línea de forma independiente, como analizar archivos CSV, procesar registros o analizar texto.

Aquí tienes un ejemplo de archivo input.txt que contiene un texto de ejemplo:

This is a sample input file.
It contains multiple lines of text.
Each line demonstrates a different scenario.
For example, this line contains numbers: 12345.
And this line has special characters: !@#$%^&*().

Usemos este archivo como entrada para probar los ejemplos de lectura de archivos en las secciones siguientes.

Cómo leer un archivo línea por línea en C++ usando ifstream con la función getline()

Cuando se trata de leer un archivo línea por línea en C++, uno de los métodos más sencillos y utilizados consiste en utilizar la clase ifstream junto con la función getline(). Este enfoque ofrece simplicidad y eficiencia en el manejo de la entrada de archivos, lo que lo convierte en la opción preferida de muchos desarrolladores.

La función getline() forma parte de la biblioteca estándar de C++ y se utiliza principalmente para leer líneas de flujos de entrada, como archivos o la entrada estándar (cin).

Su sintaxis es la siguiente:

istream& getline(istream& is, string& str, char delim);

Donde:

  • is: Flujo de entrada del que se leerán los caracteres.
  • str: Variable de cadena en la que se almacenan los caracteres extraídos.
  • delim: Carácter delimitador que marca el final de cada línea (el valor predeterminado es '\n').

La función getline() lee caracteres del flujo de entrada hasta que encuentra el delimitador especificado o llega al final del flujo. A continuación, almacena estos caracteres en la variable de cadena proporcionada, excluyendo el propio delimitador.

Es importante destacar que getline() devuelve el flujo de entrada (is), lo que permite encadenar varias operaciones de entrada.

Ahora, veamos un ejemplo que demuestra cómo leer un archivo línea por línea usando ifstream con getline() en C++:

#include <fstream>
#include <iostream>
#include <string>

int main() {
  std::ifstream file("input.txt");

  if (!file.is_open()) {
    std::cerr << "Error: Unable to open the file." << std::endl;
    return 1;
  }

  std::string line;

  while (std::getline(file, line)) {
    std::cout << line << std::endl;
  }

  file.close();

  return 0;
}

En este ejemplo, comenzamos incluyendo los archivos de cabecera necesarios: <iostream>, <fstream> y <string>. Estos proporcionan funcionalidades para la entrada/salida, el flujo de archivos y la manipulación de cadenas, respectivamente.

A continuación, definimos la función main. Dentro de la función main, se crea una instancia de std::ifstream llamada file, que representa el flujo de archivo de entrada.

Luego intentamos abrir el archivo llamado "input.txt" utilizando el constructor del archivo. Si el archivo no se puede abrir, se imprime un mensaje de error en el flujo de error estándar (cerr) y el programa termina con un estado distinto de cero.

A continuación, declaramos una variable de cadena line para almacenar cada línea leída del archivo. Dentro del bucle while, llamamos repetidamente a std::getline() con el flujo de archivo (file) y la variable de cadena (line) como argumentos.

Esta función lee una línea del flujo de archivo hasta que llega al final de la línea o al final del archivo. Cada línea leída se imprime a continuación en el flujo de salida estándar (cout).

Finalmente, después de leer todas las líneas del archivo, cerramos el flujo de archivo utilizando el método close() para liberar recursos del sistema.

Salida:

Leer un archivo línea por línea en C++ usando ifstream con getline()

Esto demuestra cómo leer eficazmente un archivo línea por línea en C++ usando ifstream con getline(), proporcionando un método claro y conciso para manejar las operaciones de entrada de archivos.

Cómo leer un archivo línea por línea en C++ usando la función getline() de la biblioteca de C

Además de la biblioteca estándar de C++, los desarrolladores de C++ también pueden utilizar la función getline() proporcionada por la biblioteca de C para leer un archivo línea por línea. Aunque esta función opera de forma ligeramente diferente, ofrece una alternativa viable para manejar las operaciones de entrada de archivos.

La función getline() de la biblioteca de C se utiliza principalmente para leer líneas de flujos de entrada, de forma similar a su homóloga en la biblioteca estándar de C++. Su sintaxis es la siguiente:

ssize_t getline(char** lineptr, size_t* n, FILE* stream);

Aquí,

  • lineptr: Un puntero al búfer donde se almacenará la línea.
  • n: Un puntero a la variable que contiene el tamaño del búfer (que se redimensionará si es necesario).
  • stream: El flujo de archivo del que se leerá la línea.

A diferencia de la función getline() de la biblioteca estándar de C++, la versión de la biblioteca de C devuelve un valor ssize_t que indica el número de caracteres leídos o -1 si se produce un error o se llega al final del archivo.

Veamos un ejemplo que demuestra cómo leer un archivo línea por línea usando getline() de la biblioteca de C en C++:

#include <cstdio>
#include <cstdlib>
#include <iostream>

int main() {
  FILE* file = fopen("input.txt", "r");

  if (!file) {
    std::cerr << "Error: Unable to open the file." << std::endl;
    return 1;
  }

  char* line = nullptr;
  size_t len = 0;

  ssize_t read;
  while ((read = getline(&line, &len, file)) != -1) {
    std::cout << line;
  }

  free(line);

  fclose(file);

  return 0;
}

Comenzando con los archivos de cabecera necesarios incluidos: <iostream> para las operaciones de entrada/salida, <cstdio> para la entrada/salida al estilo de C y <cstdlib> para las funciones de asignación de memoria.

En la función main, declaramos un puntero FILE* llamado file e intentamos abrir el archivo "input.txt" en modo de lectura utilizando la función fopen(). Si el archivo no se puede abrir, se imprime un mensaje de error y el programa termina con un estado distinto de cero.

A continuación, declaramos un puntero a carácter line y una variable size_t len para almacenar cada línea leída del archivo y su longitud, respectivamente. Dentro del bucle while, llamamos repetidamente a getline() con el flujo de archivo (file), la dirección del puntero line y la dirección de la variable len.

Esta función lee una línea del flujo de archivo, asigna memoria dinámicamente según sea necesario y almacena la línea en el búfer al que apunta line. Cada línea leída se imprime a continuación en el flujo de salida estándar (cout).

Después de leer todas las líneas del archivo, liberamos la memoria asignada dinámicamente para el búfer line utilizando la función free() y cerramos el flujo de archivo utilizando la función fclose() para liberar recursos del sistema.

Salida:

Leer un archivo línea por línea en C++ usando getline() de la biblioteca de C

Esto demuestra un método alternativo para leer un archivo línea por línea en C++, aprovechando la función getline() de la biblioteca de C.

Cómo leer un archivo línea por línea en C++ usando la función fgets()

Otro método para leer un archivo línea por línea en C++ consiste en utilizar la función fgets(), que forma parte de la biblioteca estándar de C. Aunque fgets() puede parecer menos intuitiva en comparación con los enfoques basados en flujos de C++, ofrece simplicidad y compatibilidad con código heredado o escenarios en los que se prefiere la entrada/salida al estilo de C.

La sintaxis de fgets() es la siguiente:

char *fgets(char *str, int size, FILE *stream);

Aquí,

  • str: Un puntero al array de caracteres (búfer) donde se almacenará la línea.
  • size: El número máximo de caracteres a leer (incluido el terminador nulo).
  • stream: El flujo de archivo del que se leerá la línea.

La función devuelve str en caso de éxito o NULL si se produce un error o se llega al final del archivo.

Procedamos con un ejemplo que ilustra cómo leer un archivo línea por línea usando fgets() en C++:

#include <cstdio>
#include <iostream>

int main() {
  FILE* file = fopen("input.txt", "r");

  if (!file) {
    std::cerr << "Error: Unable to open the file." << std::endl;
    return 1;
  }

  char line[256];

  while (fgets(line, sizeof(line), file) != NULL) {
    std::cout << line;
  }

  fclose(file);

  return 0;
}

En este ejemplo, comenzamos incluyendo los archivos de cabecera necesarios: <iostream> para las operaciones de entrada/salida y <cstdio> para la entrada/salida al estilo de C.

Dentro de la función main, declaramos un puntero FILE* llamado file e intentamos abrir el archivo "input.txt" en modo de lectura utilizando la función fopen(). Si el archivo no se puede abrir, se imprime un mensaje de error y el programa termina con un estado distinto de cero.

A continuación, definimos un array de caracteres line con un tamaño de 256 caracteres para almacenar cada línea leída del archivo. Dentro del bucle while, llamamos repetidamente a fgets() con el flujo de archivo (file), la dirección del array line y el tamaño del array.

Esta función lee una línea del flujo de archivo y la almacena en el búfer line. Cada línea leída se imprime a continuación en el flujo de salida estándar (cout).

Después de leer todas las líneas del archivo, cerramos el flujo de archivo utilizando la función fclose() para liberar recursos del sistema.

Salida:

Leer un archivo línea por línea en C++ usando fgets()

Esto muestra un enfoque alternativo para leer un archivo línea por línea en C++. Aunque ligeramente diferente en sintaxis y uso, fgets() proporciona una opción viable para manejar las operaciones de entrada de archivos, ofreciendo compatibilidad y familiaridad con los paradigmas de programación al estilo de C.

Cómo leer un archivo línea por línea en C++ usando istream_iterator

El istream_iterator proporciona una forma elegante y moderna de leer datos de flujos de entrada, incluidos archivos, tratando el flujo como una secuencia de elementos. Aunque se utiliza típicamente para leer datos con formato como enteros o cadenas, también puede emplearse para leer líneas de un archivo tratando cada línea como un elemento de cadena.

Este enfoque ofrece concisión y legibilidad en el código, lo que lo convierte en una opción conveniente para muchos desarrolladores.

La sintaxis de istream_iterator es la siguiente:

istream_iterator<T> it(istream& is);

Aquí,

  • T: El tipo de datos a leer.
  • is: El flujo de entrada del que se leerán los datos.

El constructor de istream_iterator inicializa un iterador (it) para iterar sobre los elementos extraídos del flujo de entrada (is). Se utiliza típicamente en combinación con los operadores de desreferencia e incremento de istream_iterator (*it y ++it, respectivamente) para acceder a los elementos del flujo y avanzar a través de ellos.

Considera el siguiente ejemplo de código que demuestra cómo leer un archivo línea por línea usando istream_iterator en C++:

#include <fstream>
#include <iostream>
#include <iterator>
#include <string>

int main() {
  std::ifstream file("input.txt");

  if (!file.is_open()) {
    std::cerr << "Error: Unable to open the file." << std::endl;
    return 1;
  }

  std::istream_iterator<std::string> it(file);
  std::istream_iterator<std::string> end;

  if (it == end) {
    std::cerr << "Error: Empty file." << std::endl;
    return 1;
  }

  std::cout << *it++;

  while (it != end) {
    std::cout << " " << *it++;
  }
  std::cout << std::endl;

  file.close();

  return 0;
}

Comenzando con los archivos de cabecera necesarios incluidos: <iostream> para las operaciones de entrada/salida, <fstream> para el flujo de archivos, <iterator> para las operaciones con iteradores y <string> para la manipulación de cadenas.

En la función main, declaramos un objeto ifstream llamado file e intentamos abrir el archivo "input.txt". Si el archivo no se puede abrir, se imprime un mensaje de error y el programa termina con un estado distinto de cero.

A continuación, creamos un istream_iterator llamado it, inicializado con el flujo de archivo file, para leer cadenas del archivo. Además, creamos un iterador de fin de flujo llamado end para denotar el final del archivo.

Dentro del bucle while, iteramos sobre el contenido del archivo utilizando el iterador it hasta que alcanza el iterador de fin de flujo end. En cada iteración, desreferenciamos el iterador (*it) para obtener la línea actual, la enviamos a la consola y luego avanzamos el iterador (++it).

Después de procesar todas las líneas del archivo, cerramos el flujo de archivo utilizando el método close() para liberar recursos del sistema.

Salida:

Leer un archivo línea por línea en C++ usando istream_iterator

Esto demuestra un método alternativo para leer un archivo línea por línea en C++, aprovechando el istream_iterator para tratar el contenido del archivo como una secuencia de cadenas. Este enfoque proporciona una solución moderna y concisa para manejar las operaciones de entrada de archivos, mejorando la legibilidad y el mantenimiento del código.

Conclusión

Hemos explorado varios métodos para leer un archivo línea por línea en C++, cada uno de los cuales ofrece sus ventajas y su idoneidad según los requisitos y preferencias específicos del programador. Ya sea utilizando la función getline() de la biblioteca estándar de C++, getline() de la biblioteca de C, fgets() o istream_iterator, los desarrolladores tienen una variedad de opciones entre las que elegir.

La función getline() tanto en las bibliotecas de C++ como de C proporciona un enfoque sencillo, mientras que fgets() ofrece compatibilidad con la programación al estilo de C. Por otro lado, istream_iterator presenta una solución moderna y concisa para iterar sobre el contenido del archivo como una secuencia de cadenas.

Independientemente del método elegido, el objetivo clave sigue siendo el mismo: leer el contenido de un archivo línea por línea de forma eficiente y precisa. Al comprender la sintaxis y la mecánica de cada método, podemos seleccionar el enfoque más adecuado para nuestros proyectos, garantizando un manejo eficiente de los archivos y una legibilidad óptima del código.