# actix_web::client::Connection - Rust
API documentation for the Rust `Connection` struct in crate `actix_web`.
Keywords: rust, rustlang, rust-lang, Connection

# [−] [src] Struct actix_web::client::Connection

    pub struct Connection { /* fields omitted */ }

HTTP client connection

## Methods

###

`impl Connection`

[src]

####

`pub fn stream(&mut self) -> &mut IoStream`

[src]

Raw IO stream

####
ⓘImportant traits for Connection

### Important traits for Connection

`impl Read for Connectionimpl Write for Connection`

`pub fn from_stream<T: IoStream + Send>(io: T) -> Connection`

[src]

Create a new connection from an IO Stream

The stream can be a `UnixStream` if the Unix-only "uds" feature is enabled.

See also `ClientRequestBuilder::with_connection()`.

####

`pub fn close(self)`

[src]

Close connection

####

`pub fn release(self)`

[src]

Release this connection to the connection pool

## Trait Implementations

###

`impl Debug for Connection`

[src]

####

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

[src]

Formats the value using the given formatter. Read more

###

`impl Read for Connection`

[src]

####

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

[src]

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

####

`unsafe fn initializer(&self) -> Initializer`

[src]

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

Determines if this `Read`er can work with buffers of uninitialized memory. Read more

####

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

1.0.0
[src]

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

####

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

1.0.0
[src]

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

####

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

1.6.0
[src]

Read the exact number of bytes required to fill `buf`. Read more

####

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

1.0.0
[src]

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

####

`fn bytes(self) -> Bytes<Self>`

1.0.0
[src]

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

####

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

1.0.0
[src]

Creates an adaptor which will chain this stream with another. Read more

####

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

1.0.0
[src]

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

###

`impl Write for Connection`

[src]

####

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

[src]

Write a buffer into this object, returning how many bytes were written. Read more

####

`fn flush(&mut self) -> Result<()>`

[src]

Flush this output stream, ensuring that all intermediately buffered contents reach their destination. Read more

####

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

1.0.0
[src]

Attempts to write an entire buffer into this write. Read more

####

`fn write_fmt(&mut self, fmt: Arguments) -> Result<(), Error>`

1.0.0
[src]

Writes a formatted string into this writer, returning any error encountered. Read more

####

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

1.0.0
[src]

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

###

`impl AsyncWrite for Connection`

[src]

####

`fn shutdown(&mut self) -> Poll<(), Error>`

[src]

Initiates or attempts to shut down this writer, returning success when the I/O connection has completely shut down. Read more

####

`fn poll_write(&mut self, buf: &[u8]) -> Result<Async<usize>, Error>`

[src]

Attempt to write bytes from `buf` into the object. Read more

####

`fn poll_flush(&mut self) -> Result<Async<()>, Error>`

[src]

Attempt to flush the object, ensuring that any buffered data reach their destination. Read more

####

`fn write_buf<B>(&mut self, buf: &mut B) -> Result<Async<usize>, Error> where B: Buf,`

[src]

Write a `Buf` into this value, returning how many bytes were written. Read more

###

`impl AsyncRead for Connection`

[src]

####

`unsafe fn prepare_uninitialized_buffer(&self, buf: &mut [u8]) -> bool`

[src]

Prepares an uninitialized buffer to be safe to pass to `read`. Returns `true` if the supplied buffer was zeroed out. Read more

####

`fn poll_read(&mut self, buf: &mut [u8]) -> Result<Async<usize>, Error>`

[src]

Attempt to read from the `AsyncRead` into `buf`. Read more

####

`fn read_buf<B>(&mut self, buf: &mut B) -> Result<Async<usize>, Error> where B: BufMut,`

[src]

Pull some bytes from this source into the specified `Buf`, returning how many bytes were read. Read more

####

`fn framed<T>(self, codec: T) -> Framed<Self, T> where Self: AsyncWrite, T: Decoder + Encoder,`

[src]

Deprecated since 0.1.7

: Use tokio_codec::Decoder::framed instead

Provides a `Stream` and `Sink` interface for reading and writing to this `Io` object, using `Decode` and `Encode` to read and write the raw data. Read more

####

`fn split(self) -> (ReadHalf<Self>, WriteHalf<Self>) where Self: AsyncWrite,`

[src]

Helper method for splitting this read/write object into two halves. Read more

## Auto Trait Implementations

###

`impl Send for Connection`

###

`impl !Sync for Connection`

## Blanket Implementations

###

`impl<T> From for T`

[src]

####

`fn from(t: T) -> T`

[src]

Performs the conversion.

###

`impl<T, U> Into for T where U: From<T>,`

[src]

####

`fn into(self) -> U`

[src]

Performs the conversion.

###

`impl<T, U> TryFrom for T where T: From<U>,`

[src]

#### `type Error = !`

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

The type returned in the event of a conversion error.

####

`fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>`

[src]

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

Performs the conversion.

###

`impl<T> Borrow for T where T: ?Sized,`

[src]

####

`fn borrow(&self) -> &T`

[src]

Immutably borrows from an owned value. Read more

###

`impl<T> BorrowMut for T where T: ?Sized,`

[src]

####

`fn borrow_mut(&mut self) -> &mut T`

[src]

Mutably borrows from an owned value. Read more

###

`impl<T, U> TryInto for T where U: TryFrom<T>,`

[src]

#### `type Error = <U as TryFrom<T>>::Error`

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

The type returned in the event of a conversion error.

####

`fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>`

[src]

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

Performs the conversion.

###

`impl<T> Any for T where T: 'static + ?Sized,`

[src]

####

`fn get_type_id(&self) -> TypeId`

[src]

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

this method will likely be replaced by an associated static

Gets the `TypeId` of `self`. Read more

###

`impl<R> ReadBytesExt for R where R: Read + ?Sized,`

####

`fn read_u8(&mut self) -> Result<u8, Error>` |

Reads an unsigned 8 bit integer from the underlying reader. Read more

####

`fn read_i8(&mut self) -> Result<i8, Error>` |

Reads a signed 8 bit integer from the underlying reader. Read more

####

`fn read_u16<T>(&mut self) -> Result<u16, Error> where T: ByteOrder,` |

Reads an unsigned 16 bit integer from the underlying reader. Read more

####

`fn read_i16<T>(&mut self) -> Result<i16, Error> where T: ByteOrder,` |

Reads a signed 16 bit integer from the underlying reader. Read more

####

`fn read_u24<T>(&mut self) -> Result<u32, Error> where T: ByteOrder,` |

Reads an unsigned 24 bit integer from the underlying reader. Read more

####

`fn read_i24<T>(&mut self) -> Result<i32, Error> where T: ByteOrder,` |

Reads a signed 24 bit integer from the underlying reader. Read more

####

`fn read_u32<T>(&mut self) -> Result<u32, Error> where T: ByteOrder,` |

Reads an unsigned 32 bit integer from the underlying reader. Read more

####

`fn read_i32<T>(&mut self) -> Result<i32, Error> where T: ByteOrder,` |

Reads a signed 32 bit integer from the underlying reader. Read more

####

`fn read_u48<T>(&mut self) -> Result<u64, Error> where T: ByteOrder,` |

Reads an unsigned 48 bit integer from the underlying reader. Read more

####

`fn read_i48<T>(&mut self) -> Result<i64, Error> where T: ByteOrder,` |

Reads a signed 48 bit integer from the underlying reader. Read more

####

`fn read_u64<T>(&mut self) -> Result<u64, Error> where T: ByteOrder,` |

Reads an unsigned 64 bit integer from the underlying reader. Read more

####

`fn read_i64<T>(&mut self) -> Result<i64, Error> where T: ByteOrder,` |

Reads a signed 64 bit integer from the underlying reader. Read more

####

`fn read_uint<T>(&mut self, nbytes: usize) -> Result<u64, Error> where T: ByteOrder,` |

Reads an unsigned n-bytes integer from the underlying reader. Read more

####

`fn read_int<T>(&mut self, nbytes: usize) -> Result<i64, Error> where T: ByteOrder,` |

Reads a signed n-bytes integer from the underlying reader. Read more

####

`fn read_f32<T>(&mut self) -> Result<f32, Error> where T: ByteOrder,` |

Reads a IEEE754 single-precision (4 bytes) floating point number from the underlying reader. Read more

####

`fn read_f64<T>(&mut self) -> Result<f64, Error> where T: ByteOrder,` |

Reads a IEEE754 double-precision (8 bytes) floating point number from the underlying reader. Read more

####

`fn read_u16_into<T>(&mut self, dst: &mut [u16]) -> Result<(), Error> where T: ByteOrder,` |

Reads a sequence of unsigned 16 bit integers from the underlying reader. Read more

####

`fn read_u32_into<T>(&mut self, dst: &mut [u32]) -> Result<(), Error> where T: ByteOrder,` |

Reads a sequence of unsigned 32 bit integers from the underlying reader. Read more

####

`fn read_u64_into<T>(&mut self, dst: &mut [u64]) -> Result<(), Error> where T: ByteOrder,` |

Reads a sequence of unsigned 64 bit integers from the underlying reader. Read more

####

`fn read_i16_into<T>(&mut self, dst: &mut [i16]) -> Result<(), Error> where T: ByteOrder,` |

Reads a sequence of signed 16 bit integers from the underlying reader. Read more

####

`fn read_i32_into<T>(&mut self, dst: &mut [i32]) -> Result<(), Error> where T: ByteOrder,` |

Reads a sequence of signed 32 bit integers from the underlying reader. Read more

####

`fn read_i64_into<T>(&mut self, dst: &mut [i64]) -> Result<(), Error> where T: ByteOrder,` |

Reads a sequence of signed 64 bit integers from the underlying reader. Read more

####

`fn read_f32_into<T>(&mut self, dst: &mut [f32]) -> Result<(), Error> where T: ByteOrder,` |

Reads a sequence of IEEE754 single-precision (4 bytes) floating point numbers from the underlying reader. Read more

####

`fn read_f32_into_unchecked<T>(&mut self, dst: &mut [f32]) -> Result<(), Error> where T: ByteOrder,` |

Deprecated since 1.2.0

: please use `read_f32_into` instead

DEPRECATED. Read more

####

`fn read_f64_into<T>(&mut self, dst: &mut [f64]) -> Result<(), Error> where T: ByteOrder,` |

Reads a sequence of IEEE754 double-precision (8 bytes) floating point numbers from the underlying reader. Read more

####

`fn read_f64_into_unchecked<T>(&mut self, dst: &mut [f64]) -> Result<(), Error> where T: ByteOrder,` |

Deprecated since 1.2.0

: please use `read_f64_into` instead

DEPRECATED. Read more

###

`impl<W> WriteBytesExt for W where W: Write + ?Sized,`

####

`fn write_u8(&mut self, n: u8) -> Result<(), Error>` |

Writes an unsigned 8 bit integer to the underlying writer. Read more

####

`fn write_i8(&mut self, n: i8) -> Result<(), Error>` |

Writes a signed 8 bit integer to the underlying writer. Read more

####

`fn write_u16<T>(&mut self, n: u16) -> Result<(), Error> where T: ByteOrder,` |

Writes an unsigned 16 bit integer to the underlying writer. Read more

####

`fn write_i16<T>(&mut self, n: i16) -> Result<(), Error> where T: ByteOrder,` |

Writes a signed 16 bit integer to the underlying writer. Read more

####

`fn write_u24<T>(&mut self, n: u32) -> Result<(), Error> where T: ByteOrder,` |

Writes an unsigned 24 bit integer to the underlying writer. Read more

####

`fn write_i24<T>(&mut self, n: i32) -> Result<(), Error> where T: ByteOrder,` |

Writes a signed 24 bit integer to the underlying writer. Read more

####

`fn write_u32<T>(&mut self, n: u32) -> Result<(), Error> where T: ByteOrder,` |

Writes an unsigned 32 bit integer to the underlying writer. Read more

####

`fn write_i32<T>(&mut self, n: i32) -> Result<(), Error> where T: ByteOrder,` |

Writes a signed 32 bit integer to the underlying writer. Read more

####

`fn write_u48<T>(&mut self, n: u64) -> Result<(), Error> where T: ByteOrder,` |

Writes an unsigned 48 bit integer to the underlying writer. Read more

####

`fn write_i48<T>(&mut self, n: i64) -> Result<(), Error> where T: ByteOrder,` |

Writes a signed 48 bit integer to the underlying writer. Read more

####

`fn write_u64<T>(&mut self, n: u64) -> Result<(), Error> where T: ByteOrder,` |

Writes an unsigned 64 bit integer to the underlying writer. Read more

####

`fn write_i64<T>(&mut self, n: i64) -> Result<(), Error> where T: ByteOrder,` |

Writes a signed 64 bit integer to the underlying writer. Read more

####

`fn write_uint<T>(&mut self, n: u64, nbytes: usize) -> Result<(), Error> where T: ByteOrder,` |

Writes an unsigned n-bytes integer to the underlying writer. Read more

####

`fn write_int<T>(&mut self, n: i64, nbytes: usize) -> Result<(), Error> where T: ByteOrder,` |

Writes a signed n-bytes integer to the underlying writer. Read more

####

`fn write_f32<T>(&mut self, n: f32) -> Result<(), Error> where T: ByteOrder,` |

Writes a IEEE754 single-precision (4 bytes) floating point number to the underlying writer. Read more

####

`fn write_f64<T>(&mut self, n: f64) -> Result<(), Error> where T: ByteOrder,` |

Writes a IEEE754 double-precision (8 bytes) floating point number to the underlying writer. Read more

###

`impl<T> Erased for T`

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g. `str,u8` or `String,struct:Vec,test`)