Leer archivos y stdin

Una CLI útil normalmente lee algo: un archivo cuyo nombre se indica o texto redirigido mediante una tubería. Zig ofrece formas claras y explícitas de hacer ambas cosas. 📥

Use std.fs.cwd para obtener el directorio actual y, después, openFile para abrir una ruta relativa a él en modo lectura.

Un archivo abierto es un recurso que usted posee. Combine la apertura con un defer file.close() para que se libere independientemente de cómo termine la función.

Para cargarlo todo de una vez, llame a readToEndAlloc con un allocator y un límite de tamaño. Devuelve los bytes en un slice que usted posee.

Ese slice devuelto vive en el heap, por lo que usted es responsable de él. Añada defer a.free(data) para liberar el búfer cuando haya terminado de usarlo.

Ese argumento de cantidad máxima de bytes le protege frente a un archivo enorme que consuma toda la memoria. Elija un limit adecuado para la entrada realista de su herramienta.

Para leer texto redirigido mediante una tubería, use std.io.getStdIn. Devuelve un archivo igual que uno abierto por usted, por lo que puede aplicar las mismas llamadas de lectura.

Solicite un reader a stdin y llame a readAllAlloc. Esto recopila todo lo recibido mediante la tubería, hasta el final de la entrada, en un único slice que usted posee.

Para trabajar con streaming, readUntilDelimiterOrEof de un reader extrae una línea cada vez en un búfer y devuelve null cuando termina la entrada.

Cada lectura directa puede implicar una llamada al sistema. Envuelva un reader en std.io.bufferedReader para agrupar muchas lecturas pequeñas en menos operaciones y hacerlas más rápidas.

Como tanto un archivo como stdin exponen un reader, a su lógica de análisis no le importa cuál de los dos ha recibido. Es un diseño limpio y reutilizable. ✨

Ha abierto archivos con openFile, los ha leído completos o línea por línea, ha extraído texto de stdin y ha liberado todos los búferes. Entrada gestionada. 🎯