Struct c_vec::CSlice

pub struct CSlice<'a, T> { /* fields omitted */ }

The type representing an 'unsafe' non-mutable foreign chunk of memory.

Example

use c_vec::CSlice;

let slice = &[0, 1, 2];
let ptr = slice.as_ptr();
let cslice = unsafe { CSlice::new(ptr, slice.len()) };

Implementations

impl<'a, T> CSlice<'a, T>

pub unsafe fn new(base: *const T, len: usize) -> CSlice<'a, T>

Create a CSlice from a raw pointer to a buffer with a given length.

Panics if the given pointer is null. The returned slice will not attempt to deallocate the slice when dropped.

Arguments

• base - A raw pointer to a buffer
• len - The number of elements in the buffer

Example

use c_vec::CSlice;

let slice = &[0, 1, 2];
let ptr = slice.as_ptr();
let cslice = unsafe { CSlice::new(ptr, slice.len()) };

pub fn get(&'a self, ofs: usize) -> Option<&'a T>

Retrieves an element at a given index, returning None if the requested index is greater than the length of the slice.

Example

use c_vec::CSlice;

let slice = &[0, 1, 2];
let ptr = slice.as_ptr();
let cslice = unsafe { CSlice::new(ptr, slice.len()) };
assert_eq!(cslice.get(1), slice.get(1));

pub unsafe fn get_unchecked(&'a self, ofs: usize) -> &'a T

Returns a reference to an element without doing any check.

Example

use c_vec::CSlice;

let slice = &[0, 1, 2];
let ptr = slice.as_ptr();
let cslice = unsafe { CSlice::new(ptr, slice.len()) };
unsafe {
    assert_eq!(cslice.get_unchecked(1), slice.get_unchecked(1));
}

pub fn len(&self) -> usize

Returns the number of items in this slice.

Example

use c_vec::CSlice;

let slice = &[0, 1, 2];
let ptr = slice.as_ptr();
let cslice = unsafe { CSlice::new(ptr, slice.len()) };
assert_eq!(cslice.len(), slice.len());

pub fn is_empty(&self) -> bool

Returns whether this slice is empty.

Example

use c_vec::CSlice;

let slice = &[0, 1, 2];
let ptr = slice.as_ptr();
let cslice = unsafe { CSlice::new(ptr, slice.len()) };
assert_eq!(cslice.is_empty(), slice.is_empty());

pub fn iter<'b>(&'b self) -> CSliceIter<'a, 'b, T>

Returns an iterator over CSlice.

Example

use c_vec::CSlice;

let slice = &[0, 1, 2];
let ptr = slice.as_ptr();
let cslice = unsafe { CSlice::new(ptr, slice.len()) };
for elem in cslice.iter() {
    println!("=> {}", elem);
}

Trait Implementations

impl<'a, T> AsRef<[T]> for CSlice<'a, T>

fn as_ref(&self) -> &[T]

View the stored data as a slice.

impl<'a, T> Index<usize> for CSlice<'a, T>

type Output = T

The returned type after indexing.

fn index(&self, index: usize) -> &T

Performs the indexing (container[index]) operation.

impl<'a, T: Clone> Into<Vec<T>> for CSlice<'a, T>

fn into(self: CSlice<'a, T>) -> Vec<T>

Performs the conversion.