Struct fidl::client::Client

pub struct Client { /* private fields */ }

A FIDL client which can be used to send buffers and receive responses via a channel.

Implementations

impl Client

pub fn new(channel: AsyncChannel, protocol_name: &'static str) -> Client

Create a new client.

channel is the asynchronous channel over which data is sent and received. event_ordinals are the ordinals on which events will be received.

pub fn as_channel(&self) -> &AsyncChannel

Get a reference to the client’s underlying channel.

pub fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the Client back into a channel.

This will only succeed if there are no active clones of this Client, no currently-alive EventReceiver or MessageResponses that came from this Client, and no outstanding messages awaiting a response, even if that response will be discarded.

pub fn take_event_receiver(&self) -> EventReceiver

Retrieve the stream of event messages for the Client. Panics if the stream was already taken.

pub fn send<T: TypeMarker>( &self, body: impl Encode<T>, ordinal: u64, dynamic_flags: DynamicFlags ) -> Result<(), Error>

Encodes and sends a request without expecting a response.

pub fn send_query<Request: TypeMarker, Response: TypeMarker, const ORDINAL: u64>( &self, body: impl Encode<Request>, dynamic_flags: DynamicFlags ) -> QueryResponseFut<Response::Owned>

Encodes and sends a request. Returns a future that decodes the response.

pub fn send_query_and_decode<Request: TypeMarker, Output>( &self, body: impl Encode<Request>, ordinal: u64, dynamic_flags: DynamicFlags, decode: fn(_: Result<MessageBufEtc, Error>) -> Result<Output, Error> ) -> QueryResponseFut<Output>

Encodes and sends a request. Returns a future that decodes the response using the given decode function.

pub fn send_raw( &self, bytes: &[u8], handles: &mut [HandleDisposition<'_>] ) -> Result<(), Error>

Sends a raw message without expecting a response.

pub fn send_raw_query<F>(&self, encode_msg: F) -> Result<MessageResponse, Error>

where F: for<'a, 'b> FnOnce(Txid, &'a mut Vec<u8>, &'b mut Vec<HandleDisposition<'static>>) -> Result<(), Error>,

Sends a raw query and receives a response future.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.