Struct StringConversionOptions 

pub struct StringConversionOptions {
    pub trim: bool,
    pub blank_string_policy: BlankStringPolicy,
}

Controls normalization applied once before parsing a string source.

Trimming happens before blank detection. A value is considered blank when it consists only of Unicode whitespace, even when trim is disabled; BlankStringPolicy::Preserve returns the original untrimmed slice in that case.

Examples

use qubit_datatype::StringConversionOptions;

let options = StringConversionOptions::env_friendly();
assert_eq!(options.normalize("  value  "), Ok("value"));
assert!(options.normalize("   ").is_err());

Fields

trim: bool

Whether strings are trimmed before conversion.

blank_string_policy: BlankStringPolicy

How blank strings are interpreted after optional trimming.

Implementations

impl StringConversionOptions

pub const fn env_friendly() -> Self

Creates options suitable for environment-variable input.

The profile trims surrounding whitespace and treats a blank value as missing, matching common environment configuration conventions.

Returns

Environment-friendly string normalization options.

pub fn with_trim(self, trim: bool) -> Self

Returns a copy with string trimming enabled or disabled.

Parameters

• trim - Whether strings should be trimmed.

Returns

Updated options.

pub fn with_blank_string_policy(self, policy: BlankStringPolicy) -> Self

Returns a copy with a different blank string policy.

Parameters

• policy - New blank string policy.

Returns

Updated options.

pub fn normalize<'a>( &self, value: &'a str, ) -> Result<&'a str, StringNormalizationError>

Normalizes a string source according to these options.

Parameters

• value - Source string.

Returns

Returns the normalized string.

Errors

Returns StringNormalizationError::Missing when blank strings are treated as missing, or StringNormalizationError::BlankRejected when blank strings are rejected.

Trait Implementations

impl Clone for StringConversionOptions

fn clone(&self) -> StringConversionOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StringConversionOptions

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

Formats the value using the given formatter.

impl Default for StringConversionOptions

fn default() -> Self

Creates default string conversion options.

impl<'de> Deserialize<'de> for StringConversionOptions

where StringConversionOptions: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for StringConversionOptions

impl PartialEq for StringConversionOptions

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for StringConversionOptions

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for StringConversionOptions