# Struct ethcore_util::standard::io::Take 1.0.0 [−] [src]

    pub struct Take<T> { /* fields omitted */ }

Reader adaptor which limits the bytes read from an underlying reader.

This struct is generally created by calling `take()` on a reader. Please see the documentation of `take()` for more details.

## Methods

### `impl<T> Take<T>`

#### `fn limit(&self) -> u64`

Returns the number of bytes that can be read before this instance will return EOF.

# Note

This instance may reach EOF after reading fewer bytes than indicated by this method if the underlying `Read` instance reaches EOF.

# Examples

    use std::io;
    use std::io::prelude::*;
    use std::fs::File;

    let f = try!(File::open("foo.txt"));

    // read at most five bytes
    let handle = f.take(5);

    println!("limit: {}", handle.limit());

#### `fn into_inner(self) -> T`

Unstable (`io_take_into_inner`)

Consumes the `Take`, returning the wrapped reader.

# Examples

    #![feature(io_take_into_inner)]

    use std::io;
    use std::io::prelude::*;
    use std::fs::File;

    let mut file = try!(File::open("foo.txt"));

    let mut buffer = [0; 5];
    let mut handle = file.take(5);
    try!(handle.read(&mut buffer));

    let file = handle.into_inner();

## Trait Implementations

### `impl<T> BufRead for Take<T> where T: BufRead`

#### `fn fill_buf(&mut self) -> Result<&[u8], Error>`

Fills the internal buffer of this object, returning the buffer contents. Read more

#### `fn consume(&mut self, amt: usize)`

Tells this buffer that `amt` bytes have been consumed from the buffer, so they should no longer be returned in calls to `read`. Read more

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

Read all bytes into `buf` until the delimiter `byte` or EOF is reached. Read more

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

Read all bytes until a newline (the 0xA byte) is reached, and append them to the provided buffer. Read more

#### `fn split(self, byte: u8) -> Split<Self>`

Returns an iterator over the contents of this reader split on the byte `byte`. Read more

#### `fn lines(self) -> Lines<Self>`

Returns an iterator over the lines of this reader. Read more

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

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

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

#### `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`. Read more

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

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

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

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

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

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

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

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

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

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

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

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

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

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

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand 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`)