En este post voy a explicar cómo leer el contenido de un archivo de texto usando Go. Es decir, obtener todo el contenido del archivo y pasarlo a una variable de tipo cadena o string.

De esta manera, se podrá imprimir el contenido de un archivo fácilmente. Se especifican dos formas: una en donde se lee todo el contenido de un archivo, y otra en donde, a través de un búfer, se leen fragmentos o bytes del archivo; especialmente cuando se trata de archivos o ficheros grandes.

El archivo de texto

Para ejemplificar este tutorial, el archivo de texto que se ocupará es este:

Hola, soy un archivo de texto para demostrar algunos tutoriales de parzibyte.me. Puedo contener cualquier tipo de contenido, por ejemplo, saltos,
    tabulaciones
y cualquier

otra


cosa.

El mismo contiene tabulaciones, saltos de línea y texto en general. De cualquier manera, el mismo es incluido en cada gist abajo.

Leer todo el archivo de texto dentro de una cadena usando Go

El método más fácil de implementar para leer un archivo de texto en Go es leerlo todo en un string. Esto no es óptimo cuando se tienen archivos grandes; pues todo el contenido será puesto en la RAM. En fin, si el archivo es relativamente pequeño, no pasa nada.

Aquí está el código:

Hola, soy un archivo de texto para demostrar algunos tutoriales de parzibyte.me. Puedo contener cualquier tipo de contenido, por ejemplo, saltos,
    tabulaciones
y cualquier

otra


cosa.

/*
	Leer un archivo de texto en Go, colocando
	todo el contenido en una string (no recomendado
	si es un archivo grande)

	@author parzibyte
*/
package main

import (
	"fmt"
	"io/ioutil"
)

func main() {
	nombreArchivo := "archivo.txt"
	bytesLeidos, err := ioutil.ReadFile(nombreArchivo)
	if err != nil {
		fmt.Printf("Error leyendo archivo: %v", err)
	}

	contenido := string(bytesLeidos)
	fmt.Printf("El contenido del archivo es: %s", contenido)
}

Para leer todo el contenido se utiliza ioutil.<span class="pl-c1">ReadFile</span>(nombreArchivo) (fuente); el cual regresa un slice de bytes. Luego se convierte a cadena con string(bytesLeidos) y más tarde se puede imprimir o hacer cualquier cosa.

Obtener contenido de un archivo trozo por trozo usando Go

Este método es el más eficaz cuando se leen grandes archivos (incluso de gigabytes). Aquí está el código:

Hola, soy un archivo de texto para demostrar algunos tutoriales de parzibyte.me. Puedo contener cualquier tipo de contenido, por ejemplo, saltos,
    tabulaciones
y cualquier

otra


cosa.

/*
	Leer un archivo de texto en Go, utilizando un
	búfer para leerlo por fragmentos o trozos
	pequeños

	@author parzibyte
*/
package main

import (
	"fmt"
	"io"
	"os"
)

const TamanioBufer = 5 // En bytes
func main() {
	nombreArchivo := "archivo.txt"
	archivo, err := os.Open(nombreArchivo)
	if err != nil {
		fmt.Printf("Error abriendo archivo %s: %v", nombreArchivo, err)
	}
	defer archivo.Close()

	bufer := make([]byte, TamanioBufer)
	// Ciclo infinito hasta que se detenga dentro
	for {
		// Nota: bytesLeidos es un entero que indica cuántos bytes hemos leído
		bytesLeidos, err := archivo.Read(bufer)
		if err != nil {
			if err != io.EOF {
				fmt.Printf("Error leyendo contenido: %v", err)
			}
			// ¿Alcanzamos el End Of Line? entonces termina el ciclo
			break
		}
		// Aquí es en donde procesamos los datos
		fragmento := string(bufer[:bytesLeidos])
		fmt.Printf("Leído este fragmento: %s\n", fragmento)
	}
}

Primero se reserva un búfer, que en realidad es un slice de bytes. Su longitud está dada en bytes, la cual puede ser cambiada en la constante TamanioBufer. En términos generales, cada byte es un carácter del archivo de texto, por lo que si se desea leer carácter por carácter, el búfer debería ser de 1 byte.

Cuando se ha terminado la lectura, se lanza un error de tipo io.EOF; y ahí se acaba el ciclo. Dentro del mismo también se está comprobando si no hay algún error distinto al del fin de línea.

No importa si el búfer es más grande que los datos leídos, por eso es que se utiliza a bufer[:bytesLeidos] para cortar el slice desde 0 hasta el número de bytes leídos.