Enum OpenEncodingPolicy 

pub enum OpenEncodingPolicy {
    Utf8FastPath,
    AutoDetect,
    AutoDetectOrReinterpret(DocumentEncoding),
    Reinterpret(DocumentEncoding),
}

Open policy for choosing between the UTF-8 mmap fast path, initial BOM-backed detection, or an explicit reinterpretation encoding.

Variants

Utf8FastPath

Keep the existing UTF-8/ASCII mmap fast path and its current semantics.

AutoDetect

Detect BOM-backed encodings on open and otherwise fall back to the normal UTF-8/ASCII fast path.

This first detection slice intentionally avoids heavyweight legacy charset guessing so open-time cost stays predictable.

AutoDetectOrReinterpret(DocumentEncoding)

Detect BOM-backed encodings first and otherwise reinterpret the source through the requested fallback encoding.

This keeps the cheap BOM-backed detection path while still letting a caller say “if you do not detect anything stronger, use this explicit encoding instead of plain UTF-8 fast-path behavior”.

Reinterpret(DocumentEncoding)

Reinterpret the source bytes through the requested encoding.

This is the option to use for legacy encodings such as windows-1251, Shift_JIS, or GB18030 when the caller already knows the intended source encoding.

Trait Implementations

impl Clone for OpenEncodingPolicy

fn clone(&self) -> OpenEncodingPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpenEncodingPolicy

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

Formats the value using the given formatter.

impl Default for OpenEncodingPolicy

fn default() -> OpenEncodingPolicy

Returns the “default value” for a type.

impl Hash for OpenEncodingPolicy

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for OpenEncodingPolicy

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

impl Eq for OpenEncodingPolicy

impl StructuralPartialEq for OpenEncodingPolicy