Struct idcurl::Response

pub struct Response { /* fields omitted */ }

Represents the result of an HTTP request

This object implements Read, which means you can read it in a streaming fashion or use the accessors to read it into memory.

Methods

impl Response

pub fn status(&self) -> StatusCode

Returns the HTTP status code.

is_success() is the most convenient way to make sure the message was received.

pub fn content_length(&self) -> Option<u64>

Gets the Content-Length of the returned body.

If the server reported the length of the returned body, then this returns it, and None if the server didn't specify. This value is available before the body is read with data() or text_as_utf8()

It may also be a lie.

pub fn text_as_utf8(&mut self) -> Result<String>

Read the entire document and interpret it as UTF-8.

Read the entire message body into memory.

pub fn copy_to<W: Write + ?Sized>(&mut self, w: &mut W) -> Result<u64>

Copies this Read object into another Write object

Returns the number of bytes read or an Error if the request failed at some point.

pub fn header<K: AsHeaderName>(&self, k: K) -> Option<&HeaderValue>

Gets a specific HTTP header by name

pub fn data(&mut self) -> Result<Vec<u8>>

Reads all data into a vector, emptying this Response

pub fn headers(&self) -> &HeaderMap

Gets a multimap of all HTTP headers received

pub fn remote_address(&self) -> Result<&str>

The remote ip address for this connection

Trait Implementations

impl Debug for Response

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

Formats the value using the given formatter.

impl Read for Response

fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_vectored(&mut self, bufs: &mut [IoSliceMut]) -> Result<usize, Error>

Like read, except that it reads into a slice of buffers.

unsafe fn initializer(&self) -> Initializer

🔬 This is a nightly-only experimental API. (read_initializer)

Determines if this Reader can work with buffers of uninitialized memory.

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>

Read all bytes until EOF in this source, placing them into buf.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>

Read all bytes until EOF in this source, appending them to buf.

fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>

Read the exact number of bytes required to fill buf.

fn by_ref(&mut self) -> &mut Self

Creates a "by reference" adaptor for this instance of Read.

fn bytes(self) -> Bytes<Self>

Transforms this Read instance to an [Iterator] over its bytes.

fn chain<R>(self, next: R) -> Chain<Self, R> where
    R: Read, 

Creates an adaptor which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

Creates an adaptor which will read at most limit bytes from it.