impl<'a> IoSlice<'a>

fn new(buf: &'a [u8]) -> IoSlice<'a>

Creates a new IoSlice wrapping a byte slice.

Panics

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

fn advance(&mut self, n: usize)

Advance the internal cursor of the slice.

Also see IoSlice::advance_slices to advance the cursors of multiple buffers.

Panics

Panics when trying to advance beyond the end of the slice.

Examples

use std::io::IoSlice;
use std::ops::Deref;

let data = [1; 8];
let mut buf = IoSlice::new(&data);

// Mark 3 bytes as read.
buf.advance(3);
assert_eq!(buf.deref(), [1; 5].as_ref());

fn advance_slices(bufs: &mut &mut [IoSlice<'a>], n: usize)

Advance a slice of slices.

Shrinks the slice to remove any IoSlices that are fully advanced over. If the cursor ends up in the middle of an IoSlice, it is modified to start at that cursor.

For example, if we have a slice of two 8-byte IoSlices, and we advance by 10 bytes, the result will only include the second IoSlice, advanced by 2 bytes.

Panics

Panics when trying to advance beyond the end of the slices.

Examples

use std::io::IoSlice;
use std::ops::Deref;

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

// Mark 10 bytes as written.
IoSlice::advance_slices(&mut bufs, 10);
assert_eq!(bufs[0].deref(), [2; 14].as_ref());
assert_eq!(bufs[1].deref(), [3; 8].as_ref());

const fn as_slice(self) -> &'a [u8]

Get the underlying bytes as a slice with the original lifetime.

This doesn't borrow from self, so is less restrictive than calling .deref(), which does.

Examples

#![feature(io_slice_as_bytes)]
use std::io::IoSlice;

let data = b"abcdef";

let mut io_slice = IoSlice::new(data);
let tail = &io_slice.as_slice()[3..];

// This works because `tail` doesn't borrow `io_slice`
io_slice = IoSlice::new(tail);

assert_eq!(io_slice.as_slice(), b"def");