Trait FromBuf

pub trait FromBuf {
    // Required method
    fn from_buf<T>(buf: T) -> Self
       where T: IntoBuf;
}

Conversion from a Buf

Implementing FromBuf for a type defines how it is created from a buffer. This is common for types which represent byte storage of some kind.

FromBuf::from_buf is rarely called explicitly, and it is instead used through Buf::collect. See Buf::collect documentation for more examples.

See also IntoBuf.

Examples

Basic usage:

use bytes::{Bytes, IntoBuf};
use bytes::buf::FromBuf;

let buf = Bytes::from(&b"hello world"[..]).into_buf();
let vec = Vec::from_buf(buf);

assert_eq!(vec, &b"hello world"[..]);

Using Buf::collect to implicitly use FromBuf:

use bytes::{Buf, Bytes, IntoBuf};

let buf = Bytes::from(&b"hello world"[..]).into_buf();
let vec: Vec<u8> = buf.collect();

assert_eq!(vec, &b"hello world"[..]);

Implementing FromBuf for your type:

use bytes::{BufMut, Bytes};
use bytes::buf::{IntoBuf, FromBuf};

// A sample buffer, that's just a wrapper over Vec<u8>
struct MyBuffer(Vec<u8>);

impl FromBuf for MyBuffer {
    fn from_buf<B>(buf: B) -> Self where B: IntoBuf {
        let mut v = Vec::new();
        v.put(buf.into_buf());
        MyBuffer(v)
    }
}

// Now we can make a new buf
let buf = Bytes::from(&b"hello world"[..]);

// And make a MyBuffer out of it
let my_buf = MyBuffer::from_buf(buf);

assert_eq!(my_buf.0, &b"hello world"[..]);

Required Methods

fn from_buf<T>(buf: T) -> Self

where T: IntoBuf,

Creates a value from a buffer.

See the type-level documentation for more details.

Examples

Basic usage:

use bytes::{Bytes, IntoBuf};
use bytes::buf::FromBuf;

let buf = Bytes::from(&b"hello world"[..]).into_buf();
let vec = Vec::from_buf(buf);

assert_eq!(vec, &b"hello world"[..]);

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl FromBuf for Vec<u8>

fn from_buf<T>(buf: T) -> Self

where T: IntoBuf,

Implementors

impl FromBuf for Bytes

impl FromBuf for BytesMut