Struct CharsetDecoder 

pub struct CharsetDecoder<C>
where
    C: CharsetCodec,
{ /* private fields */ }

Converts units of one charset into Unicode scalar values.

CharsetDecoder wraps a low-level CharsetCodec and applies the configured MalformedAction whenever the codec reports malformed input.

Type Parameters

• C: Low-level charset codec used to decode source storage units into one Unicode scalar value.

Implementations

impl<C> CharsetDecoder<C>

where C: CharsetCodec,

pub const DEFAULT_REPLACEMENT: char = '\u{fffd}'

Default replacement character used when malformed input is replaced.

pub const fn new(codec: C) -> Self

Creates a decoder with default replacement policy.

Parameters

• codec: Low-level charset codec used to decode input units.

Returns

Returns a decoder whose malformed action is MalformedAction::Replace and whose replacement character is U+FFFD.

pub fn with_replacement(self, replacement: char) -> Self

Creates a decoder with a custom replacement character.

This method performs no codec-level validation because malformed-input replacement for decoding writes directly to the output char buffer.

Parameters

• replacement: Replacement character for malformed sequences.

Returns

Returns a new decoder configured with the provided replacement.

pub const fn codec(&self) -> &C

Returns the wrapped low-level codec.

Returns

Returns a shared reference to the configured codec.

pub fn codec_mut(&mut self) -> &mut C

Returns a mutable reference to the wrapped codec.

Returns

Returns a mutable reference to the configured codec.

pub const fn malformed_action(&self) -> MalformedAction

Returns the configured malformed-input action.

Returns

Returns the action used when source input is malformed.

pub fn set_malformed_action(&mut self, action: MalformedAction)

Sets the malformed-input action.

Parameters

• action: New policy for malformed input units.

pub const fn replacement(&self) -> char

Returns the configured replacement character.

Returns

Returns the character emitted when MalformedAction::Replace is used.

pub fn set_replacement(&mut self, replacement: char)

Sets the replacement character.

Parameters

• replacement: New replacement character used by replace policy.

Trait Implementations

impl<C> Clone for CharsetDecoder<C>

where C: CharsetCodec + Clone,

fn clone(&self) -> CharsetDecoder<C>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<C> Coder<<C as CharsetCodec>::Unit, char> for CharsetDecoder<C>

where C: CharsetCodec,

fn max_output_len(&self, input_len: usize) -> Option<usize>

Returns the maximum number of characters decoded from input_len units.

fn convert( &mut self, input: &[C::Unit], input_index: usize, output: &mut [char], output_index: usize, ) -> Result<CoderProgress, Self::Error>

Decodes source units into Unicode scalar values while applying malformed policy.

type Error = CharsetDecodeError

Error reported for semantic conversion failures.

fn reset(&mut self)

Resets state retained between conversion calls.

fn finish( &mut self, _output: &mut [Output], _output_index: usize, ) -> Result<CoderProgress, Self::Error>

Flushes any buffered output after input conversion is complete.

impl<C> Debug for CharsetDecoder<C>

where C: CharsetCodec + Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<C> PartialEq for CharsetDecoder<C>

where C: CharsetCodec + PartialEq,

fn eq(&self, other: &CharsetDecoder<C>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<C> Eq for CharsetDecoder<C>

where C: CharsetCodec + Eq,

impl<C> StructuralPartialEq for CharsetDecoder<C>

where C: CharsetCodec,