Dominando la Clase PrintStream de Java: Print, Println y Printf Explicados

Dominando la Clase PrintStream de Java

Este tutorial profundiza en la clase PrintStream de Java, cubriendo su creación, métodos principales y ejemplos prácticos.

La clase PrintStream, parte del paquete java.io, extiende OutputStream y está diseñada para emitir texto legible por humanos en lugar de bytes sin procesar.

Cómo Funciona PrintStream

A diferencia de otros flujos, PrintStream convierte valores primitivos (int, char, etc.) en texto formateado antes de escribirlos en el destino. También nunca lanza IOException; en su lugar, los errores se reportan vía checkError().

Auto-flush es una característica clave: el flujo vacía automáticamente cuando:

• se imprime un carácter de nueva línea (\n),
• se llama al método println(), o
• se escribe un array de bytes.

Crear un PrintStream

Primero, importa la clase:

import java.io.PrintStream;

1. Desde un OutputStream existente

// Ejemplo: envolver un FileOutputStream
FileOutputStream fos = new FileOutputStream("log.txt");
PrintStream ps = new PrintStream(fos, true); // true = autoFlush

Esto escribe texto formateado en log.txt con auto-flush opcional.

2. Directamente desde un nombre de archivo

PrintStream ps = new PrintStream("log.txt", true);

El constructor acepta un booleano para auto-flush. Por defecto, el flujo usa la codificación de caracteres de la plataforma.

3. Especificando un charset

PrintStream ps = new PrintStream("log.txt", true, StandardCharsets.UTF_8);

Usar Charset te permite elegir UTF-8, UTF-16 o cualquier codificación soportada.

Nota: Para más detalles sobre conjuntos de caracteres, consulta la API de Charset de Java.

Métodos Principales de PrintStream

print() y println()

• print(Object obj) – muestra la representación en cadena del objeto.
• println(Object obj) – añade un terminador de línea específico de la plataforma.

Ejemplo: Usando System.out

public class Main {
    public static void main(String[] args) {
        System.out.print("Hola Mundo.");
    }
}

Aquí, System.out es un PrintStream preconfigurado, por lo que su método print() está disponible inmediatamente.

Ejemplo: Escribiendo en un Archivo

import java.io.PrintStream;

public class Main {
    public static void main(String[] args) {
        try {
            PrintStream ps = new PrintStream("output.txt");
            ps.print("Este es un texto dentro del archivo.");
            ps.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

El archivo output.txt resultante contiene:

Este es un texto dentro del archivo.

printf()

Imprime texto formateado usando especificadores de formato:

System.out.printf("Tengo %d años", 25);

Aquí, %d es reemplazado por el valor entero 25.

Ejemplo: Usando printf() con un Archivo

import java.io.PrintStream;

public class Main {
    public static void main(String[] args) {
        try {
            PrintStream ps = new PrintStream("output.txt");
            int edad = 25;
            ps.printf("Tengo %d años.", edad);
            ps.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Después de la ejecución, output.txt contiene:

Tengo 25 años.

Métodos Adicionales de PrintStream

Método	Descripción
close()	Cierra el flujo y libera recursos del sistema.
checkError()	Retorna true si el flujo ha encontrado un error.
append()	Añade la secuencia de caracteres especificada al flujo.

Para detalles completos, consulta la documentación oficial de Java PrintStream.