Struct Vec2i

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

A 2-component non-owning view of an integral Euclidean vector.

Guarantees

This type has the strict requirement that it can only reference a 2-component slice of i32 values. It is guaranteed to never refer to more or less than 2 entries.

Relation to Vector2i

Vec2i is a non-owning equivalent of Vector2i. This enables non-vector types to either Deref or provide conversion-related utilities into Vec2i types to be able to access and benefit from vector operations.

Implementations

impl Vec2i

pub const fn from_array(array: &[i32; 2]) -> &Self

Forms a reference to a Vec2i from a 2-component i32 array.

This function is identical to from_slice_unchecked, except it is not marked unsafe.

Parameters

• array - an array containing 2 i32 values.

Examples

Basic use:

let array: [i32; 2] = [1, 42];

let vec = Vec2i::from_array(&array);

assert_eq!(vec.as_ptr(), array.as_ptr());
assert_eq!(vec.x(), array[0]);
assert_eq!(vec.y(), array[1]);

pub fn from_mut_array(array: &mut [i32; 2]) -> &mut Self

Forms a mutable reference to a Vec2i from a 2-component i32 array.

This function is identical to from_mut_slice_unchecked, except it is not marked unsafe.

Parameters

• array - an array containing 2 i32 values.

Examples

Basic use:

let mut array: [i32; 2] = [1, 42];

let vec = Vec2i::from_mut_array(&mut array);

assert_eq!(vec.as_ptr(), array.as_ptr());

pub const fn from_slice(slice: &[i32]) -> Result<&Self, VecError>

Forms a reference to a [Vec2] from a slice of i32.

This requires that slice.len() == 2, otherwise this returns VecError.

Parameters

• slice - the slice of i32s.

Examples

Basic use:

let slice = &[1, 02];

let vec = Vec2i::from_slice(slice).unwrap();

assert_eq!(vec.as_ptr(), slice.as_ptr());
assert_eq!(vec.x(), slice[0]);
assert_eq!(vec.y(), slice[1]);

Invalid size:

let slice = &[1];

let vec = Vec2i::from_slice(slice);

assert!(vec.is_err());

pub fn from_mut_slice(slice: &mut [i32]) -> Result<&mut Self, VecError>

Forms a mutable reference to a [Vec2] from a mutable slice of i32.

This requires that slice.len() == 2, otherwise this returns VecError.

Parameters

• slice - the mutable slice of i32s.

Examples

Basic use:

let slice = &mut [1, 42];

let vec = Vec2i::from_mut_slice(slice).unwrap();

assert_eq!(vec.as_ptr(), slice.as_ptr());

Invalid size:

let slice = &mut [1];

let vec = Vec2i::from_mut_slice(slice);

assert!(vec.is_err());

pub const unsafe fn from_slice_unchecked(slice: &[i32]) -> &Self

Forms a reference to a [Vec2] from a slice of i32 that is assumed to contain two values.

Parameters

• slice - the slice of i32s.

Safety

slice.len() must be equal to 2.

pub unsafe fn from_mut_slice_unchecked(slice: &mut [i32]) -> &mut Self

Forms a mutable reference to a [Vec2] from a slice of i32 that is assumed to contain two values.

Parameters

• slice - the mutable slice of i32s.

Safety

slice.len() must be equal to 2.

pub const unsafe fn from_ptr_unchecked<'a>(ptr: *const i32) -> &'a Vec2i

Forms a reference to a [Vec2] from a pointer to a contiguous sequence of at least two i32s.

Parameters

• ptr - the pointer to a sequence of i32 values

Safety

ptr must point to an allocated object that references at least two entries

pub unsafe fn from_mut_ptr_unchecked<'a>(ptr: *mut i32) -> &'a mut Vec2i

Forms a mutable reference to a [Vec2] from a pointer to a contiguous sequence of at least two i32s.

Parameters

• ptr - the pointer to a sequence of i32 values

Safety

ptr must point to an allocated object that references at least two entries

pub const fn as_slice(&self) -> &[i32]

Returns this [Vec2] as a slice of i32.

pub fn as_mut_slice(&mut self) -> &mut [i32]

Returns this [Vec2] as a mutable slice of i32.

pub const fn as_ptr(&self) -> *const i32

Returns a raw pointer to i32 of the vector’s buffer.

pub fn as_mut_ptr(&mut self) -> *mut i32

Returns a mutable raw pointer to i32 of the vector’s buffer.

pub fn iter(&self) -> impl Iterator<Item = &i32>

Returns an iterator over the vector.

pub fn iter_mut(&mut self) -> impl Iterator<Item = &mut i32>

Returns a mutable iterator over the vector.

pub const fn x(&self) -> i32

Returns the X-coordinate of this 2-component vector.

pub const fn y(&self) -> i32

Returns the Y-coordinate of this 2-component vector.

pub fn x_mut(&mut self) -> &mut i32

Returns a mutable reference to the X-coordinate of this 2-component vector.

pub fn y_mut(&mut self) -> &mut i32

Returns a mutable reference to the Y-coordinate of this 2-component vector.

pub fn set_x(&mut self, x: i32)

Sets the x-component

Parameters

• x - the X-component

pub fn set_y(&mut self, y: i32)

Sets the y-component

Parameters

• y - the Y-component

pub fn set(&mut self, other: &Vec2i)

Sets all the components of this vector the values from other.

Parameters

• other - the other [Vec2] to set.

pub fn abs(&self) -> Vector2i

Computes the absolute value of self

pub fn min(&self, rhs: &Vec2i) -> Vector2i

Computes the minimum of each vector.

Parameters

• lhs - the left vector
• rhs - the right vector

pub fn max(&self, rhs: &Vec2i) -> Vector2i

Computes the maximum of each vector.

Parameters

• lhs - the left vector
• rhs - the right vector

Trait Implementations

impl Add<&Vec2i> for &Vector2i

type Output = Vector2i

The resulting type after applying the + operator.

fn add(self, rhs: &Vec2i) -> Self::Output

Performs the + operation.

impl Add<&Vec2i> for Vector2i

type Output = Vector2i

The resulting type after applying the + operator.

fn add(self, rhs: &Vec2i) -> Self::Output

Performs the + operation.

impl Add<&Vector2i> for &Vec2i

type Output = Vector2i

The resulting type after applying the + operator.

fn add(self, rhs: &Vector2i) -> Self::Output

Performs the + operation.

impl Add<Vector2i> for &Vec2i

type Output = Vector2i

The resulting type after applying the + operator.

fn add(self, rhs: Vector2i) -> Self::Output

Performs the + operation.

impl Add for &Vec2i

type Output = Vector2i

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl AddAssign<&Vec2i> for Vec2i

fn add_assign(&mut self, rhs: &Vec2i)

Performs the += operation.

impl AddAssign<&Vec2i> for Vector2i

fn add_assign(&mut self, rhs: &Vec2i)

Performs the += operation.

impl AsMut<[i32]> for Vec2i

fn as_mut(&mut self) -> &mut [i32]

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsMut<Vec2i> for Vector2i

fn as_mut(&mut self) -> &mut Vec2i

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<[i32]> for Vec2i

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

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<Vec2i> for Vector2i

fn as_ref(&self) -> &Vec2i

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<[i32]> for Vec2i

fn borrow(&self) -> &[i32]

Immutably borrows from an owned value.

impl Borrow<Vec2i> for Vector2i

fn borrow(&self) -> &Vec2i

Immutably borrows from an owned value.

impl BorrowMut<[i32]> for Vec2i

fn borrow_mut(&mut self) -> &mut [i32]

Mutably borrows from an owned value.

impl BorrowMut<Vec2i> for Vector2i

fn borrow_mut(&mut self) -> &mut Vec2i

Mutably borrows from an owned value.

impl Debug for Vec2i

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

Formats the value using the given formatter.

impl Display for Vec2i

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

Formats the value using the given formatter.

impl Div<i32> for &Vec2i

type Output = Vector2i

The resulting type after applying the / operator.

fn div(self, rhs: i32) -> Self::Output

Performs the / operation.

impl DivAssign<i32> for Vec2i

fn div_assign(&mut self, rhs: i32)

Performs the /= operation.

impl Dot for Vec2i

type Output = i32

The output of this operation.

fn dot(&self, rhs: &Self) -> Self::Output

Performs the dot-product between two values, and returns the output value.

impl From<&Vec2i> for Vector2

fn from(value: &Vec2i) -> Self

Converts to this type from the input type.

impl From<&Vec2i> for Vector2i

fn from(value: &Vec2i) -> Self

Converts to this type from the input type.

impl<I> Index<I> for Vec2i

where I: SliceIndex<[i32]>,

type Output = <I as SliceIndex<[i32]>>::Output

The returned type after indexing.

fn index(&self, index: I) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<I> IndexMut<I> for Vec2i

where I: SliceIndex<[i32]>,

fn index_mut(&mut self, index: I) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl Mul<&Vec2i> for i32

type Output = Vector2i

The resulting type after applying the * operator.

fn mul(self, rhs: &Vec2i) -> Self::Output

Performs the * operation.

impl Mul<i32> for &Vec2i

type Output = Vector2i

The resulting type after applying the * operator.

fn mul(self, rhs: i32) -> Self::Output

Performs the * operation.

impl MulAssign<i32> for Vec2i

fn mul_assign(&mut self, rhs: i32)

Performs the *= operation.

impl Neg for &Vec2i

type Output = Vector2i

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Ord for Vec2i

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

This method returns an Ordering between self and other.

impl PartialEq for Vec2i

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for Vec2i

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Rem<i32> for &Vec2i

type Output = Vector2i

The resulting type after applying the % operator.

fn rem(self, rhs: i32) -> Self::Output

Performs the % operation.

impl RemAssign<i32> for Vec2i

fn rem_assign(&mut self, rhs: i32)

Performs the %= operation.

impl Sub<&Vec2i> for &Vector2i

type Output = Vector2i

The resulting type after applying the - operator.

fn sub(self, rhs: &Vec2i) -> Self::Output

Performs the - operation.

impl Sub<&Vec2i> for Vector2i

type Output = Vector2i

The resulting type after applying the - operator.

fn sub(self, rhs: &Vec2i) -> Self::Output

Performs the - operation.

impl Sub<&Vector2i> for &Vec2i

type Output = Vector2i

The resulting type after applying the - operator.

fn sub(self, rhs: &Vector2i) -> Self::Output

Performs the - operation.

impl Sub<Vector2i> for &Vec2i

type Output = Vector2i

The resulting type after applying the - operator.

fn sub(self, rhs: Vector2i) -> Self::Output

Performs the - operation.

impl Sub for &Vec2i

type Output = Vector2i

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl SubAssign<&Vec2i> for Vec2i

fn sub_assign(&mut self, rhs: &Vec2i)

Performs the -= operation.

impl SubAssign<&Vec2i> for Vector2i

fn sub_assign(&mut self, rhs: &Vec2i)

Performs the -= operation.

impl ToOwned for Vec2i

type Owned = Vector2i

The resulting type after obtaining ownership.

fn to_owned(&self) -> Self::Owned

Creates owned data from borrowed data, usually by cloning.

fn clone_into(&self, target: &mut Self::Owned)

Uses borrowed data to replace owned data, usually by cloning.

impl Eq for Vec2i

impl StructuralPartialEq for Vec2i