Struct meshx::index::Index

pub struct Index(/* private fields */);

A possibly invalid unsigned index. The maximum usize integer represents an invalid index. This index type is ideal for storage. Overflow is not handled by this type. Instead we rely on Rust’s internal overflow panics during debug builds.

Implementations

impl Index

pub const INVALID: Index = _

Invalid index instance.

pub fn new(i: usize) -> Index

Create a valid index from a usize type. This constructor does the necessary check for debug builds only.

pub fn into_option(self) -> Option<usize>

Convert this Index into Option<usize>, which is a larger struct.

pub fn map_inner<F: FnOnce(usize) -> usize>(self, f: F) -> Index

Manipulate the inner representation of the index. This method avoids the additional check used in map. Use this to opt out of automatic index checking.

pub fn and_then<F: FnOnce(usize) -> Index>(self, f: F) -> Index

Checked and_then over inner index. This allows operations on valid indices only.

pub fn apply<F: FnOnce(&mut usize)>(&mut self, f: F)

Apply a function to the inner usize index. The index remains unchanged if invalid.

pub fn if_valid<F: FnOnce(usize)>(self, f: F)

Apply a function to the inner usize index.

pub fn into_inner(self) -> usize

Get the raw usize representation of this Index. This may be useful for performance critical code or debugging.

Trait Implementations

impl Add<Index> for usize

type Output = Index

The resulting type after applying the + operator.

fn add(self, rhs: Index) -> Index

Performs the + operation.

impl Add<usize> for Index

type Output = Index

The resulting type after applying the + operator.

fn add(self, rhs: usize) -> Index

Performs the + operation.

impl Add for Index

type Output = Index

The resulting type after applying the + operator.

fn add(self, rhs: Index) -> Index

Performs the + operation.

impl AddAssign<usize> for Index

fn add_assign(&mut self, rhs: usize)

Performs the += operation.

impl CheckedIndex<usize> for Index

fn invalid() -> Self

Construct an invalid index.

fn is_valid(&self) -> bool

Check if the index is valid.

fn unwrap(self) -> usize

Convert the index into its underlying integer type. Panic if index is invalid.

fn expect(self, msg: &str) -> usize

Convert the index into its underlying integer type. In case of failure, report the given message.

fn map<F: FnOnce(usize) -> usize>(self, f: F) -> Index

Map the underlying integer type. This allows restricting operations to valid indices only.

fn map_or<U, F: FnOnce(usize) -> U>(self, default: U, f: F) -> U

Map the underlying integer type. If the index is invalid, output the provided default.

fn into_inner(self) -> usize

Produce the raw inner type without checking.

impl Clone for Index

fn clone(&self) -> Index

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Index

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

Formats the value using the given formatter.

impl Default for Index

fn default() -> Self

Returns the “default value” for a type.

impl Display for Index

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

Formats the value using the given formatter.

impl Div<usize> for Index

type Output = Index

The resulting type after applying the / operator.

fn div(self, rhs: usize) -> Index

Performs the / operation.

impl From<CellEdgeIndex> for Index

fn from(i: CellEdgeIndex) -> Self

Converts to this type from the input type.

impl From<CellFaceIndex> for Index

fn from(i: CellFaceIndex) -> Self

Converts to this type from the input type.

impl From<CellIndex> for Index

fn from(i: CellIndex) -> Self

Converts to this type from the input type.

impl From<CellVertexIndex> for Index

fn from(i: CellVertexIndex) -> Self

Converts to this type from the input type.

impl From<EdgeCellIndex> for Index

fn from(i: EdgeCellIndex) -> Self

Converts to this type from the input type.

impl From<EdgeFaceIndex> for Index

fn from(i: EdgeFaceIndex) -> Self

Converts to this type from the input type.

impl From<EdgeIndex> for Index

fn from(i: EdgeIndex) -> Self

Converts to this type from the input type.

impl From<EdgeVertexIndex> for Index

fn from(i: EdgeVertexIndex) -> Self

Converts to this type from the input type.

impl From<FaceCellIndex> for Index

fn from(i: FaceCellIndex) -> Self

Converts to this type from the input type.

impl From<FaceEdgeIndex> for Index

fn from(i: FaceEdgeIndex) -> Self

Converts to this type from the input type.

impl From<FaceIndex> for Index

fn from(i: FaceIndex) -> Self

Converts to this type from the input type.

impl From<FaceVertexIndex> for Index

fn from(i: FaceVertexIndex) -> Self

Converts to this type from the input type.

impl From<Index> for CellEdgeIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for CellFaceIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for CellIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for CellVertexIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for EdgeCellIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for EdgeFaceIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for EdgeIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for EdgeVertexIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for FaceCellIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for FaceEdgeIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for FaceIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for FaceVertexIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for MeshIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for Option<usize>

fn from(val: Index) -> Self

Converts to this type from the input type.

impl From<Index> for VertexCellIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for VertexEdgeIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for VertexFaceIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<Index> for VertexIndex

fn from(i: Index) -> Self

Converts to this type from the input type.

impl From<MeshIndex> for Index

fn from(i: MeshIndex) -> Self

Converts to this type from the input type.

impl From<Option<CellEdgeIndex>> for Index

fn from(mb_i: Option<CellEdgeIndex>) -> Self

Converts to this type from the input type.

impl From<Option<CellFaceIndex>> for Index

fn from(mb_i: Option<CellFaceIndex>) -> Self

Converts to this type from the input type.

impl From<Option<CellIndex>> for Index

fn from(mb_i: Option<CellIndex>) -> Self

Converts to this type from the input type.

impl From<Option<CellVertexIndex>> for Index

fn from(mb_i: Option<CellVertexIndex>) -> Self

Converts to this type from the input type.

impl From<Option<EdgeCellIndex>> for Index

fn from(mb_i: Option<EdgeCellIndex>) -> Self

Converts to this type from the input type.

impl From<Option<EdgeFaceIndex>> for Index

fn from(mb_i: Option<EdgeFaceIndex>) -> Self

Converts to this type from the input type.

impl From<Option<EdgeIndex>> for Index

fn from(mb_i: Option<EdgeIndex>) -> Self

Converts to this type from the input type.

impl From<Option<EdgeVertexIndex>> for Index

fn from(mb_i: Option<EdgeVertexIndex>) -> Self

Converts to this type from the input type.

impl From<Option<FaceCellIndex>> for Index

fn from(mb_i: Option<FaceCellIndex>) -> Self

Converts to this type from the input type.

impl From<Option<FaceEdgeIndex>> for Index

fn from(mb_i: Option<FaceEdgeIndex>) -> Self

Converts to this type from the input type.

impl From<Option<FaceIndex>> for Index

fn from(mb_i: Option<FaceIndex>) -> Self

Converts to this type from the input type.

impl From<Option<FaceVertexIndex>> for Index

fn from(mb_i: Option<FaceVertexIndex>) -> Self

Converts to this type from the input type.

impl From<Option<MeshIndex>> for Index

fn from(mb_i: Option<MeshIndex>) -> Self

Converts to this type from the input type.

impl From<Option<VertexCellIndex>> for Index

fn from(mb_i: Option<VertexCellIndex>) -> Self

Converts to this type from the input type.

impl From<Option<VertexEdgeIndex>> for Index

fn from(mb_i: Option<VertexEdgeIndex>) -> Self

Converts to this type from the input type.

impl From<Option<VertexFaceIndex>> for Index

fn from(mb_i: Option<VertexFaceIndex>) -> Self

Converts to this type from the input type.

impl From<Option<VertexIndex>> for Index

fn from(mb_i: Option<VertexIndex>) -> Self

Converts to this type from the input type.

impl From<Option<usize>> for Index

fn from(i: Option<usize>) -> Index

Converts to this type from the input type.

impl From<VertexCellIndex> for Index

fn from(i: VertexCellIndex) -> Self

Converts to this type from the input type.

impl From<VertexEdgeIndex> for Index

fn from(i: VertexEdgeIndex) -> Self

Converts to this type from the input type.

impl From<VertexFaceIndex> for Index

fn from(i: VertexFaceIndex) -> Self

Converts to this type from the input type.

impl From<VertexIndex> for Index

fn from(i: VertexIndex) -> Self

Converts to this type from the input type.

impl From<i16> for Index

Create an index from a signed integer type. If the given argument is negative, the created index will be invalid.

fn from(i: i16) -> Self

Converts to this type from the input type.

impl From<i32> for Index

Create an index from a signed integer type. If the given argument is negative, the created index will be invalid.

fn from(i: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Index

Create an index from a signed integer type. If the given argument is negative, the created index will be invalid.

fn from(i: i64) -> Self

Converts to this type from the input type.

impl From<i8> for Index

Create an index from a signed integer type. If the given argument is negative, the created index will be invalid.

fn from(i: i8) -> Self

Converts to this type from the input type.

impl From<isize> for Index

Create an index from a signed integer type. If the given argument is negative, the created index will be invalid.

fn from(i: isize) -> Self

Converts to this type from the input type.

impl From<u16> for Index

Create a valid index from a usize type. This converter does the necessary bounds check for debug builds only.

fn from(i: u16) -> Self

Converts to this type from the input type.

impl From<u32> for Index

Create a valid index from a usize type. This converter does the necessary bounds check for debug builds only.

fn from(i: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Index

Create a valid index from a usize type. This converter does the necessary bounds check for debug builds only.

fn from(i: u64) -> Self

Converts to this type from the input type.

impl From<u8> for Index

Create a valid index from a usize type. This converter does the necessary bounds check for debug builds only.

fn from(i: u8) -> Self

Converts to this type from the input type.

impl From<usize> for Index

Create a valid index from a usize type. This converter does the necessary bounds check for debug builds only.

fn from(i: usize) -> Self

Converts to this type from the input type.

impl Hash for Index

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoIterator for Index

type Item = usize

The type of the elements being iterated over.

type IntoIter = IntoIter<usize>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Mul<Index> for usize

type Output = Index

The resulting type after applying the * operator.

fn mul(self, rhs: Index) -> Index

Performs the * operation.

impl Mul<usize> for Index

type Output = Index

The resulting type after applying the * operator.

fn mul(self, rhs: usize) -> Index

Performs the * operation.

impl Ord for Index

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq<usize> for Index

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for Index

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<usize> for Index

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

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

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

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

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

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

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

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

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 PartialOrd for Index

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

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

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

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

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

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

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

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

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 Rem<usize> for Index

type Output = Index

The resulting type after applying the % operator.

fn rem(self, rhs: usize) -> Index

Performs the % operation.

impl Sub<Index> for usize

type Output = Index

The resulting type after applying the - operator.

fn sub(self, rhs: Index) -> Index

Performs the - operation.

impl Sub<usize> for Index

type Output = Index

The resulting type after applying the - operator.

fn sub(self, rhs: usize) -> Index

Performs the - operation.

impl Sub for Index

type Output = Index

The resulting type after applying the - operator.

fn sub(self, rhs: Index) -> Index

Performs the - operation.

impl Zeroable for Index

fn zeroed() -> Self

Calls zeroed.

impl Copy for Index

impl Eq for Index

impl Pod for Index

impl StructuralEq for Index

impl StructuralPartialEq for Index