Struct URI 

pub struct URI(/* private fields */);

A Uniform Resource Identifier (URI).

A URI is a string of characters that unambiguously identifies a particular resource. This implementation validates URIs using the url crate to ensure conformance to RFC 3986.

URIs are commonly used for:

• Web addresses (URLs like “https://example.com”)
• Resource identifiers in various protocols
• Namespace identifiers
• References to resources in distributed systems

Implementations

impl URI

pub fn new(uri: impl Into<String>) -> Result<Self>

Creates a new URI from a string.

No validation is performed on the string.

Trait Implementations

impl AsRef<String> for URI

Implements AsRef<String> to allow URI to be treated as a String reference.

fn as_ref(&self) -> &String

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<URI> for URI

Implements AsRef<URI> to allow URI to reference itself.

fn as_ref(&self) -> &URI

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<str> for URI

Implements AsRef<str> to allow URI to be treated as a string slice.

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl CBORTagged for URI

Implements CBORTagged trait to provide CBOR tag information.

fn cbor_tags() -> Vec<Tag>

Returns the CBOR tags associated with this type.

impl CBORTaggedDecodable for URI

Implements CBORTaggedDecodable to provide CBOR decoding functionality.

fn from_untagged_cbor(cbor: CBOR) -> Result<Self>

Creates an instance of this type by decoding it from untagged CBOR.

fn from_tagged_cbor(cbor: CBOR) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from tagged CBOR.

fn from_tagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded tagged CBOR.

fn from_untagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded untagged CBOR.

impl CBORTaggedEncodable for URI

Implements CBORTaggedEncodable to provide CBOR encoding functionality.

fn untagged_cbor(&self) -> CBOR

Returns the untagged CBOR encoding of this instance.

fn tagged_cbor(&self) -> CBOR

Returns the tagged CBOR encoding of this instance.

fn tagged_cbor_data(&self) -> Vec<u8>

Returns the tagged value in CBOR binary representation.

impl Clone for URI

fn clone(&self) -> URI

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for URI

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

Formats the value using the given formatter.

impl Display for URI

Implements Display for URI to format as a string.

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

Formats the value using the given formatter.

impl From<&URI> for String

Implements conversion from URI reference to String.

fn from(uri: &URI) -> Self

Converts to this type from the input type.

impl From<URI> for CBOR

Implements conversion from URI to CBOR for serialization.

fn from(value: URI) -> Self

Converts to this type from the input type.

impl From<URI> for String

Implements conversion from URI to String.

fn from(uri: URI) -> Self

Converts to this type from the input type.

impl FromStr for URI

Implements string parsing to create a URI.

type Err = Error

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 URI

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 URI

fn eq(&self, other: &URI) -> 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 TryFrom<&str> for URI

Implements conversion from string slice to URI with validation.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(uri: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<CBOR> for URI

Implements TryFrom<CBOR> for URI to support conversion from CBOR data.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(cbor: CBOR) -> Result<Self>

Performs the conversion.

impl TryFrom<String> for URI

Implements conversion from String to URI with validation.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(uri: String) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for URI

impl StructuralPartialEq for URI