Struct XPath 

pub struct XPath { /* private fields */ }

Cross Path allowing to recursively retrieve a FieldValue from a structure implementing FieldGetter.

Example:

use ::gene_derive::FieldGetter;
use ::gene::{XPath, FieldGetter, FieldValue};

#[derive(FieldGetter)]
struct LogData
{
    a: String,
    b: i32,
    c: f64,
}

#[derive(FieldGetter)]
struct LogEntry
{
    name: String,
    data: LogData,
}

let e = LogEntry{
    name: "SomeEntry".into(),
    data: LogData{
        a: "SomeData".into(),
        b: 42,
        c: 24.0,
    }
};

let p = XPath::parse(".name").unwrap();
assert_eq!(e.get_from_path(&p), Some("SomeEntry".into()));

let p = XPath::parse(".data.a").unwrap();
assert_eq!(e.get_from_path(&p), Some("SomeData".into()));

let p = XPath::parse(".data.b").unwrap();
assert_eq!(e.get_from_path(&p), Some(42.into()));

let p = XPath::parse(".data.c").unwrap();
assert_eq!(e.get_from_path(&p), Some(24.0.into()));

Implementations

impl XPath

pub fn parse<S: AsRef<str>>(s: S) -> Result<Self, PathError>

builds an XPath from a str

pub fn segments(&self) -> &Vec<String>

getter to the segments of the path. If a path has been built from .a.b.c the segments will be ["a", "b", "c"] as . is the path segments separator

pub fn iter_segments(&self) -> Iter<'_, String>

provides an iterator over the segments of the path

pub fn to_string_lossy(&self) -> Cow<'_, str>

Trait Implementations

impl Clone for XPath

fn clone(&self) -> XPath

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for XPath

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

Formats the value using the given formatter.

impl Display for XPath

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

Formats the value using the given formatter.

impl FromStr for XPath

type Err = PathError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for XPath

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 XPath

fn eq(&self, other: &Self) -> 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 Eq for XPath