Struct ReadOnlyMemory 

pub struct ReadOnlyMemory<T> { /* private fields */ }

An immutable, reference counted slice of a shared buffer.

Cloning and slicing never copy the elements; they bump one reference count.

Implementations

impl<T> ReadOnlyMemory<T>

pub const fn empty() -> Self

The empty memory (C# default / ReadOnlyMemory<T>.Empty).

pub fn new(owner: Rc<[T]>) -> Self

Wraps a whole shared buffer.

pub fn with_range(owner: Rc<[T]>, start: usize, length: usize) -> Self

Wraps length elements of a shared buffer starting at start.

Panics when the range is outside the buffer.

pub fn from_vec(values: Vec<T>) -> Self

Takes ownership of a vector.

pub fn len(&self) -> usize

The number of elements (C# Length).

pub fn is_empty(&self) -> bool

Whether the memory has no elements (C# IsEmpty).

pub fn span(&self) -> &[T]

The elements (C# Span).

pub fn slice_from(&self, start: usize) -> Self

The elements from start to the end (C# Slice(start)).

Panics when start is outside the memory.

pub fn slice(&self, start: usize, length: usize) -> Self

length elements starting at start (C# Slice(start, length)).

Panics when the range is outside the memory.

pub fn offset_in_owner(&self) -> usize

The offset of this memory inside its underlying buffer.

pub fn owner(&self) -> Option<&Rc<[T]>>

The underlying buffer, when there is one.

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

Whether both memories view the same buffer (regardless of range).

impl<T: Clone> ReadOnlyMemory<T>

pub fn from_slice(values: &[T]) -> Self

Copies a slice into a new shared buffer.

pub fn to_vec(&self) -> Vec<T>

Copies the elements out (C# ToArray).

impl ReadOnlyMemory<u16>

pub fn from_str(text: &str) -> Self

Encodes a string as UTF-16 code units (C# string.AsMemory()).

pub fn to_string_lossy(&self) -> String

Decodes the UTF-16 code units, replacing lone surrogates with U+FFFD.

Trait Implementations

impl<T> Clone for ReadOnlyMemory<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for ReadOnlyMemory<T>

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

Formats the value using the given formatter.

impl<T> Default for ReadOnlyMemory<T>

fn default() -> Self

Returns the “default value” for a type.

impl From<&str> for ReadOnlyMemory<u16>

fn from(text: &str) -> Self

Converts to this type from the input type.

impl<T> From<Rc<[T]>> for ReadOnlyMemory<T>

fn from(values: Rc<[T]>) -> Self

Converts to this type from the input type.

impl<T> From<Vec<T>> for ReadOnlyMemory<T>

fn from(values: Vec<T>) -> Self

Converts to this type from the input type.

impl<T: PartialEq> PartialEq for ReadOnlyMemory<T>

Element-wise equality (unlike C#, where ReadOnlyMemory<T>.Equals compares the underlying object and range; use ReadOnlyMemory::shares_owner_with for that).

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

Equality operator ==.

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

Inequality operator !=.