Struct RawJsonMember

pub struct RawJsonMember<'text, 'raw, 'a> { /* private fields */ }

Represents a member access result for a JSON object.

This struct is returned by RawJsonValue::to_member() and allows you to handle both present and missing object members. It wraps an optional value that is Some if the member exists and None if it doesn’t.

Examples

let json = RawJson::parse(r#"{"name": "Alice", "age": 30}"#)?;
let obj = json.value();

// Access an existing member
let name_member = obj.to_member("name")?;
let name: String = name_member.required()?.try_into()?;
assert_eq!(name, "Alice");

// Access a missing member
let city_member = obj.to_member("city")?;
let city: Option<String> = city_member.try_into()?;
assert_eq!(city, None);

Implementations

impl<'text, 'raw, 'a> RawJsonMember<'text, 'raw, 'a>

pub fn required(self) -> Result<RawJsonValue<'text, 'raw>, JsonParseError>

Returns the member value if it exists, or an error if it’s missing.

This method is useful when you need to ensure that a required member is present in the JSON object.

Examples

let json = RawJson::parse(r#"{"name": "Alice"}"#)?;
let obj = json.value();

// Required member exists
let name = obj.to_member("name")?.required()?;
assert_eq!(name.to_unquoted_string_str()?, "Alice");

// Required member missing - returns error
let age_result = obj.to_member("age")?.required();
assert!(age_result.is_err());

Trait Implementations

impl<'text, 'raw, 'a> Clone for RawJsonMember<'text, 'raw, 'a>

fn clone(&self) -> RawJsonMember<'text, 'raw, 'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'text, 'raw, 'a> Debug for RawJsonMember<'text, 'raw, 'a>

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

Formats the value using the given formatter.

impl<'text, 'raw, 'a> Hash for RawJsonMember<'text, 'raw, 'a>

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<'text, 'raw, 'a> Ord for RawJsonMember<'text, 'raw, 'a>

fn cmp(&self, other: &RawJsonMember<'text, 'raw, 'a>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'text, 'raw, 'a> PartialEq for RawJsonMember<'text, 'raw, 'a>

fn eq(&self, other: &RawJsonMember<'text, 'raw, 'a>) -> 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<'text, 'raw, 'a> PartialOrd for RawJsonMember<'text, 'raw, 'a>

fn partial_cmp( &self, other: &RawJsonMember<'text, 'raw, 'a>, ) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'text, 'raw, 'a, T> TryFrom<RawJsonMember<'text, 'raw, 'a>> for Option<T>

where T: TryFrom<RawJsonValue<'text, 'raw>>, JsonParseError: From<T::Error>,

type Error = JsonParseError

The type returned in the event of a conversion error.

fn try_from(value: RawJsonMember<'text, 'raw, 'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'text, 'raw, 'a> Copy for RawJsonMember<'text, 'raw, 'a>

impl<'text, 'raw, 'a> Eq for RawJsonMember<'text, 'raw, 'a>

impl<'text, 'raw, 'a> StructuralPartialEq for RawJsonMember<'text, 'raw, 'a>