Struct bytes::buf::Take[][src]

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

A Buf adapter which limits the bytes read from an underlying buffer.

This struct is generally created by calling take() on Buf. See documentation of take() for more details.

Methods

impl<T> Take<T>
[src]

Consumes this Take, returning the underlying value.

Examples

use bytes::{Buf, BufMut};
use std::io::Cursor;

let mut buf = Cursor::new(b"hello world").take(2);
let mut dst = vec![];

dst.put(&mut buf);
assert_eq!(*dst, b"he"[..]);

let mut buf = buf.into_inner();

dst.clear();
dst.put(&mut buf);
assert_eq!(*dst, b"llo world"[..]);

Important traits for &'a mut W

Gets a reference to the underlying Buf.

It is inadvisable to directly read from the underlying Buf.

Examples

use bytes::{Buf, BufMut};
use std::io::Cursor;

let mut buf = Cursor::new(b"hello world").take(2);

assert_eq!(0, buf.get_ref().position());

Important traits for &'a mut W

Gets a mutable reference to the underlying Buf.

It is inadvisable to directly read from the underlying Buf.

Examples

use bytes::{Buf, BufMut};
use std::io::Cursor;

let mut buf = Cursor::new(b"hello world").take(2);
let mut dst = vec![];

buf.get_mut().set_position(2);

dst.put(&mut buf);
assert_eq!(*dst, b"ll"[..]);

Returns the maximum number of bytes that can be read.

Note

If the inner Buf has fewer bytes than indicated by this method then that is the actual number of available bytes.

Examples

use bytes::Buf;
use std::io::Cursor;

let mut buf = Cursor::new(b"hello world").take(2);

assert_eq!(2, buf.limit());
assert_eq!(b'h', buf.get_u8());
assert_eq!(1, buf.limit());

Sets the maximum number of bytes that can be read.

Note

If the inner Buf has fewer bytes than lim then that is the actual number of available bytes.

Examples

use bytes::{Buf, BufMut};
use std::io::Cursor;

let mut buf = Cursor::new(b"hello world").take(2);
let mut dst = vec![];

dst.put(&mut buf);
assert_eq!(*dst, b"he"[..]);

dst.clear();

buf.set_limit(3);
dst.put(&mut buf);
assert_eq!(*dst, b"llo"[..]);

Trait Implementations

impl<T: Debug> Debug for Take<T>
[src]

Formats the value using the given formatter. Read more

impl<T: Buf> Buf for Take<T>
[src]

Returns the number of bytes between the current position and the end of the buffer. Read more

Important traits for &'a mut [u8]

Returns a slice starting at the current position and of length between 0 and Buf::remaining(). Read more

Advance the internal cursor of the Buf Read more

Fills dst with potentially multiple slices starting at self's current position. Read more

Returns true if there are any more bytes to consume Read more

Copies bytes from self into dst. Read more

Gets an unsigned 8 bit integer from self. Read more

Gets a signed 8 bit integer from self. Read more

Gets an unsigned 16 bit integer from self in big-endian byte order. Read more

Gets an unsigned 16 bit integer from self in little-endian byte order. Read more

Gets a signed 16 bit integer from self in big-endian byte order. Read more

Gets a signed 16 bit integer from self in little-endian byte order. Read more

Gets an unsigned 32 bit integer from self in the big-endian byte order. Read more

Gets an unsigned 32 bit integer from self in the little-endian byte order. Read more

Gets a signed 32 bit integer from self in big-endian byte order. Read more

Gets a signed 32 bit integer from self in little-endian byte order. Read more

Gets an unsigned 64 bit integer from self in big-endian byte order. Read more

Gets an unsigned 64 bit integer from self in little-endian byte order. Read more

Gets a signed 64 bit integer from self in big-endian byte order. Read more

Gets a signed 64 bit integer from self in little-endian byte order. Read more

Gets an unsigned n-byte integer from self in big-endian byte order. Read more

Gets an unsigned n-byte integer from self in little-endian byte order. Read more

Gets a signed n-byte integer from self in big-endian byte order. Read more

Gets a signed n-byte integer from self in little-endian byte order. Read more

Gets an IEEE754 single-precision (4 bytes) floating point number from self in big-endian byte order. Read more

Gets an IEEE754 single-precision (4 bytes) floating point number from self in little-endian byte order. Read more

Gets an IEEE754 double-precision (8 bytes) floating point number from self in big-endian byte order. Read more

Gets an IEEE754 double-precision (8 bytes) floating point number from self in little-endian byte order. Read more

Transforms a Buf into a concrete buffer. Read more

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

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

Important traits for &'a mut W

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

Important traits for Reader<B>

Creates an adaptor which implements the Read trait for self. Read more

Important traits for Iter<T>

Returns an iterator over the bytes contained by the buffer. Read more

Auto Trait Implementations

impl<T> Send for Take<T> where
    T: Send

impl<T> Sync for Take<T> where
    T: Sync