Classes | Public Types | Public Member Functions | Private Types | Private Attributes | List of all members
blaze::DMatDMatSubExpr< MT1, MT2, SO > Class Template Reference

Expression object for dense matrix-dense matrix subtractions.The DMatDMatSubExpr class represents the compile time expression for subtractions between dense matrices with identical storage order. More...

#include <DMatDMatSubExpr.h>

Inherits blaze::DenseMatrix< DMatDMatSubExpr< MT1, MT2, SO >, SO >, blaze::MatMatSubExpr, and blaze::Computation.

Classes

class  ConstIterator
 Iterator over the elements of the dense matrix. More...
 

Public Types

enum  : bool { simdEnabled }
 Compilation switch for the expression template evaluation strategy.
 
enum  : bool { smpAssignable = MT1::smpAssignable && MT2::smpAssignable }
 Compilation switch for the expression template assignment strategy.
 
enum  : size_t { SIMDSIZE = SIMDTrait<ElementType>::size }
 The number of elements packed within a single SIMD element.
 
typedef DMatDMatSubExpr< MT1, MT2, SO > This
 Type of this DMatDMatSubExpr instance.
 
typedef SubTrait_< RT1, RT2ResultType
 Result type for expression template evaluations.
 
typedef OppositeType_< ResultTypeOppositeType
 Result type with opposite storage order for expression template evaluations.
 
typedef TransposeType_< ResultTypeTransposeType
 Transpose type for expression template evaluations.
 
typedef ElementType_< ResultTypeElementType
 Resulting element type.
 
typedef const IfTrue_< returnExpr, ExprReturnType, ElementTypeReturnType
 Return type for expression template evaluations.
 
typedef IfTrue_< useAssign, const ResultType, const DMatDMatSubExpr & > CompositeType
 Data type for composite expression templates.
 
typedef If_< IsExpression< MT1 >, const MT1, const MT1 & > LeftOperand
 Composite type of the left-hand side dense matrix expression.
 
typedef If_< IsExpression< MT2 >, const MT2, const MT2 & > RightOperand
 Composite type of the right-hand side dense matrix expression.
 
typedef MT MatrixType
 Type of the matrix.
 

Public Member Functions

 DMatDMatSubExpr (const MT1 &lhs, const MT2 &rhs) noexcept
 Constructor for the DMatDMatSubExpr class. More...
 
ReturnType operator() (size_t i, size_t j) const
 2D-access to the matrix elements. More...
 
ReturnType at (size_t i, size_t j) const
 Checked access to the matrix elements. More...
 
BLAZE_ALWAYS_INLINE auto load (size_t i, size_t j) const noexcept
 Access to the SIMD elements of the matrix. More...
 
ConstIterator begin (size_t i) const
 Returns an iterator to the first non-zero element of row i. More...
 
ConstIterator end (size_t i) const
 Returns an iterator just past the last non-zero element of row i. More...
 
size_t rows () const noexcept
 Returns the current number of rows of the matrix. More...
 
size_t columns () const noexcept
 Returns the current number of columns of the matrix. More...
 
LeftOperand leftOperand () const noexcept
 Returns the left-hand side dense matrix operand. More...
 
RightOperand rightOperand () const noexcept
 Returns the right-hand side dense matrix operand. More...
 
template<typename T >
bool canAlias (const T *alias) const noexcept
 Returns whether the expression can alias with the given address alias. More...
 
template<typename T >
bool isAliased (const T *alias) const noexcept
 Returns whether the expression is aliased with the given address alias. More...
 
bool isAligned () const noexcept
 Returns whether the operands of the expression are properly aligned in memory. More...
 
bool canSMPAssign () const noexcept
 Returns whether the expression can be used in SMP assignments. More...
 
BLAZE_ALWAYS_INLINE MatrixTypeoperator~ () noexcept
 Conversion operator for non-constant matrices. More...
 
BLAZE_ALWAYS_INLINE const MatrixTypeoperator~ () const noexcept
 Conversion operator for constant matrices. More...
 

Private Types

enum  : bool { returnExpr = !IsTemporary<RN1>::value && !IsTemporary<RN2>::value }
 Compilation switch for the selection of the subscript operator return type. More...
 
enum  : bool { useAssign = RequiresEvaluation<MT1>::value || RequiresEvaluation<MT2>::value || !returnExpr }
 Compilation switch for the serial evaluation strategy of the subtraction expression. More...
 
typedef ResultType_< MT1 > RT1
 Result type of the left-hand side dense matrix expression.
 
typedef ResultType_< MT2 > RT2
 Result type of the right-hand side dense matrix expression.
 
typedef ReturnType_< MT1 > RN1
 Return type of the left-hand side dense matrix expression.
 
typedef ReturnType_< MT2 > RN2
 Return type of the right-hand side dense matrix expression.
 
typedef CompositeType_< MT1 > CT1
 Composite type of the left-hand side dense matrix expression.
 
typedef CompositeType_< MT2 > CT2
 Composite type of the right-hand side dense matrix expression.
 
typedef ElementType_< MT1 > ET1
 Element type of the left-hand side dense matrix expression.
 
typedef ElementType_< MT2 > ET2
 Element type of the right-hand side dense matrix expression.
 
typedef SubExprTrait_< RN1, RN2ExprReturnType
 Expression return type for the subscript operator.
 

Private Attributes

LeftOperand lhs_
 Left-hand side dense matrix of the subtraction expression.
 
RightOperand rhs_
 Right-hand side dense matrix of the subtraction expression.
 

Detailed Description

template<typename MT1, typename MT2, bool SO>
class blaze::DMatDMatSubExpr< MT1, MT2, SO >

Expression object for dense matrix-dense matrix subtractions.

The DMatDMatSubExpr class represents the compile time expression for subtractions between dense matrices with identical storage order.

Member Enumeration Documentation

template<typename MT1, typename MT2, bool SO>
anonymous enum : bool
private

Compilation switch for the selection of the subscript operator return type.

The returnExpr compile time constant expression is a compilation switch for the selection of the ReturnType. If either matrix operand returns a temporary vector or matrix, returnExpr will be set to false and the subscript operator will return it's result by value. Otherwise returnExpr will be set to true and the subscript operator may return it's result as an expression.

template<typename MT1, typename MT2, bool SO>
anonymous enum : bool
private

Compilation switch for the serial evaluation strategy of the subtraction expression.

The useAssign compile time constant expression represents a compilation switch for the serial evaluation strategy of the subtraction expression. In case either of the two dense matrix operands requires an intermediate evaluation or the subscript operator can only return by value, useAssign will be set to 1 and the subtraction expression will be evaluated via the assign function family. Otherwise useAssign will be set to 0 and the expression will be evaluated via the function call operator.

Constructor & Destructor Documentation

template<typename MT1, typename MT2, bool SO>
blaze::DMatDMatSubExpr< MT1, MT2, SO >::DMatDMatSubExpr ( const MT1 &  lhs,
const MT2 &  rhs 
)
inlineexplicitnoexcept

Constructor for the DMatDMatSubExpr class.

Parameters
lhsThe left-hand side operand of the subtraction expression.
rhsThe right-hand side operand of the subtraction expression.

Member Function Documentation

template<typename MT1, typename MT2, bool SO>
ReturnType blaze::DMatDMatSubExpr< MT1, MT2, SO >::at ( size_t  i,
size_t  j 
) const
inline

Checked access to the matrix elements.

Parameters
iAccess index for the row. The index has to be in the range $[0..M-1]$.
jAccess index for the column. The index has to be in the range $[0..N-1]$.
Returns
The resulting value.
Exceptions
std::out_of_rangeInvalid matrix access index.
template<typename MT1, typename MT2, bool SO>
ConstIterator blaze::DMatDMatSubExpr< MT1, MT2, SO >::begin ( size_t  i) const
inline

Returns an iterator to the first non-zero element of row i.

Parameters
iThe row index.
Returns
Iterator to the first non-zero element of row i.
template<typename MT1, typename MT2, bool SO>
template<typename T >
bool blaze::DMatDMatSubExpr< MT1, MT2, SO >::canAlias ( const T *  alias) const
inlinenoexcept

Returns whether the expression can alias with the given address alias.

Parameters
aliasThe alias to be checked.
Returns
true in case the expression can alias, false otherwise.
template<typename MT1, typename MT2, bool SO>
bool blaze::DMatDMatSubExpr< MT1, MT2, SO >::canSMPAssign ( ) const
inlinenoexcept

Returns whether the expression can be used in SMP assignments.

Returns
true in case the expression can be used in SMP assignments, false if not.
template<typename MT1, typename MT2, bool SO>
size_t blaze::DMatDMatSubExpr< MT1, MT2, SO >::columns ( ) const
inlinenoexcept

Returns the current number of columns of the matrix.

Returns
The number of columns of the matrix.
template<typename MT1, typename MT2, bool SO>
ConstIterator blaze::DMatDMatSubExpr< MT1, MT2, SO >::end ( size_t  i) const
inline

Returns an iterator just past the last non-zero element of row i.

Parameters
iThe row index.
Returns
Iterator just past the last non-zero element of row i.
template<typename MT1, typename MT2, bool SO>
template<typename T >
bool blaze::DMatDMatSubExpr< MT1, MT2, SO >::isAliased ( const T *  alias) const
inlinenoexcept

Returns whether the expression is aliased with the given address alias.

Parameters
aliasThe alias to be checked.
Returns
true in case an alias effect is detected, false otherwise.
template<typename MT1, typename MT2, bool SO>
bool blaze::DMatDMatSubExpr< MT1, MT2, SO >::isAligned ( ) const
inlinenoexcept

Returns whether the operands of the expression are properly aligned in memory.

Returns
true in case the operands are aligned, false if not.
template<typename MT1, typename MT2, bool SO>
LeftOperand blaze::DMatDMatSubExpr< MT1, MT2, SO >::leftOperand ( ) const
inlinenoexcept

Returns the left-hand side dense matrix operand.

Returns
The left-hand side dense matrix operand.
template<typename MT1, typename MT2, bool SO>
BLAZE_ALWAYS_INLINE auto blaze::DMatDMatSubExpr< MT1, MT2, SO >::load ( size_t  i,
size_t  j 
) const
inlinenoexcept

Access to the SIMD elements of the matrix.

Parameters
iAccess index for the row. The index has to be in the range $[0..M-1]$.
jAccess index for the column. The index has to be in the range $[0..N-1]$.
Returns
Reference to the accessed values.
template<typename MT1, typename MT2, bool SO>
ReturnType blaze::DMatDMatSubExpr< MT1, MT2, SO >::operator() ( size_t  i,
size_t  j 
) const
inline

2D-access to the matrix elements.

Parameters
iAccess index for the row. The index has to be in the range $[0..M-1]$.
jAccess index for the column. The index has to be in the range $[0..N-1]$.
Returns
The resulting value.
template<typename MT, bool SO>
BLAZE_ALWAYS_INLINE MatrixType& blaze::Matrix< MT, SO >::operator~ ( )
inlinenoexceptinherited

Conversion operator for non-constant matrices.

Returns
Reference of the actual type of the matrix.
template<typename MT, bool SO>
BLAZE_ALWAYS_INLINE const MatrixType& blaze::Matrix< MT, SO >::operator~ ( ) const
inlinenoexceptinherited

Conversion operator for constant matrices.

Returns
Constant reference of the actual type of the matrix.
template<typename MT1, typename MT2, bool SO>
RightOperand blaze::DMatDMatSubExpr< MT1, MT2, SO >::rightOperand ( ) const
inlinenoexcept

Returns the right-hand side dense matrix operand.

Returns
The right-hand side dense matrix operand.
template<typename MT1, typename MT2, bool SO>
size_t blaze::DMatDMatSubExpr< MT1, MT2, SO >::rows ( ) const
inlinenoexcept

Returns the current number of rows of the matrix.

Returns
The number of rows of the matrix.

The documentation for this class was generated from the following file: