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.