Struct Connection 

pub struct Connection<IO> { /* private fields */ }

A blocking connection to an MPD server.

Implementations

impl<IO> Connection<IO>

pub fn connect(io: IO) -> Result<Connection<IO>, MpdProtocolError>

where IO: Read,

Connect to an MPD server synchronously.

pub fn send(&mut self, command: Command) -> Result<(), MpdProtocolError>

where IO: Write,

Send a command.

Errors

This will return an error if writing to the given IO resource fails.

pub fn send_list( &mut self, command_list: CommandList, ) -> Result<(), MpdProtocolError>

where IO: Write,

Send a command list.

Errors

This will return an error if writing to the given IO resource fails.

pub fn receive(&mut self) -> Result<Option<Response>, MpdProtocolError>

where IO: Read,

Receive a response from the server.

This will return Ok(Some(..)) when a complete response has been received, or Ok(None) if the connection is closed cleanly.

Errors

This will return an error if:

• Reading from the given IO resource returns an error
• Malformed response data is received
• The connection is closed while a response is in progress

pub fn command( &mut self, command: Command, ) -> Result<Response, MpdProtocolError>

where IO: Read + Write,

Send a command and receive its response.

This is essentially a shorthand for Connection::send followed by Connection::receive.

Errors

This will return an error if:

• Writing to or reading from the connection returns an error
• Malformed response data is received
• The connection is closed

pub fn command_list( &mut self, command_list: CommandList, ) -> Result<Response, MpdProtocolError>

where IO: Read + Write,

Send a command list and receive its response(s).

This is essentially a shorthand for Connection::send_list followed by Connection::receive.

Errors

This will return an error if:

• Writing to or reading from the connection returns an error
• Malformed response data is received
• The connection is closed

pub fn protocol_version(&self) -> &str

Returns the protocol version the server is using.

pub fn into_inner(self) -> IO

Extract the connection instance.

Trait Implementations

impl<IO: Debug> Debug for Connection<IO>

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

Formats the value using the given formatter.