Struct iri_string::resolve::FixedBaseResolver

pub struct FixedBaseResolver<'a, S: Spec> { /* private fields */ }

A resolver against the fixed base.

If you want more control over how to resolve the buffer, create ResolutionTask by create_task method.

Implementations

impl<'a, S: Spec> FixedBaseResolver<'a, S>

pub fn new(base: &'a RiAbsoluteStr<S>) -> Self

Creates a new resolver with the given base.

Examples

use iri_string::resolve::FixedBaseResolver;
use iri_string::types::{IriAbsoluteStr, IriReferenceStr};

let base = IriAbsoluteStr::new("http://example.com/base/")?;
let resolver = FixedBaseResolver::new(base);

let reference = IriReferenceStr::new("../there")?;
let resolved = resolver.resolve(reference)?;

assert_eq!(resolved, "http://example.com/there");

impl<'a, S: Spec> FixedBaseResolver<'a, S>

pub fn resolve(
    &self,
    reference: &RiReferenceStr<S>
) -> Result<RiString<S>, Error>

Resolves the given reference against the fixed base.

Enabled by alloc or std feature.

Failures

This fails if

• memory allocation failed, or
• the IRI referernce is unresolvable against the base.

To see examples of unresolvable IRIs, visit the documentation for resolve::Error.

Examples

use iri_string::resolve::FixedBaseResolver;
use iri_string::types::{IriAbsoluteStr, IriReferenceStr};

let base = IriAbsoluteStr::new("http://example.com/base/")?;
let resolver = FixedBaseResolver::new(base);

let reference = IriReferenceStr::new("../there")?;
let resolved = resolver.resolve(reference)?;

assert_eq!(resolved, "http://example.com/there");

pub fn create_task(
    &self,
    reference: &'a RiReferenceStr<S>
) -> ResolutionTask<'a, S>

Creates a resolution task.

The returned ResolutionTask allows you to resolve the IRI without memory allocation, resolve to existing buffers, estimate required memory size, etc. If you need more control than resolve method, use this.

Examples

use iri_string::resolve::FixedBaseResolver;
use iri_string::types::{IriAbsoluteStr, IriReferenceStr};

let base = IriAbsoluteStr::new("http://example.com/base/")?;
let resolver = FixedBaseResolver::new(base);

let reference = IriReferenceStr::new("../there")?;
let task = resolver.create_task(reference);

let resolved = task.allocate_and_write()?;
assert_eq!(resolved, "http://example.com/there");

Trait Implementations

impl<'a, S: Clone + Spec> Clone for FixedBaseResolver<'a, S>

fn clone(&self) -> FixedBaseResolver<'a, S>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, S: Debug + Spec> Debug for FixedBaseResolver<'a, S>

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

Formats the value using the given formatter.

impl<'a, S: Copy + Spec> Copy for FixedBaseResolver<'a, S>