Struct CStringLiteralCodec 

pub struct CStringLiteralCodec;

Encodes and decodes byte-oriented C string literal fragments.

This codec is intended for textual formats that embed byte sequences with C escapes, such as PK\003\004 or \xd0\xcf. It decodes into raw bytes and does not require surrounding quotes.

Its low-level Codec<Value = u8, Unit = u8> implementation handles one raw byte or one C escape fragment. Whole-fragment iteration remains part of the owned encode and decode helpers.

Implementations

impl CStringLiteralCodec

pub fn new() -> Self

Creates a C string literal codec.

Returns

A stateless C string literal codec.

pub fn encode(&self, bytes: &[u8]) -> String

Encodes bytes into a C string literal fragment.

Parameters

• bytes: Raw bytes to encode.

Returns

A C string literal fragment without surrounding quotes.

pub fn decode(&self, text: &str) -> MiscCodecResult<Vec<u8>>

Decodes a C string literal fragment into bytes.

Parameters

• text: C string literal fragment without surrounding quotes.

Returns

Decoded raw bytes.

Errors

Returns MiscCodecError::InvalidEscape for malformed escape sequences, MiscCodecError::InvalidDigit for malformed fixed-width numeric escapes, and MiscCodecError::InvalidCharacter for unsupported raw source characters.

Trait Implementations

impl Clone for CStringLiteralCodec

fn clone(&self) -> CStringLiteralCodec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Codec for CStringLiteralCodec

fn min_units_per_value(&self) -> NonZeroUsize

Returns the shortest representation length for one byte.

fn max_units_per_value(&self) -> NonZeroUsize

Returns the longest supported universal escape length for one byte.

unsafe fn decode_unchecked( &self, input: &[u8], index: usize, ) -> Result<(u8, NonZeroUsize), Self::DecodeError>

Decodes one raw byte or one C escape fragment.

unsafe fn encode_unchecked( &self, value: &u8, output: &mut [u8], index: usize, ) -> Result<usize, Self::EncodeError>

Encodes one byte as a raw byte or C escape fragment.

type Value = u8

Logical value decoded from or encoded into the buffer.

type Unit = u8

Buffer unit used by the encoded representation.

type DecodeError = MiscCodecError

Error reported when decoding malformed units.

type EncodeError = MiscCodecError

Error reported when encoding an unsupported value.

impl Copy for CStringLiteralCodec

impl Debug for CStringLiteralCodec

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

Formats the value using the given formatter.

impl Default for CStringLiteralCodec

fn default() -> CStringLiteralCodec

Returns the “default value” for a type.

impl Eq for CStringLiteralCodec

impl PartialEq for CStringLiteralCodec

fn eq(&self, other: &CStringLiteralCodec) -> 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 StructuralPartialEq for CStringLiteralCodec

impl ValueDecoder<str> for CStringLiteralCodec

fn decode(&self, input: &str) -> Result<Self::Output, Self::Error>

Decodes a C string literal fragment into bytes.

type Error = MiscCodecError

Decoding error type.

type Output = Vec<u8>

Decoded output type.

impl ValueEncoder<[u8]> for CStringLiteralCodec

fn encode(&self, input: &[u8]) -> Result<Self::Output, Self::Error>

Encodes bytes into a C string literal fragment.

type Error = MiscCodecError

Encoding error type.

type Output = String

Encoded output type.