Struct egg_mode::Response

pub struct Response<T> {
    pub rate_limit: i32,
    pub rate_limit_remaining: i32,
    pub rate_limit_reset: i32,
    pub response: T,
}

A helper struct to wrap response data with accompanying rate limit information.

This is returned by any function that calls a rate-limited method on Twitter, to allow for inline checking of the rate-limit information without an extra call to service::rate_limit_info.

As this implements Deref and DerefMut, you can transparently use the contained response's methods as if they were methods on this struct.

Fields

rate_limit: i32

The rate limit ceiling for the given request.

rate_limit_remaining: i32

The number of requests left for the 15-minute window.

rate_limit_reset: i32

The UTC Unix timestamp at which the rate window resets.

response: T

The decoded response from the request.

Methods

impl<T> Response<T>

pub fn map<F, U>(src: Response<T>, fun: F) -> Response<U> where
    F: FnOnce(T) -> U, 

Convert a Response<T> to a Response<U> by running its contained response through the given function. This preserves its rate-limit information.

Note that this is not a member function, so as to not conflict with potential methods on the contained T.

impl<T> Response<Vec<T>>

Important traits for ResponseIterRef<'a, T>

impl<'a, T> Iterator for ResponseIterRef<'a, T> where
    T: 'a,  type Item = Response<&'a T>;

pub fn iter(&self) -> ResponseIterRef<T>

Returns an iterator that yields references into the returned collection, alongside rate-limit information for the whole method call.

Important traits for ResponseIterMut<'a, T>

impl<'a, T> Iterator for ResponseIterMut<'a, T> where
    T: 'a,  type Item = Response<&'a mut T>;

pub fn iter_mut(&mut self) -> ResponseIterMut<T>

Returns an iterator that yields mutable references into the returned collection, alongside rate-limit information for the whole method call.

Trait Implementations

impl<'a, T> IntoIterator for &'a Response<Vec<T>> where
    T: 'a, 

Iteration over a response that returned a collection, while leaving the response in place.

type Item = Response<&'a T>

The type of the elements being iterated over.

type IntoIter = ResponseIterRef<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T> IntoIterator for &'a mut Response<Vec<T>> where
    T: 'a, 

Mutable iteration over a response that returned a collection, while leaving the response in place.

type Item = Response<&'a mut T>

The type of the elements being iterated over.

type IntoIter = ResponseIterMut<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T> IntoIterator for Response<Vec<T>>

Iteration over a response that returned a collection, copying the rate limit information across all values.

type Item = Response<T>

The type of the elements being iterated over.

type IntoIter = ResponseIter<T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T> DerefMut for Response<T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T> Deref for Response<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: Debug> Debug for Response<T>

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

Formats the value using the given formatter.

impl<T> FromIterator<Response<T>> for Response<Vec<T>>

FromIterator impl that allows collecting several responses into one, preserving the latest rate limit information.

fn from_iter<I>(iter: I) -> Self where
    I: IntoIterator<Item = Response<T>>, 

Creates a value from an iterator.

impl<'de, T> Deserialize<'de> for Response<T> where
    T: Deserialize<'de>,
    T: Default, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.