Struct x11rb::cookie::Cookie

pub struct Cookie<'a, C, R>
where
    C: RequestConnection + ?Sized,
{ /* private fields */ }

A handle to a response from the X11 server.

When sending a request to the X11 server, this library returns a Cookie. This Cookie can then later be used to get the response that the server sent.

See crate::cookie for infos on the different ways to handle X11 errors in response to a request.

Implementations

impl<C, R> Cookie<'_, C, R>

where R: TryParse, C: RequestConnection + ?Sized,

pub fn new(connection: &C, sequence_number: SequenceNumber) -> Cookie<'_, C, R>

Construct a new cookie.

This function should only be used by implementations of RequestConnection::send_request_with_reply.

pub fn sequence_number(&self) -> SequenceNumber

Get the sequence number of the request that generated this cookie.

pub fn raw_reply(self) -> Result<C::Buf, ReplyError>

Get the raw reply that the server sent.

pub fn raw_reply_unchecked(self) -> Result<Option<C::Buf>, ConnectionError>

Get the raw reply that the server sent, but have errors handled as events.

pub fn reply(self) -> Result<R, ReplyError>

Get the reply that the server sent.

pub fn reply_unchecked(self) -> Result<Option<R>, ConnectionError>

Get the reply that the server sent, but have errors handled as events.

pub fn discard_reply_and_errors(self)

Discard all responses to the request this cookie represents, even errors.

Without this function, errors are treated as events after the cookie is dropped.

Trait Implementations

impl<'a, C, R: Debug> Debug for Cookie<'a, C, R>

where C: RequestConnection + ?Sized + Debug,

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

Formats the value using the given formatter.