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. The decoder asks the wrapped codec whether one value can be decoded from the currently available units. If the codec reports a valid incomplete prefix, the tail is left in the caller-provided input slice and crate::TranscodeStatus::NeedInput is returned. Callers must handle incomplete EOF tails before calling BufferedTranscoder::finish.

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 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_policy(codec: C, policy: CharsetDecodePolicy) -> Self

Creates a decoder with an explicit malformed-input policy.

Parameters

• codec: Low-level charset codec used to decode input units.
• policy: Malformed-input policy used by the decoder.

Returns

Returns a decoder configured with policy.

pub const fn malformed_action(&self) -> MalformedAction

Returns the configured malformed-input action.

Returns

Returns the action used when source input is malformed.

pub const fn replacement(&self) -> char

Returns the configured replacement character.

Returns

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

Trait Implementations

impl<C> BufferedDecoder<<C as Codec>::Unit, char> for CharsetDecoder<C>

where C: CharsetCodec,

impl<C> BufferedTranscoder<<C as Codec>::Unit, char> for CharsetDecoder<C>

where C: CharsetCodec,

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

Returns the maximum number of characters decoded from input_len units.

fn max_finish_output_len(&self) -> Result<usize, CapacityError>

Returns the maximum number of characters emitted by finishing internal state.

fn reset(&mut self)

Clears hook-owned state while keeping decoder policy.

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

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

fn finish( &mut self, output: &mut [char], output_index: usize, ) -> Result<usize, FinishError<Self::Error>>

Finishes decoder-owned final output after EOF.

type Error = CharsetDecodeError

Error reported for semantic conversion failures.

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> Debug for CharsetDecoder<C>

where C: CharsetCodec + Debug,

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

Formats the value using the given formatter.

impl<C> Eq for CharsetDecoder<C>

where C: CharsetCodec + Eq,

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> StructuralPartialEq for CharsetDecoder<C>

where C: CharsetCodec,