Struct iri_string::percent_encode::PercentEncoded

source · [−]

pub struct PercentEncoded<T, S> { /* private fields */ }

Expand description

A proxy to percent-encode a string.

Type aliases PercentEncodedForUri and PercentEncodedForUri are provided. You can use them to make the expression simpler, for example write PercentEncodedForUri::from_path(foo) instead of PercentEncoded::<_, UriSpec>::from_path(foo).

Implementations

source

impl<T: Display, S: Spec> PercentEncoded<T, S>

source

pub fn from_reg_name(raw: T) -> Self

Creates an encoded string from a raw reg-name (i.e. hostname or domain).

Examples

use iri_string::percent_encode::PercentEncoded;
use iri_string::spec::UriSpec;

let raw = "alpha.\u{03B1}.example.com";
let encoded = "alpha.%CE%B1.example.com";
assert_eq!(
    PercentEncoded::<_, UriSpec>::from_reg_name(raw).to_string(),
    encoded
);

source

pub fn from_user(raw: T) -> Self

Creates an encoded string from a raw user name (inside userinfo component).

Examples

use iri_string::percent_encode::PercentEncoded;
use iri_string::spec::UriSpec;

let raw = "user:\u{03B1}";
// The first `:` will be interpreted as a delimiter, so colons will be escaped.
let encoded = "user%3A%CE%B1";
assert_eq!(
    PercentEncoded::<_, UriSpec>::from_user(raw).to_string(),
    encoded
);

source

pub fn from_password(raw: T) -> Self

Creates an encoded string from a raw user name (inside userinfo component).

Examples

use iri_string::percent_encode::PercentEncoded;
use iri_string::spec::UriSpec;

let raw = "password:\u{03B1}";
// The first `:` will be interpreted as a delimiter, and the colon
// inside the password will be the first one if the user name is empty,
// so colons will be escaped.
let encoded = "password%3A%CE%B1";
assert_eq!(
    PercentEncoded::<_, UriSpec>::from_password(raw).to_string(),
    encoded
);

source

pub fn from_path_segment(raw: T) -> Self

Creates an encoded string from a raw path segment.

Examples

use iri_string::percent_encode::PercentEncoded;
use iri_string::spec::UriSpec;

let raw = "alpha/\u{03B1}?#";
// Note that `/` is encoded to `%2F`.
let encoded = "alpha%2F%CE%B1%3F%23";
assert_eq!(
    PercentEncoded::<_, UriSpec>::from_path_segment(raw).to_string(),
    encoded
);

source

pub fn from_path(raw: T) -> Self

Creates an encoded string from a raw path.

Examples

use iri_string::percent_encode::PercentEncoded;
use iri_string::spec::UriSpec;

let raw = "alpha/\u{03B1}?#";
// Note that `/` is NOT percent encoded.
let encoded = "alpha/%CE%B1%3F%23";
assert_eq!(
    PercentEncoded::<_, UriSpec>::from_path(raw).to_string(),
    encoded
);

source

pub fn from_query(raw: T) -> Self

Creates an encoded string from a raw query.

Examples

use iri_string::percent_encode::PercentEncoded;
use iri_string::spec::UriSpec;

let raw = "alpha/\u{03B1}?#";
let encoded = "alpha/%CE%B1?%23";
assert_eq!(
    PercentEncoded::<_, UriSpec>::from_query(raw).to_string(),
    encoded
);

source

pub fn from_fragment(raw: T) -> Self

Creates an encoded string from a raw fragment.

Examples

use iri_string::percent_encode::PercentEncoded;
use iri_string::spec::UriSpec;

let raw = "alpha/\u{03B1}?#";
let encoded = "alpha/%CE%B1?%23";
assert_eq!(
    PercentEncoded::<_, UriSpec>::from_fragment(raw).to_string(),
    encoded
);