dart:convert

Utf8Decoder class

This class converts UTF-8 code units (lists of unsigned 8-bit integers) to a string.

Example:

final utf8Decoder = utf8.decoder;
const encodedBytes = [
  195, 142, 195, 177, 197, 163, 195, 169, 114, 195, 177, 195, 165, 197,
  163, 195, 174, 195, 182, 195, 177, 195, 165, 196, 188, 195, 174, 197,
  190, 195, 165, 197, 163, 195, 174, 225, 187, 157, 195, 177];

final decodedBytes = utf8Decoder.convert(encodedBytes);
print(decodedBytes); // Îñţérñåţîöñåļîžåţîờñ

Throws a FormatException if the encoded input contains invalid UTF-8 byte sequences and allowMalformed is false (the default).

If allowMalformed is true, invalid byte sequences are converted into one or more Unicode replacement characters, U+FFFD ('�').

Example with allowMalformed set to true:

const utf8Decoder = Utf8Decoder(allowMalformed: true);
const encodedBytes = [0xFF];
final decodedBytes = utf8Decoder.convert(encodedBytes);
print(decodedBytes); // �

Inheritance

• Object
• StreamTransformerBase<List<int>, String>
• Converter<List<int>, String>
• Utf8Decoder

Constructors

Utf8Decoder({bool allowMalformed = false})

const

Instantiates a new Utf8Decoder.

Properties

hashCode → int

read-only, inherited

The hash code for this object.

runtimeType → Type

read-only, inherited

A representation of the runtime type of the object.

Methods

bind(Stream<List<int>> stream) → Stream<String>

override

Transforms the provided stream.

cast<RS, RT>() → Converter<RS, RT>

inherited

Provides a Converter<RS, RT> view of this stream transformer.

convert(List<int> codeUnits, [int start = 0, int? end]) → String

override

Converts the UTF-8 codeUnits (a list of unsigned 8-bit integers) to the corresponding string.

fuse<T>(Converter<String, T> next) → Converter<List<int>, T>

override

Fuses this with other.

noSuchMethod(Invocation invocation) → dynamic

inherited

Invoked when a non-existent method or property is accessed.

startChunkedConversion(Sink<String> sink) → ByteConversionSink

override

Starts a chunked conversion.

toString() → String

inherited

A string representation of this object.

Operators

operator ==(Object other) → bool

inherited

The equality operator.