Type Alias faer_core::RowMut

pub type RowMut<'a, E> = Matrix<DenseRowMut<'a, E>>;

Mutable view over a row vector, similar to a mutable reference to a strided slice.

Note

Unlike a slice, the data pointed to by RowMut<'_, E> is allowed to be partially or fully uninitialized under certain conditions. In this case, care must be taken to not perform any operations that read the uninitialized values, or form references to them, either directly through RowMut::read, or indirectly through any of the numerical library routines, unless it is explicitly permitted.

Aliased Type

struct RowMut<'a, E> { /* private fields */ }

Implementations

impl<'a, E: Entity> RowMut<'a, E>

pub fn nrows(&self) -> usize

pub fn ncols(&self) -> usize

pub fn as_ptr_mut(self) -> GroupFor<E, *mut E::Unit>

Returns pointers to the matrix data.

pub fn col_stride(&self) -> isize

Returns the column stride of the matrix, specified in number of elements, not in bytes.

pub fn as_2d_mut(self) -> MatMut<'a, E>

Returns self as a mutable matrix view.

pub fn ptr_at_mut(self, col: usize) -> GroupFor<E, *mut E::Unit>

Returns raw pointers to the element at the given index.

pub unsafe fn ptr_inbounds_at_mut(self, col: usize) -> GroupFor<E, *mut E::Unit>

Returns raw pointers to the element at the given index, assuming the provided index is within the size of the vector.

Safety

The behavior is undefined if any of the following conditions are violated:

• col < self.ncols().

pub unsafe fn split_at_mut_unchecked(self, col: usize) -> (Self, Self)

Splits the column vector at the given index into two parts and returns an array of each subvector, in the following order:

• left.
• right.

Safety

The behavior is undefined if any of the following conditions are violated:

• col <= self.ncols().

pub fn split_at_mut(self, col: usize) -> (Self, Self)

Splits the column vector at the given index into two parts and returns an array of each subvector, in the following order:

• top.
• bottom.

Panics

The function panics if any of the following conditions are violated:

• col <= self.ncols().

pub unsafe fn get_mut_unchecked<ColRange>( self, col: ColRange ) -> <Self as RowIndex<ColRange>>::Target

where Self: RowIndex<ColRange>,

Returns references to the element at the given index, or subvector if col is a range.

Note

The values pointed to by the references are expected to be initialized, even if the pointed-to value is not read, otherwise the behavior is undefined.

Safety

The behavior is undefined if any of the following conditions are violated:

• col must be contained in [0, self.ncols()).

pub fn get_mut<ColRange>( self, col: ColRange ) -> <Self as RowIndex<ColRange>>::Target

where Self: RowIndex<ColRange>,

Returns references to the element at the given index, or subvector if col is a range, with bound checks.

Note

The values pointed to by the references are expected to be initialized, even if the pointed-to value is not read, otherwise the behavior is undefined.

Panics

The function panics if any of the following conditions are violated:

• col must be contained in [0, self.ncols()).

pub unsafe fn read_unchecked(&self, col: usize) -> E

Reads the value of the element at the given index.

Safety

The behavior is undefined if any of the following conditions are violated:

• col < self.ncols().

pub fn read(&self, col: usize) -> E

Reads the value of the element at the given index, with bound checks.

Panics

The function panics if any of the following conditions are violated:

• col < self.ncols().

pub unsafe fn write_unchecked(&mut self, col: usize, value: E)

Writes the value to the element at the given index.

Safety

The behavior is undefined if any of the following conditions are violated:

• col < self.ncols().

pub fn write(&mut self, col: usize, value: E)

Writes the value to the element at the given index, with bound checks.

Panics

The function panics if any of the following conditions are violated:

• col < self.ncols().

pub fn copy_from(&mut self, other: impl AsRowRef<E>)

Copies the values from other into self.

Panics

The function panics if any of the following conditions are violated:

• self.ncols() == other.ncols().

pub fn fill_zero(&mut self)

where E: ComplexField,

Fills the elements of self with zeros.

pub fn fill(&mut self, constant: E)

Fills the elements of self with copies of constant.

pub fn transpose_mut(self) -> ColMut<'a, E>

Returns a view over the transpose of self.

pub fn conjugate_mut(self) -> RowMut<'a, E::Conj>

where E: Conjugate,

Returns a view over the conjugate of self.

pub fn adjoint_mut(self) -> ColMut<'a, E::Conj>

where E: Conjugate,

Returns a view over the conjugate transpose of self.

pub fn canonicalize_mut(self) -> (RowMut<'a, E::Canonical>, Conj)

where E: Conjugate,

Returns a view over the canonical representation of self, as well as a flag declaring whether self is implicitly conjugated or not.

pub fn reverse_cols_mut(self) -> Self

Returns a view over the self, with the columnss in reversed order.

pub unsafe fn subcols_mut_unchecked( self, col_start: usize, ncols: usize ) -> Self

Returns a view over the subvector starting at col col_start, and with number of columns ncols.

Safety

The behavior is undefined if any of the following conditions are violated:

• col_start <= self.ncols().
• ncols <= self.ncols() - col_start.

pub fn subcols_mut(self, col_start: usize, ncols: usize) -> Self

Returns a view over the subvector starting at col col_start, and with number of columns ncols.

Safety

The behavior is undefined if any of the following conditions are violated:

• col_start <= self.ncols().
• ncols <= self.ncols() - col_start.

pub fn to_owned(&self) -> Row<E::Canonical>

where E: Conjugate,

Returns an owning Row of the data.

pub fn has_nan(&self) -> bool

where E: ComplexField,

Returns true if any of the elements is NaN, otherwise returns false.

pub fn is_all_finite(&self) -> bool

where E: ComplexField,

Returns true if all of the elements are finite, otherwise returns false.

pub fn norm_max(&self) -> E::Real

where E: ComplexField,

Returns the maximum norm of self.

pub fn norm_l2(&self) -> E::Real

where E: ComplexField,

Returns the L2 norm of self.

pub fn as_ref(&self) -> RowRef<'_, E>

Returns a view over the matrix.

Trait Implementations

impl<E: Entity> AsRowMut<E> for &mut RowMut<'_, E>

fn as_row_mut(&mut self) -> RowMut<'_, E>

impl<E: Entity> AsRowMut<E> for RowMut<'_, E>

fn as_row_mut(&mut self) -> RowMut<'_, E>

impl<E: Entity> AsRowRef<E> for &RowMut<'_, E>

fn as_row_ref(&self) -> RowRef<'_, E>

impl<E: Entity> AsRowRef<E> for RowMut<'_, E>

fn as_row_ref(&self) -> RowRef<'_, E>

impl<'a, E: Entity> Debug for RowMut<'a, E>

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

Formats the value using the given formatter.

impl<E: SimpleEntity> Index<usize> for RowMut<'_, E>

type Output = E

The returned type after indexing.

fn index(&self, col: usize) -> &E

Performs the indexing (container[index]) operation.

impl<E: SimpleEntity> IndexMut<usize> for RowMut<'_, E>

fn index_mut(&mut self, col: usize) -> &mut E

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

impl<'a, E: Entity> IntoConst for RowMut<'a, E>

type Target = Matrix<DenseRowRef<'a, E>>

fn into_const(self) -> Self::Target

impl<'a, E: Entity> MatIndex<'a> for RowMut<'_, E>

type Item = ReadWrite<'a, E>

unsafe fn get_unchecked(&'a mut self, (_, j): Self::Index) -> Self::Item

unsafe fn get_from_slice_unchecked( slice: &'a mut Self::Slice, idx: usize ) -> Self::Item

fn is_contiguous(&self) -> bool

fn preferred_layout(&self) -> Self::LayoutTransform

fn with_layout(self, layout: Self::LayoutTransform) -> Self

impl<E: Entity> MatShape for RowMut<'_, E>

type Rows = ()

type Cols = usize

fn nrows(&self) -> Self::Rows

fn ncols(&self) -> Self::Cols

impl<E: Entity> MaybeContiguous for RowMut<'_, E>

type Index = ((), usize)

type Slice = <<E as Entity>::Group as ForType>::FaerOf<&'static mut [MaybeUninit<<E as Entity>::Unit>]>

type LayoutTransform = VecLayoutTransform

unsafe fn get_slice_unchecked( &mut self, (_, j): Self::Index, n_elems: usize ) -> Self::Slice

impl<'short, 'a, E: Entity> Reborrow<'short> for RowMut<'a, E>

type Target = Matrix<DenseRowRef<'short, E>>

fn rb(&'short self) -> Self::Target

impl<'short, 'a, E: Entity> ReborrowMut<'short> for RowMut<'a, E>

type Target = Matrix<DenseRowMut<'short, E>>

fn rb_mut(&'short mut self) -> Self::Target

impl<E: Entity> RowIndex<Range<usize>> for RowMut<'_, E>

type Target = Matrix<DenseRowMut<'_, E>>

fn get(this: Self, col: Range<usize>) -> Self

unsafe fn get_unchecked(this: Self, row: ColRange) -> Self::Target

impl<E: Entity> RowIndex<RangeFrom<usize>> for RowMut<'_, E>

type Target = Matrix<DenseRowMut<'_, E>>

fn get(this: Self, col: RangeFrom<usize>) -> Self

unsafe fn get_unchecked(this: Self, row: ColRange) -> Self::Target

impl<E: Entity> RowIndex<RangeFull> for RowMut<'_, E>

type Target = Matrix<DenseRowMut<'_, E>>

fn get(this: Self, col: RangeFull) -> Self

unsafe fn get_unchecked(this: Self, row: ColRange) -> Self::Target

impl<E: Entity> RowIndex<RangeInclusive<usize>> for RowMut<'_, E>

type Target = Matrix<DenseRowMut<'_, E>>

fn get(this: Self, col: RangeInclusive<usize>) -> Self

unsafe fn get_unchecked(this: Self, row: ColRange) -> Self::Target

impl<E: Entity> RowIndex<RangeTo<usize>> for RowMut<'_, E>

type Target = Matrix<DenseRowMut<'_, E>>

fn get(this: Self, col: RangeTo<usize>) -> Self

unsafe fn get_unchecked(this: Self, row: ColRange) -> Self::Target

impl<E: Entity> RowIndex<RangeToInclusive<usize>> for RowMut<'_, E>

type Target = Matrix<DenseRowMut<'_, E>>

fn get(this: Self, col: RangeToInclusive<usize>) -> Self

unsafe fn get_unchecked(this: Self, row: ColRange) -> Self::Target

impl<'a, E: Entity> RowIndex<usize> for RowMut<'a, E>

type Target = <<E as Entity>::Group as ForType>::FaerOf<&'a mut <E as Entity>::Unit>

unsafe fn get_unchecked(this: Self, col: usize) -> Self::Target

fn get(this: Self, col: usize) -> Self::Target

impl<E: Entity> ViewMut for &RowMut<'_, E>

type Target<'a> = Matrix<DenseRowRef<'a, E>> where Self: 'a

fn view_mut(&mut self) -> Self::Target<'_>

impl<E: Entity> ViewMut for &mut RowMut<'_, E>

type Target<'a> = Matrix<DenseRowMut<'a, E>> where Self: 'a

fn view_mut(&mut self) -> Self::Target<'_>

impl<E: Entity> ViewMut for RowMut<'_, E>

type Target<'a> = Matrix<DenseRowMut<'a, E>> where Self: 'a

fn view_mut(&mut self) -> Self::Target<'_>