Struct abi_stable::std_types::RSlice

#[repr(C)]
pub struct RSlice<'a, T> { /* fields omitted */ }

Ffi-safe equivalent of &'a [T]

Methods

impl<'a, T: 'a> RSlice<'a, T>

pub const EMPTY: Self

An empty slice.

pub const unsafe fn from_raw_parts(ptr_: *const T, len: usize) -> Self

Constructs an RSlice<'a,T> from a pointer to the first element, and a length.

Safety

Callers must ensure that:

• ptr_ points to valid memory,

• ptr_ .. ptr+len range is àccessible memory.

• ptr_ is aligned to T.

• the data ptr_ points to must be valid for the lifetime of this RSlice<'a,T>

impl<'a, T> RSlice<'a, T>

pub fn as_slice(&self) -> &'a [T]

Creates an &'a [T] with access to all the elements of this slice.

pub const fn len(&self) -> usize

The length (in elements) of this slice.

pub const fn is_empty(&self) -> bool

Whether this slice is empty.

impl<'a, T> RSlice<'a, T>

pub const fn empty() -> Self

Creates an empty slice

pub fn from_ref(ref_: &'a T) -> Self

Converts a reference to T to a single element RSlice<'a,T>.

Note:this function does not copy anything.

Important traits for RSlice<'a, u8>

impl<'a> Read for RSlice<'a, u8>

pub fn slice<I>(&self, i: I) -> RSlice<'a, T> where
    [T]: Index<I, Output = [T]>, 

Creates an RSlice<'a,T> with access to the range range of elements.

This is an inherent method instead of an implementation of the ::std::ops::Index trait because it does not return a reference.

Important traits for RVec<u8>

impl Write for RVec<u8>

pub fn to_rvec(&self) -> RVec<T> where
    T: Clone, 

Creates a new RVec<T> and clones all the elements of this slice into it.

Trait Implementations

impl<'a, T> IntoReprRust for RSlice<'a, T>

type ReprRust = &'a [T]

fn into_rust(self) -> Self::ReprRust

impl<'a, T> SharedStableAbi for RSlice<'a, T> where
    T: __StableAbi,
    T: 'a, 

type IsNonZeroType = False

Whether this type has a single invalid bit-pattern.

type Kind = __ValueKind

The kind of abi stability of this type,there are 2:

type StaticEquivalent = RSlice<'static, __StaticEquivalent<T>>

A version of the type which does not borrow anything, used to create a UTypeId for doing layout checking.

const S_LAYOUT: &'static TypeLayout

The layout of the type provided by implementors.

const S_ABI_INFO: &'static AbiInfoWrapper

The layout of the type,derived from Self::LAYOUT and associated types.

impl<'a, T: 'a> BorrowOwned<'a> for RSlice<'a, T> where
    T: StableAbi + Clone, 

type Borrowed = [T]

type ROwned = RVec<T>

fn to_rowned(self) -> Self::ROwned

fn from_rowned(owned: &'a Self::ROwned) -> Self

fn rowned_to_owned(owned: Self::ROwned) -> Vec<T>

fn owned_to_rowned(owned: Vec<T>) -> Self::ROwned

fn from_borrowed(this: &'a Self::Borrowed) -> Self

fn deref_borrowed(self) -> &'a Self::Borrowed

fn deref_owned(owned: &Self::ROwned) -> &Self::Borrowed

impl<'a, T> Into<&'a [T]> for RSlice<'a, T>

fn into(self) -> &'a [T]

Performs the conversion.

impl<'a, T> Eq for RSlice<'a, T> where
    T: Eq, 

impl<'a, T> Send for RSlice<'a, T> where
    &'a [T]: Send, 

impl<'a, T> Sync for RSlice<'a, T> where
    &'a [T]: Sync, 

impl<'a, T> Copy for RSlice<'a, T>

impl<'a, T> PartialOrd<RSlice<'a, T>> for RSlice<'a, T> where
    T: PartialOrd, 

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a, T> Default for RSlice<'a, T>

fn default() -> Self

Returns the "default value" for a type.

impl<'a, T> PartialEq<RSlice<'a, T>> for RSlice<'a, T> where
    T: PartialEq, 

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a, T> From<&'a [T]> for RSlice<'a, T>

Important traits for RSlice<'a, u8>

impl<'a> Read for RSlice<'a, u8>

fn from(this: &'a [T]) -> RSlice<'a, T>

Performs the conversion.

impl<'a, T: 'a> AsRef<[T]> for RSlice<'a, T>

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

Performs the conversion.

impl<'a, T> Clone for RSlice<'a, T>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, T> IntoIterator for RSlice<'a, T>

type Item = &'a T

The type of the elements being iterated over.

type IntoIter = Iter<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Iter<'a, T>

Creates an iterator from a value.

impl<'a, T> Ord for RSlice<'a, T> where
    T: Ord, 

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl<'a, T: 'a> Deref for RSlice<'a, T>

type Target = [T]

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a, T> Debug for RSlice<'a, T> where
    T: Debug, 

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<'a, T> Hash for RSlice<'a, T> where
    T: Hash, 

fn hash<H>(&self, state: &mut H) where
    H: Hasher, 

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl<'a> Read for RSlice<'a, u8>

fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_exact(&mut self, buf: &mut [u8]) -> Result<()>

Read the exact number of bytes required to fill buf.

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize>

Read all bytes until EOF in this source, placing them into buf.

fn read_vectored(&mut self, bufs: &mut [IoVecMut]) -> Result<usize, Error>

🔬 This is a nightly-only experimental API. (iovec)

Like read, except that it reads into a slice of buffers.

unsafe fn initializer(&self) -> Initializer

🔬 This is a nightly-only experimental API. (read_initializer)

Determines if this Reader can work with buffers of uninitialized memory.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>

Read all bytes until EOF in this source, appending them to buf.

fn by_ref(&mut self) -> &mut Self

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

fn bytes(self) -> Bytes<Self>

Transforms this Read instance to an [Iterator] over its bytes.

fn chain<R>(self, next: R) -> Chain<Self, R> where
    R: Read, 

Creates an adaptor which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

Creates an adaptor which will read at most limit bytes from it.

impl<'a> BufRead for RSlice<'a, u8>

fn fill_buf(&mut self) -> Result<&[u8]>

Returns the contents of the internal buffer, filling it with more data from the inner reader if it is empty.

fn consume(&mut self, amt: usize)

Tells this buffer that amt bytes have been consumed from the buffer, so they should no longer be returned in calls to read.

fn read_until(&mut self, byte: u8, buf: &mut Vec<u8>) -> Result<usize, Error>

Read all bytes into buf until the delimiter byte or EOF is reached.

fn read_line(&mut self, buf: &mut String) -> Result<usize, Error>

Read all bytes until a newline (the 0xA byte) is reached, and append them to the provided buffer.

fn split(self, byte: u8) -> Split<Self>

Returns an iterator over the contents of this reader split on the byte byte.

fn lines(self) -> Lines<Self>

Returns an iterator over the lines of this reader.

impl<'de, T> Deserialize<'de> for RSlice<'de, T> where
    &'de [T]: Deserialize<'de>, 

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<'a, T> Serialize for RSlice<'a, T> where
    T: Serialize, 

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.