Struct rocket::error::LaunchError [−][src]
pub struct LaunchError { /* fields omitted */ }
Expand description
An error that occurs during launch.
A LaunchError
is returned by launch()
when
launching an application fails.
Panics
A value of this type panics if it is dropped without first being inspected.
An inspection occurs when any method is called. For instance, if
println!("Error: {}", e)
is called, where e: LaunchError
, the
Display::fmt
method being called by println!
results in e
being marked
as inspected; a subsequent drop
of the value will not result in a panic.
The following snippet illustrates this:
let error = rocket::ignite().launch(); // This line is only reached if launching failed. This "inspects" the error. println!("Launch failed! Error: {}", error); // This call to drop (explicit here for demonstration) will do nothing. drop(error);
When a value of this type panics, the corresponding error message is pretty printed to the console. The following illustrates this:
let error = rocket::ignite().launch(); // This call to drop (explicit here for demonstration) will result in // `error` being pretty-printed to the console along with a `panic!`. drop(error);
Usage
A LaunchError
value should usually be allowed to drop
without
inspection. There are two exceptions to this suggestion.
-
If you are writing a library or high-level application on-top of Rocket, you likely want to inspect the value before it drops to avoid a Rocket-specific
panic!
. This typically means simply printing the value. -
You want to display your own error messages.
Implementations
impl LaunchError
[src]
impl LaunchError
[src]pub fn kind(&self) -> &LaunchErrorKind
[src]
pub fn kind(&self) -> &LaunchErrorKind
[src]Retrieve the kind
of the launch error.
Example
let error = rocket::ignite().launch(); // This line is only reached if launch failed. let error_kind = error.kind();
Trait Implementations
impl Debug for LaunchError
[src]
impl Debug for LaunchError
[src]impl Display for LaunchError
[src]
impl Display for LaunchError
[src]impl Drop for LaunchError
[src]
impl Drop for LaunchError
[src]impl Error for LaunchError
[src]
impl Error for LaunchError
[src]fn description(&self) -> &str
[src]
fn description(&self) -> &str
[src]use the Display impl or to_string()
fn source(&self) -> Option<&(dyn Error + 'static)>
1.30.0[src]
fn source(&self) -> Option<&(dyn Error + 'static)>
1.30.0[src]The lower-level source of this error, if any. Read more
impl From<Error> for LaunchError
[src]
impl From<Error> for LaunchError
[src]fn from(error: Error) -> LaunchError
[src]
fn from(error: Error) -> LaunchError
[src]Performs the conversion.
impl From<Error> for LaunchError
[src]
impl From<Error> for LaunchError
[src]fn from(error: Error) -> LaunchError
[src]
fn from(error: Error) -> LaunchError
[src]Performs the conversion.
Auto Trait Implementations
impl !RefUnwindSafe for LaunchError
impl Send for LaunchError
impl Sync for LaunchError
impl Unpin for LaunchError
impl !UnwindSafe for LaunchError
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> IntoCollection<T> for T
[src]
impl<T> IntoCollection<T> for T
[src]pub fn into_collection<A>(self) -> SmallVec<A> where
A: Array<Item = T>,
[src]
pub fn into_collection<A>(self) -> SmallVec<A> where
A: Array<Item = T>,
[src]Converts self
into a collection.
pub fn mapped<U, F, A>(self, f: F) -> SmallVec<A> where
F: FnMut(T) -> U,
A: Array<Item = U>,
[src]
F: FnMut(T) -> U,
A: Array<Item = U>,
impl<T> Same<T> for T
impl<T> Same<T> for T
type Output = T
type Output = T
Should always be Self
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
impl<V, T> VZip<V> for T where
V: MultiLane<T>,