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

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

    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

####

`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

####
ⓘImportant traits for &'a mut R

### Important traits for &'a mut R

`impl<'a, R> Read for &'a mut R where
R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;`

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

1.0.0
[src]

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

####
ⓘImportant traits for Bytes<R>

### Important traits for Bytes<R>

`impl<R> Iterator for Bytes<R> where
R: Read, type Item = Result<u8, Error>;`

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

1.0.0
[src]

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

####
ⓘImportant traits for Chars<R>

### Important traits for Chars<R>

`impl<R> Iterator for Chars<R> where
R: Read, type Item = Result<char, CharsError>;`

`fn chars(self) -> Chars<Self>`

[src]

Deprecated since 1.27.0

: Use str::from_utf8 instead: https://doc.rust-lang.org/nightly/std/str/struct.Utf8Error.html#examples

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

the semantics of a partial read/write of where errors happen is currently unclear and may change

Transforms this `Read` instance to an [`Iterator`] over [`char`]s. Read more

####
ⓘImportant traits for Chain<T, U>

### Important traits for Chain<T, U>

`impl<T, U> Read for Chain<T, U> where
T: Read,
U: Read,`

`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

####
ⓘImportant traits for Take<T>

### Important traits for Take<T>

`impl<T> Read for Take<T> where
T: Read,`

`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 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

###

`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

####
ⓘImportant traits for &'a mut R

### Important traits for &'a mut R

`impl<'a, R> Read for &'a mut R where
R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;`

`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

## Auto Trait Implementations

###

`impl Send for Connection`

###

`impl !Sync for Connection`

# 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`)