Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

CharsetEncoder: codificar caracteres en bytes

CharsetEncoder convierte caracteres Unicode en bytes de un juego de caracteres seleccionado. Permite gestionar los errores de forma explícita y codificar un búfer completo o sucesivos fragmentos de texto.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

CharsetEncoder encoder = charset.newEncoder();
ByteBuffer bytes = encoder.encode(CharBuffer.wrap(text));
encoder.reset();
CoderResult result = encoder.encode(in, out, endOfInput);

CharsetEncoder, de java.nio.charset, codifica caracteres en bytes; CharsetDecoder realiza la operación inversa. Crea un codificador mediante charset.newEncoder() y selecciona explícitamente el juego de caracteres.

CharsetEncoder.encode(CharBuffer) realiza el reinicio, la codificación y el vaciado final del estado. Devuelve un nuevo ByteBuffer listo para leer: su posición es cero y su límite marca el final de los datos. No invoques este método durante una operación en curso.

encode(in, out, endOfInput) avanza las posiciones de los búferes y devuelve CoderResult. Si se obtiene OVERFLOW, extrae los bytes; si se obtiene UNDERFLOW, conserva los caracteres no consumidos antes de añadir más. Inicia una operación nueva con reset() (no hace falta en el primer uso); termina la codificación con endOfInput = true y después llama a flush(out) hasta obtener UNDERFLOW.

El valor predeterminado REPORT distingue entre UTF-16 mal formado y caracteres válidos que no se pueden representar en el juego de caracteres. La variante de un solo búfer lanza CharacterCodingException; la variante de flujo devuelve un resultado de error. IGNORE y REPLACE pueden provocar pérdida de información. No compartas un codificador entre hilos que se ejecutan al mismo tiempo.

Ejemplos

import java.nio.ByteBuffer;
import java.nio.CharBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.CharsetEncoder;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws CharacterCodingException {
        CharsetEncoder encoder = StandardCharsets.UTF_8.newEncoder();
        ByteBuffer bytes = encoder.encode(CharBuffer.wrap("A\u20AC"));
        while (bytes.hasRemaining()) {
            System.out.println(bytes.get() & 0xFF);
        }
    }
}

Resultado

65
226
130
172

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes