Struct rpki::uri::Https

pub struct Https { /* private fields */ }

A simple HTTPS URI.

This is only a slim wrapper around a Bytes value ensuring that the scheme is "https".

Implementations

impl Https

pub fn from_string(s: String) -> Result<Self, Error>

pub fn from_slice(slice: &[u8]) -> Result<Self, Error>

pub fn from_bytes(bytes: Bytes) -> Result<Self, Error>

pub fn unshare(&mut self)

Moves the URI to its own memory.

Values use shared memory in order to allow cheap copying which may result in large allocations being kept around longer than necessary. This method moves the URI to a new memory location allowing the previous location to potentially be freed.

pub fn as_slice(&self) -> &[u8]

Returns a octets slice reference of the URI.

pub fn as_str(&self) -> &str

Returns a string reference of the URI.

pub fn scheme(&self) -> Scheme

pub fn authority(&self) -> &str

Returns the URI’s authority part as a string slice.

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

Returns a canonical version of authority part.

Since host names are case-insensitive, the authority part can be provided in different ways. This returns a version of the authority with all ASCII letters in lowercase.

pub fn encode_general_name(&self) -> impl Values + '_

pub fn path(&self) -> &str

Returns the URI’s path as a string slice.

The path does not start with a slash. As a consequence, an empty path results in an empty string.

pub fn join(&self, path: &[u8]) -> Result<Self, Error>

This function will join this URI and the given path. If the current URI does not end with a trailing ‘/’, it will be injected.

pub fn parent(&self) -> Option<Self>

Returns the parent URI.

The parent URI is the URI with the last path segment removed. If a URI has no path segment, the method returns None. If a URI is returned, it’s path will have a trailing slash to indicate that it is a directory.

Keep in mind that a URI with an empty path will still have the module name after the authority part. The method will never return a URI with an empty module name.

pub fn eq_authority(&self, other: &Self) -> bool

Returns whether the two URIs have the same authority.

Trait Implementations

impl<'a> Arbitrary<'a> for Https

fn arbitrary(u: &mut Unstructured<'_>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl AsRef<[u8]> for Https

fn as_ref(&self) -> &[u8]

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

impl AsRef<Bytes> for Https

fn as_ref(&self) -> &Bytes

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

impl AsRef<str> for Https

fn as_ref(&self) -> &str

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

impl Clone for Https

fn clone(&self) -> Https

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Https

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Https

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Https

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

Formats the value using the given formatter.

impl From<Https> for TalUri

fn from(uri: Https) -> Self

Converts to this type from the input type.

impl FromStr for Https

type Err = Error

The associated error which can be returned from parsing.

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

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

impl Hash for Https

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 Https

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PrimitiveContent for &'a Https

const TAG: Tag = Tag::IA5_STRING

The natural tag of an encoded value of this type.

fn encoded_len(&self, _: Mode) -> usize

Returns the length of the encoded content of this type.

fn write_encoded<W: Write>( &self, _mode: Mode, target: &mut W, ) -> Result<(), Error>

Writes the encoded content to a writer.

fn to_encoded_bytes(&self, mode: Mode) -> Bytes

Encodes the value to bytes (useful when you need to sign a structure)

fn encode(self) -> Primitive<Self>

Returns a value encoder for this content using the natural tag.

fn encode_as(self, tag: Tag) -> Primitive<Self>

Returns a value encoder for this content using the given tag.

fn encode_ref(&self) -> Primitive<&Self>

Returns a value encoder for a reference using the natural tag.

fn encode_ref_as(&self, tag: Tag) -> Primitive<&Self>

Returns a value encoder for a reference using the given tag.

impl Serialize for Https

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<String> for Https

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Eq for Https