Enum InvalidUtf8 

#[non_exhaustive]
pub enum InvalidUtf8 {
    Lossy,
    Strict,
}

Strategy for handling byte sequences that are not valid UTF-8 (or UTF-16).

Steam stores string values in binary VDF files as raw byte strings and does not guarantee they are valid UTF-8. Localized fields in particular often carry legacy code-page bytes (e.g. a Czech app name Moje Spore v\u{fffd}tvory where 0xFD is Windows-1250 ý), which are not valid UTF-8 on their own.

This enum selects what the parser does when it encounters such bytes.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Lossy

Replace invalid byte sequences with the U+FFFD REPLACEMENT CHARACTER.

Parsing always succeeds. Valid strings are still borrowed zero-copy from the input; only strings that actually contain invalid bytes are allocated (to hold the replacement characters). This is the default.

Strict

Return an Error::InvalidUtf8 (or Error::InvalidUtf16) error.

Use this when you need to detect corruption rather than silently substituting replacement characters.

Trait Implementations

impl Clone for InvalidUtf8

fn clone(&self) -> InvalidUtf8

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for InvalidUtf8

impl Debug for InvalidUtf8

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

Formats the value using the given formatter.

impl Default for InvalidUtf8

fn default() -> InvalidUtf8

Returns the “default value” for a type.

impl Eq for InvalidUtf8

impl Hash for InvalidUtf8

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 InvalidUtf8

fn eq(&self, other: &InvalidUtf8) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for InvalidUtf8