Struct core_io::IoSliceMut

#[repr(transparent)]pub struct IoSliceMut<'a>(_);

A buffer type used with Read::read_vectored.

It is semantically a wrapper around an &mut [u8], but is guaranteed to be ABI compatible with the iovec type on Unix platforms and WSABUF on Windows.

Implementations

impl<'a> IoSliceMut<'a>

pub fn new(buf: &'a mut [u8]) -> IoSliceMut<'a>

Creates a new IoSliceMut wrapping a byte slice.

Panics

Panics on Windows if the slice is larger than 4GB.

pub fn advance<'b>(
    bufs: &'b mut [IoSliceMut<'a>],
    n: usize
) -> &'b mut [IoSliceMut<'a>]

Advance the internal cursor of the slice.

Notes

Elements in the slice may be modified if the cursor is not advanced to the end of the slice. For example if we have a slice of buffers with 2 IoSliceMuts, both of length 8, and we advance the cursor by 10 bytes the first IoSliceMut will be untouched however the second will be modified to remove the first 2 bytes (10 - 8).

Examples

#![feature(io_slice_advance)]

use std::io::IoSliceMut;
use std::ops::Deref;

let mut buf1 = [1; 8];
let mut buf2 = [2; 16];
let mut buf3 = [3; 8];
let mut bufs = &mut [
    IoSliceMut::new(&mut buf1),
    IoSliceMut::new(&mut buf2),
    IoSliceMut::new(&mut buf3),
][..];

// Mark 10 bytes as read.
bufs = IoSliceMut::advance(bufs, 10);
assert_eq!(bufs[0].deref(), [2; 14].as_ref());
assert_eq!(bufs[1].deref(), [3; 8].as_ref());

Trait Implementations

impl<'a> Debug for IoSliceMut<'a>

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Deref for IoSliceMut<'a>

type Target = [u8]

The resulting type after dereferencing.

fn deref(&self) -> &[u8]

Dereferences the value.

impl<'a> DerefMut for IoSliceMut<'a>

fn deref_mut(&mut self) -> &mut [u8]

Mutably dereferences the value.

impl<'a> Send for IoSliceMut<'a>

impl<'a> Sync for IoSliceMut<'a>