Struct Request

#[non_exhaustive]
pub struct Request {
    pub room_id: OwnedRoomId,
    pub ts: MilliSecondsSinceUnixEpoch,
    pub dir: Direction,
}

Request type for the get_event_by_timestamp endpoint.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

room_id: OwnedRoomId

The ID of the room the event is in.

ts: MilliSecondsSinceUnixEpoch

The timestamp to search from, inclusively.

dir: Direction

The direction in which to search.

Implementations

impl Request

pub fn new( room_id: OwnedRoomId, ts: MilliSecondsSinceUnixEpoch, dir: Direction, ) -> Self

Creates a new Request with the given room ID, timestamp and direction.

pub fn until(room_id: OwnedRoomId, ts: MilliSecondsSinceUnixEpoch) -> Self

Creates a new Request with the given room ID and timestamp, and the direction set to Backward.

Allows to have the latest event before or including the given timestamp.

pub fn since(room_id: OwnedRoomId, ts: MilliSecondsSinceUnixEpoch) -> Self

Creates a new Request with the given room ID and timestamp, and the direction set to Forward.

Allows to have the earliest event including or after the given timestamp.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl OutgoingRequest for Request

const METADATA: Metadata = METADATA

Metadata about the endpoint.

type EndpointError = Error

A type capturing the expected error conditions the server can return.

type IncomingResponse = Response

Response type returned when the request is successful.

fn try_into_http_request<T: Default + BufMut>( self, base_url: &str, access_token: SendAccessToken<'_>, considering_versions: &[MatrixVersion], ) -> Result<Request<T>, IntoHttpError>

Tries to convert this request into an http::Request.