Struct object_provider::Request

pub struct Request<'r, 'out> { /* fields omitted */ }

A dynamic request for an object based on its type.

'r is the lifetime of request, and 'out is the lifetime of the requested reference.

Methods

impl<'r, 'out> Request<'r, 'out>

pub fn provide<T: ?Sized + 'static>(
    self,
    value: &'out T
) -> ProvideResult<'r, 'out>

Provides an object of type T in response to this request.

Returns Err(FulfilledRequest) if the value was successfully provided, and Ok(self) if T was not the type being requested.

This method can be chained within provide implementations using the ? operator to concisely provide multiple objects.

pub fn provide_with<T: ?Sized + 'static, F>(
    self,
    cb: F
) -> ProvideResult<'r, 'out> where
    F: FnOnce() -> &'out T, 

Lazily provides an object of type T in response to this request.

Returns Err(FulfilledRequest) if the value was successfully provided, and Ok(self) if T was not the type being requested.

The passed closure is only called if the value will be successfully provided.

This method can be chained within provide implementations using the ? operator to concisely provide multiple objects.

pub fn type_id(&self) -> TypeId

Get the TypeId of the requested type.

pub fn is<T: ?Sized + 'static>(&self) -> bool

Returns true if the requested type is the same as T

pub fn with<T: ?Sized + 'static, F>(f: F) -> Option<&'out T> where
    F: FnOnce(Request<'a, 'out>) -> ProvideResult<'a, 'out>, 

Calls the provided closure with a request for the the type T, returning Some(&T) if the request was fulfilled, and None otherwise.

The ObjectProviderExt trait provides helper methods specifically for types implementing ObjectProvider.

Trait Implementations

impl<'r, 'out> Debug for Request<'r, 'out>

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

Formats the value using the given formatter.