pub struct Builder { /* private fields */ }
Expand description
A builder for Uri
s.
This type can be used to construct an instance of Uri
through a builder pattern.
Implementations
sourceimpl Builder
impl Builder
sourcepub fn new() -> Builder
pub fn new() -> Builder
Creates a new default instance of Builder
to construct a Uri
.
Examples
let uri = uri::Builder::new()
.scheme("https")
.authority("hyper.rs")
.path_and_query("/")
.build()
.unwrap();
sourcepub fn scheme<T>(self, scheme: T) -> Self where
Scheme: TryFrom<T>,
<Scheme as TryFrom<T>>::Error: Into<Error>,
pub fn scheme<T>(self, scheme: T) -> Self where
Scheme: TryFrom<T>,
<Scheme as TryFrom<T>>::Error: Into<Error>,
Set the Scheme
for this URI.
Examples
let mut builder = uri::Builder::new();
builder.scheme("https");
Set the Authority
for this URI.
Examples
let uri = uri::Builder::new()
.authority("tokio.rs")
.build()
.unwrap();
sourcepub fn path_and_query<T>(self, p_and_q: T) -> Self where
PathAndQuery: TryFrom<T>,
<PathAndQuery as TryFrom<T>>::Error: Into<Error>,
pub fn path_and_query<T>(self, p_and_q: T) -> Self where
PathAndQuery: TryFrom<T>,
<PathAndQuery as TryFrom<T>>::Error: Into<Error>,
Set the PathAndQuery
for this URI.
Examples
let uri = uri::Builder::new()
.path_and_query("/hello?foo=bar")
.build()
.unwrap();
sourcepub fn build(self) -> Result<Uri, Error>
pub fn build(self) -> Result<Uri, Error>
Consumes this builder, and tries to construct a valid Uri
from
the configured pieces.
Errors
This function may return an error if any previously configured argument
failed to parse or get converted to the internal representation. For
example if an invalid scheme
was specified via scheme("!@#%/^")
the error will be returned when this function is called rather than
when scheme
was called.
Additionally, the various forms of URI require certain combinations of parts to be set to be valid. If the parts don’t fit into any of the valid forms of URI, a new error is returned.
Examples
let uri = Uri::builder()
.build()
.unwrap();
Trait Implementations
Auto Trait Implementations
impl RefUnwindSafe for Builder
impl Send for Builder
impl Sync for Builder
impl Unpin for Builder
impl UnwindSafe for Builder
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more