Struct Request

#[repr(C)]
pub struct Request<'a> { /* private fields */ }

A dynamic request for an object based on its type.

Implementations

impl<'a> Request<'a>

pub fn provide_ref<T: ?Sized + 'static>( self: Pin<&mut Self>, value: &'a T, ) -> Pin<&mut Self>

Provides a reference of type &'a T in response to this request.

If a reference of type &'a T has already been provided for this request, the existing value will be replaced by the newly provided value.

This method can be chained within provide implementations to concisely provide multiple objects.

pub fn provide_ref_with<T: ?Sized + 'static, F>( self: Pin<&mut Self>, cb: F, ) -> Pin<&mut Self>

where F: FnOnce() -> &'a T,

Lazily provides a reference of type &'a T in response to this request.

If a reference of type &'a T has already been provided for this request, the existing value will be replaced by the newly provided value.

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

This method can be chained within provide implementations to concisely provide multiple objects.

pub fn provide_value<T: 'static>( self: Pin<&mut Self>, value: T, ) -> Pin<&mut Self>

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

If a value of type T has already been provided for this request, the existing value will be replaced by the newly provided value.

This method can be chained within provide implementations to concisely provide multiple objects.

pub fn provide_value_with<T: 'static, F>( self: Pin<&mut Self>, cb: F, ) -> Pin<&mut Self>

where F: FnOnce() -> T,

Lazily provides a value of type T in response to this request.

If a value of type T has already been provided for this request, the existing value will be replaced by the newly provided value.

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

This method can be chained within provide implementations to concisely provide multiple objects.

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

Returns true if the requested type is &'a T

pub fn is_value<T: 'static>(&self) -> bool

Returns true if the requested type is T

pub fn request_ref<T: ?Sized + 'static, F>(f: F) -> Option<&'a T>

where F: FnOnce(Pin<&mut Request<'a>>),

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

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

pub fn request_value<T: 'static, F>(f: F) -> Option<T>

where F: FnOnce(Pin<&mut Request<'a>>),

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<'a> Debug for Request<'a>

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

Formats the value using the given formatter.