Matrix data type that can store values of mixed types. More...

#include <scmatrix.hxx>

Classes
struct	IterateResult
	When adding all numerical matrix elements for a scalar result such as summation, the interpreter wants to separate the first non-zero value with the rest of the summed values. More...

Public Types
typedef std::function< void(size_t, size_t, double)>	DoubleOpFunction

typedef std::function< void(size_t, size_t, bool)>	BoolOpFunction

typedef std::function< void(size_t, size_t, svl::SharedString)>	StringOpFunction

typedef std::function< void(size_t, size_t)>	EmptyOpFunction

Public Member Functions
	ScMatrix (SCSIZE nC, SCSIZE nR)

	ScMatrix (SCSIZE nC, SCSIZE nR, double fInitVal)

	ScMatrix (size_t nC, size_t nR, const std::vector< double > &rInitVals)

	~ScMatrix ()

ScMatrix *	Clone () const
	Clone the matrix. More...

ScMatrix *	CloneIfConst ()
	Clone the matrix if mbCloneIfConst (immutable) is set, otherwise return this matrix, to be assigned to a ScMatrixRef. More...

void	SetMutable ()
	Set the matrix to mutable for CloneIfConst(), only the interpreter should do this and know the consequences. More...

void	SetImmutable () const
	Set the matrix to immutable for CloneIfConst(), only the interpreter should do this and know the consequences. More...

void	Resize (SCSIZE nC, SCSIZE nR)
	Resize the matrix to specified new dimension. More...

void	Resize (SCSIZE nC, SCSIZE nR, double fVal)

ScMatrix *	CloneAndExtend (SCSIZE nNewCols, SCSIZE nNewRows) const
	Clone the matrix and extend it to the new size. More...

void	IncRef () const

void	DecRef () const

void	SetErrorInterpreter (ScInterpreter *p)

void	GetDimensions (SCSIZE &rC, SCSIZE &rR) const

SCSIZE	GetElementCount () const

bool	ValidColRow (SCSIZE nC, SCSIZE nR) const

bool	ValidColRowReplicated (SCSIZE &rC, SCSIZE &rR) const
	For a row vector or column vector, if the position does not point into the vector but is a valid column or row offset it is adapted such that it points to an element to be replicated, same column row 0 for a row vector, same row column 0 for a column vector. More...

bool	ValidColRowOrReplicated (SCSIZE &rC, SCSIZE &rR) const
	Checks if the matrix position is within the matrix. More...

void	PutDouble (double fVal, SCSIZE nC, SCSIZE nR)

void	PutDouble (double fVal, SCSIZE nIndex)

void	PutDouble (const double *pArray, size_t nLen, SCSIZE nC, SCSIZE nR)

void	PutString (const svl::SharedString &rStr, SCSIZE nC, SCSIZE nR)

void	PutString (const svl::SharedString &rStr, SCSIZE nIndex)

void	PutString (const svl::SharedString *pArray, size_t nLen, SCSIZE nC, SCSIZE nR)

void	PutEmpty (SCSIZE nC, SCSIZE nR)

void	PutEmptyPath (SCSIZE nC, SCSIZE nR)
	Jump sal_False without path. More...

void	PutError (FormulaError nErrorCode, SCSIZE nC, SCSIZE nR)

void	PutBoolean (bool bVal, SCSIZE nC, SCSIZE nR)

void	FillDouble (double fVal, SCSIZE nC1, SCSIZE nR1, SCSIZE nC2, SCSIZE nR2)

void	PutDoubleVector (const ::std::vector< double > &rVec, SCSIZE nC, SCSIZE nR)
	Put a column vector of doubles, starting at row nR, must fit into dimensions. More...

void	PutStringVector (const ::std::vector< svl::SharedString > &rVec, SCSIZE nC, SCSIZE nR)
	Put a column vector of strings, starting at row nR, must fit into dimensions. More...

void	PutEmptyVector (SCSIZE nCount, SCSIZE nC, SCSIZE nR)
	Put a column vector of empties, starting at row nR, must fit into dimensions. More...

void	PutEmptyResultVector (SCSIZE nCount, SCSIZE nC, SCSIZE nR)
	Put a column vector of empty results, starting at row nR, must fit into dimensions. More...

void	PutEmptyPathVector (SCSIZE nCount, SCSIZE nC, SCSIZE nR)
	Put a column vector of empty paths, starting at row nR, must fit into dimensions. More...

FormulaError	GetError (SCSIZE nC, SCSIZE nR) const
	May be used before obtaining the double value of an element to avoid passing its NAN around. More...

FormulaError	GetErrorIfNotString (SCSIZE nC, SCSIZE nR) const
	Use in ScInterpreter to obtain the error code, if any. More...

double	GetDouble (SCSIZE nC, SCSIZE nR) const

double	GetDouble (SCSIZE nIndex) const

double	GetDoubleWithStringConversion (SCSIZE nC, SCSIZE nR) const

svl::SharedString	GetString (SCSIZE nC, SCSIZE nR) const

svl::SharedString	GetString (SCSIZE nIndex) const

svl::SharedString	GetString (SvNumberFormatter &rFormatter, SCSIZE nC, SCSIZE nR) const

ScMatrixValue	Get (SCSIZE nC, SCSIZE nR) const
	: If bString the ScMatrixValue->pS may still be NULL to indicate an empty string! More...

bool	IsStringOrEmpty (SCSIZE nIndex) const

bool	IsStringOrEmpty (SCSIZE nC, SCSIZE nR) const

bool	IsEmpty (SCSIZE nC, SCSIZE nR) const

bool	IsEmptyCell (SCSIZE nC, SCSIZE nR) const

bool	IsEmptyResult (SCSIZE nC, SCSIZE nR) const

bool	IsEmptyPath (SCSIZE nC, SCSIZE nR) const

bool	IsValue (SCSIZE nIndex) const

bool	IsValue (SCSIZE nC, SCSIZE nR) const

bool	IsValueOrEmpty (SCSIZE nC, SCSIZE nR) const

bool	IsBoolean (SCSIZE nC, SCSIZE nR) const

bool	IsNumeric () const

void	MatTrans (const ScMatrix &mRes) const

void	MatCopy (const ScMatrix &mRes) const

void	CompareEqual ()

void	CompareNotEqual ()

void	CompareLess ()

void	CompareGreater ()

void	CompareLessEqual ()

void	CompareGreaterEqual ()

double	And () const

double	Or () const

double	Xor () const

IterateResult	Sum (bool bTextAsZero, bool bIgnoreErrorValues=false) const

IterateResult	SumSquare (bool bTextAsZero, bool bIgnoreErrorValues=false) const

IterateResult	Product (bool bTextAsZero, bool bIgnoreErrorValues=false) const

size_t	Count (bool bCountStrings, bool bCountErrors, bool bIgnoreEmptyStrings=false) const

size_t	MatchDoubleInColumns (double fValue, size_t nCol1, size_t nCol2) const

size_t	MatchStringInColumns (const svl::SharedString &rStr, size_t nCol1, size_t nCol2) const

double	GetMaxValue (bool bTextAsZero, bool bIgnoreErrorValues=false) const

double	GetMinValue (bool bTextAsZero, bool bIgnoreErrorValues=false) const

double	GetGcd () const

double	GetLcm () const

ScMatrixRef	CompareMatrix (sc::Compare &rComp, size_t nMatPos, sc::CompareOptions *pOptions) const

void	GetDoubleArray (std::vector< double > &rArray, bool bEmptyAsZero=true) const
	Convert the content of matrix into a linear array of numeric values. More...

void	MergeDoubleArrayMultiply (std::vector< double > &rArray) const

void	NotOp (const ScMatrix &rMat)

void	NegOp (const ScMatrix &rMat)

void	AddOp (double fVal, const ScMatrix &rMat)

void	SubOp (bool bFlag, double fVal, const ScMatrix &rMat)

void	MulOp (double fVal, const ScMatrix &rMat)

void	DivOp (bool bFlag, double fVal, const ScMatrix &rMat)

void	PowOp (bool bFlag, double fVal, const ScMatrix &rMat)

std::vector< ScMatrix::IterateResult >	Collect (const std::vector< sc::op::Op > &aOp)

void	ExecuteOperation (const std::pair< size_t, size_t > &rStartPos, const std::pair< size_t, size_t > &rEndPos, DoubleOpFunction aDoubleFunc, BoolOpFunction aBoolFunc, StringOpFunction aStringFunc, EmptyOpFunction aEmptyFunc) const

void	MatConcat (SCSIZE nMaxCol, SCSIZE nMaxRow, const ScMatrixRef &xMat1, const ScMatrixRef &xMat2, SvNumberFormatter &rFormatter, svl::SharedStringPool &rPool)

Static Public Member Functions
static bool	IsSizeAllocatable (SCSIZE nC, SCSIZE nR)
	Checks nC or nR for zero and uses GetElementsMax() whether a matrix of the size of nC*nR could be allocated. More...

static bool	IsValueType (ScMatValType nType)
	Value or boolean. More...

static bool	IsBooleanType (ScMatValType nType)
	Boolean. More...

static bool	IsNonValueType (ScMatValType nType)
	String, empty or empty path, but not value nor boolean. More...

static bool	IsRealStringType (ScMatValType nType)
	String, but not empty or empty path or any other type. More...

static bool	IsEmptyType (ScMatValType nType)
	Empty, but not empty path or any other type. More...

static bool	IsEmptyPathType (ScMatValType nType)
	Empty path, but not empty or any other type. More...

Private Member Functions
	ScMatrix (const ScMatrix &)=delete

ScMatrix &	operator= (const ScMatrix &)=delete

Private Attributes
size_t	nRefCnt

bool	mbCloneIfConst

std::unique_ptr< ScMatrixImpl >	pImpl

Friends
class	ScMatrixImpl

Detailed Description

Matrix data type that can store values of mixed types.

Each element can be one of the following types: numeric, string, boolean, empty, and empty path.

Definition at line 113 of file scmatrix.hxx.

Member Typedef Documentation

typedef std::function<void(size_t, size_t, bool)> ScMatrix::BoolOpFunction

Definition at line 131 of file scmatrix.hxx.

typedef std::function<void(size_t, size_t, double)> ScMatrix::DoubleOpFunction

Definition at line 130 of file scmatrix.hxx.

typedef std::function<void(size_t, size_t)> ScMatrix::EmptyOpFunction

Definition at line 133 of file scmatrix.hxx.

typedef std::function<void(size_t, size_t, svl::SharedString)> ScMatrix::StringOpFunction

Definition at line 132 of file scmatrix.hxx.

Constructor & Destructor Documentation

ScMatrix::ScMatrix ( const ScMatrix & )

privatedelete

Referenced by Clone(), and CloneAndExtend().

ScMatrix::ScMatrix	(	SCSIZE	nC,
		SCSIZE	nR
	)

Definition at line 2902 of file scmatrix.cxx.

References CreateDoubleError(), IsSizeAllocatable(), pImpl, and ScMatrixImpl.

ScMatrix::ScMatrix	(	SCSIZE	nC,
		SCSIZE	nR,
		double	fInitVal
	)

Definition at line 2912 of file scmatrix.cxx.

References CreateDoubleError(), IsSizeAllocatable(), pImpl, and ScMatrixImpl.

ScMatrix::ScMatrix	(	size_t	nC,
		size_t	nR,
		const std::vector< double > &	rInitVals
	)

Definition at line 2922 of file scmatrix.cxx.

References CreateDoubleError(), IsSizeAllocatable(), pImpl, and ScMatrixImpl.

ScMatrix::~ScMatrix ( )

Definition at line 2932 of file scmatrix.cxx.

Member Function Documentation

void ScMatrix::AddOp	(	double	fVal,
		const ScMatrix &	rMat
	)

Definition at line 3420 of file scmatrix.cxx.

References a, and pImpl.

double ScMatrix::And ( ) const

Definition at line 3224 of file scmatrix.cxx.

References pImpl.

ScMatrix * ScMatrix::Clone ( ) const

Clone the matrix.

Definition at line 2936 of file scmatrix.cxx.

References MatCopy(), pImpl, ScMatrix(), and SetErrorInterpreter().

Referenced by CloneIfConst().

ScMatrix * ScMatrix::CloneAndExtend	(	SCSIZE	nNewCols,
		SCSIZE	nNewRows
	)		const

Clone the matrix and extend it to the new size.

nNewCols and nNewRows MUST be at least of the size of the original matrix.

Definition at line 2971 of file scmatrix.cxx.

References MatCopy(), pImpl, ScMatrix(), and SetErrorInterpreter().

ScMatrix * ScMatrix::CloneIfConst ( )

Clone the matrix if mbCloneIfConst (immutable) is set, otherwise return this matrix, to be assigned to a ScMatrixRef.

Definition at line 2946 of file scmatrix.cxx.

References Clone(), and mbCloneIfConst.

std::vector< ScMatrix::IterateResult > ScMatrix::Collect ( const std::vector< sc::op::Op > & aOp )

Definition at line 3489 of file scmatrix.cxx.

References pImpl.

void ScMatrix::CompareEqual ( )

Definition at line 3194 of file scmatrix.cxx.

References pImpl.

void ScMatrix::CompareGreater ( )

Definition at line 3209 of file scmatrix.cxx.

References pImpl.

void ScMatrix::CompareGreaterEqual ( )

Definition at line 3219 of file scmatrix.cxx.

References pImpl.

void ScMatrix::CompareLess ( )

Definition at line 3204 of file scmatrix.cxx.

References pImpl.

void ScMatrix::CompareLessEqual ( )

Definition at line 3214 of file scmatrix.cxx.

References pImpl.

ScMatrixRef ScMatrix::CompareMatrix	(	sc::Compare &	rComp,
		size_t	nMatPos,
		sc::CompareOptions *	pOptions
	)		const

Definition at line 3290 of file scmatrix.cxx.

References pImpl.

Referenced by ScInterpreter::CompareMat().

void ScMatrix::CompareNotEqual ( )

Definition at line 3199 of file scmatrix.cxx.

References pImpl.

size_t ScMatrix::Count	(	bool	bCountStrings,
		bool	bCountErrors,
		bool	bIgnoreEmptyStrings = `false`
	)		const

Definition at line 3254 of file scmatrix.cxx.

References pImpl.

void ScMatrix::DecRef ( ) const

Definition at line 2849 of file scmatrix.cxx.

Referenced by intrusive_ptr_release(), and XclExpCachedMatrix::~XclExpCachedMatrix().

void ScMatrix::DivOp	(	bool	bFlag,
		double	fVal,
		const ScMatrix &	rMat
	)

Definition at line 3450 of file scmatrix.cxx.

References a, sc::div(), and pImpl.

void ScMatrix::ExecuteOperation	(	const std::pair< size_t, size_t > &	rStartPos,
		const std::pair< size_t, size_t > &	rEndPos,
		DoubleOpFunction	aDoubleFunc,
		BoolOpFunction	aBoolFunc,
		StringOpFunction	aStringFunc,
		EmptyOpFunction	aEmptyFunc
	)		const

Definition at line 3482 of file scmatrix.cxx.

References pImpl.

void ScMatrix::FillDouble	(	double	fVal,
		SCSIZE	nC1,
		SCSIZE	nR1,
		SCSIZE	nC2,
		SCSIZE	nR2
	)

Definition at line 3164 of file scmatrix.cxx.

References pImpl.

ScMatrixValue ScMatrix::Get	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

: If bString the ScMatrixValue->pS may still be NULL to indicate an empty string!

Definition at line 3094 of file scmatrix.cxx.

References pImpl.

Referenced by ScInterpreter::CalculateMatrixValue(), XclImpExtName::CreateOleData(), ScValidationData::GetSelectionFromFormula(), XclExpFmlaCompImpl::ProcessMatrix(), XclExpCachedMatrix::Save(), ScInterpreter::ScMatRef(), and ScXMLExportDDELinks::WriteTable().

void ScMatrix::GetDimensions	(	SCSIZE &	rC,
		SCSIZE &	rR
	)		const

Definition at line 2984 of file scmatrix.cxx.

References pImpl.

Referenced by ScInterpreter::CalculateMatrixValue(), XclImpExtName::CreateOleData(), ScCompiler::CreateStringFromMatrix(), ScChart2DataSequence::FillCacheFromExternalRef(), ScDocument::FillMatrix(), XclExpCachedMatrix::GetDimensions(), ScFormulaCell::GetResultDimensions(), ScValidationData::GetSelectionFromFormula(), lcl_MatrixCalculation(), XclExpFmlaCompImpl::ProcessMatrix(), ExcelToSc::ReadExtensionArray(), ScInterpreter::ScDde(), ScInterpreter::ScFilterXML(), ScInterpreter::ScMatRef(), and ScXMLExportDDELinks::WriteTable().

double ScMatrix::GetDouble	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: 0.0 if empty or empty path, else value or DoubleError.

Definition at line 3064 of file scmatrix.cxx.

References pImpl.

Referenced by ScCompiler::CreateStringFromMatrix(), ScChart2DataSequence::FillCacheFromExternalRef(), ScDBQueryDataIterator::DataAccessMatrix::getCurrent(), ScDBQueryDataIterator::DataAccessMatrix::isValidQuery(), lcl_LUP_decompose(), lcl_LUP_solve(), lcl_MatrixCalculation(), lcl_storeJumpMatResult(), and ScInterpreter::ScMatInv().

double ScMatrix::GetDouble ( SCSIZE nIndex ) const

Returns: 0.0 if empty or empty path, else value or DoubleError.

Definition at line 3069 of file scmatrix.cxx.

References pImpl.

void ScMatrix::GetDoubleArray	(	std::vector< double > &	rArray,
		bool	bEmptyAsZero = `true`
	)		const

Convert the content of matrix into a linear array of numeric values.

String elements are mapped to NaN's and empty elements are mapped to either NaN or zero values.

Parameters

bEmptyAsZero if true empty elements are mapped to zero values, otherwise they become NaN values.

Definition at line 3296 of file scmatrix.cxx.

References pImpl.

double ScMatrix::GetDoubleWithStringConversion	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: value or DoubleError or string converted to value.

Definition at line 3074 of file scmatrix.cxx.

References pImpl.

SCSIZE ScMatrix::GetElementCount ( ) const

Definition at line 2989 of file scmatrix.cxx.

References pImpl.

FormulaError ScMatrix::GetError	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

May be used before obtaining the double value of an element to avoid passing its NAN around.

: MUST NOT be used if the element is a string! Use GetErrorIfNotString() instead if not sure.

Returns: 0 if no error, else one of err... constants

Definition at line 3059 of file scmatrix.cxx.

References pImpl.

Referenced by ScCompiler::CreateStringFromMatrix().

FormulaError ScMatrix::GetErrorIfNotString	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

inline

Use in ScInterpreter to obtain the error code, if any.

Returns: 0 if no error or string element, else one of err... constants

Definition at line 290 of file scmatrix.hxx.

References GetError().

Referenced by lcl_MatrixCalculation().

double ScMatrix::GetGcd ( ) const

Definition at line 3279 of file scmatrix.cxx.

References pImpl.

double ScMatrix::GetLcm ( ) const

Definition at line 3284 of file scmatrix.cxx.

References pImpl.

double ScMatrix::GetMaxValue	(	bool	bTextAsZero,
		bool	bIgnoreErrorValues = `false`
	)		const

Definition at line 3269 of file scmatrix.cxx.

References pImpl.

double ScMatrix::GetMinValue	(	bool	bTextAsZero,
		bool	bIgnoreErrorValues = `false`
	)		const

Definition at line 3274 of file scmatrix.cxx.

References pImpl.

svl::SharedString ScMatrix::GetString	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: empty string if empty or empty path, else string content.

Definition at line 3079 of file scmatrix.cxx.

References pImpl.

Referenced by ScCompiler::CreateStringFromMatrix(), ScChart2DataSequence::FillCacheFromExternalRef(), ScDBQueryDataIterator::DataAccessMatrix::getCurrent(), ScDBQueryDataIterator::DataAccessMatrix::isValidQuery(), lcl_MatrixCalculation(), and lcl_storeJumpMatResult().

svl::SharedString ScMatrix::GetString ( SCSIZE nIndex ) const

Returns: empty string if empty or empty path, else string content.

Definition at line 3084 of file scmatrix.cxx.

References pImpl.

svl::SharedString ScMatrix::GetString	(	SvNumberFormatter &	rFormatter,
		SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: the matrix element's string if one is present, otherwise the numerical value formatted as string, or in case of an error the error string is returned; an empty string for empty, a "FALSE" string for empty path.

Definition at line 3089 of file scmatrix.cxx.

References pImpl.

void ScMatrix::IncRef ( ) const

Definition at line 2844 of file scmatrix.cxx.

Referenced by intrusive_ptr_add_ref(), TokenPool::StoreMatrix(), and XclExpCachedMatrix::XclExpCachedMatrix().

bool ScMatrix::IsBoolean	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: <TRUE> if boolean.

Definition at line 3144 of file scmatrix.cxx.

References pImpl.

Referenced by ScCompiler::CreateStringFromMatrix(), and ScChart2DataSequence::FillCacheFromExternalRef().

static bool ScMatrix::IsBooleanType ( ScMatValType nType )

inlinestatic

Boolean.

Definition at line 167 of file scmatrix.hxx.

References Boolean.

Referenced by XclExpFmlaCompImpl::ProcessMatrix().

bool ScMatrix::IsEmpty	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: <TRUE> if empty or empty cell or empty result, not empty path.

Definition at line 3109 of file scmatrix.cxx.

References pImpl.

Referenced by ScCompiler::CreateStringFromMatrix(), ScDBQueryDataIterator::DataAccessMatrix::getCurrent(), and lcl_storeJumpMatResult().

bool ScMatrix::IsEmptyCell	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: <TRUE> if empty cell, not empty or empty result or empty path.

Definition at line 3114 of file scmatrix.cxx.

References pImpl.

bool ScMatrix::IsEmptyPath	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: <TRUE> if empty path, not empty or empty cell or empty result.

Definition at line 3124 of file scmatrix.cxx.

References pImpl.

static bool ScMatrix::IsEmptyPathType ( ScMatValType nType )

inlinestatic

Empty path, but not empty or any other type.

Definition at line 193 of file scmatrix.hxx.

References EmptyPath, and NonvalueMask.

Referenced by ScInterpreter::ScMatRef().

bool ScMatrix::IsEmptyResult	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: <TRUE> if empty result, not empty or empty cell or empty path.

Definition at line 3119 of file scmatrix.cxx.

References pImpl.

static bool ScMatrix::IsEmptyType ( ScMatValType nType )

inlinestatic

Empty, but not empty path or any other type.

Definition at line 187 of file scmatrix.hxx.

References Empty, and NonvalueMask.

Referenced by ScInterpreter::ScMatRef(), and ScXMLExportDDELinks::WriteCell().

static bool ScMatrix::IsNonValueType ( ScMatValType nType )

inlinestatic

String, empty or empty path, but not value nor boolean.

Definition at line 173 of file scmatrix.hxx.

References NonvalueMask.

Referenced by ScInterpreter::CalculateMatrixValue(), ScInterpreter::FillEntry(), ScValidationData::GetSelectionFromFormula(), XclExpCachedMatrix::Save(), ScInterpreter::ScMatch(), ScInterpreter::ScMatRef(), and ScXMLExportDDELinks::WriteCell().

bool ScMatrix::IsNumeric ( ) const

Returns: <TRUE> if entire matrix is numeric, including booleans, with no strings or empties

Definition at line 3149 of file scmatrix.cxx.

References pImpl.

static bool ScMatrix::IsRealStringType ( ScMatValType nType )

inlinestatic

String, but not empty or empty path or any other type.

Not named IsStringType to prevent confusion because previously IsNonValueType was named IsStringType.

Definition at line 181 of file scmatrix.hxx.

References NonvalueMask, and String.

Referenced by ScInterpreter::IterateParametersIf(), ScInterpreter::IterateParametersIfs(), ScInterpreter::ScCountIf(), and ScInterpreter::ScHyperLink().

bool ScMatrix::IsSizeAllocatable	(	SCSIZE	nC,
		SCSIZE	nR
	)

static

Checks nC or nR for zero and uses GetElementsMax() whether a matrix of the size of nC*nR could be allocated.

A zero size (both nC and nR zero) matrix is allowed for later resize.

Definition at line 2856 of file scmatrix.cxx.

References bElementsMaxFetched, GetElementsMax(), nElementsMax, SAL_WARN, and SAL_WARN_IF.

Referenced by ScInterpreter::CreateMatrixFromDoubleRef(), ScMatrixImpl::Resize(), ScInterpreter::ScEMat(), ScInterpreter::ScMatDet(), ScInterpreter::ScMatInv(), and ScMatrix().

bool ScMatrix::IsStringOrEmpty ( SCSIZE nIndex ) const

Returns: <TRUE> if string or any empty, empty cell, empty result, empty path, in fact non-value.

Definition at line 3099 of file scmatrix.cxx.

References pImpl.

Referenced by ScCompiler::CreateStringFromMatrix(), ScChart2DataSequence::FillCacheFromExternalRef(), ScDBQueryDataIterator::DataAccessMatrix::getCurrent(), and lcl_MatrixCalculation().

bool ScMatrix::IsStringOrEmpty	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: <TRUE> if string or any empty, empty cell, empty result, empty path, in fact non-value.

Definition at line 3104 of file scmatrix.cxx.

References pImpl.

bool ScMatrix::IsValue ( SCSIZE nIndex ) const

Returns: <TRUE> if value or boolean.

Definition at line 3129 of file scmatrix.cxx.

References pImpl.

Referenced by ScCompiler::CreateStringFromMatrix(), ScChart2DataSequence::FillCacheFromExternalRef(), and lcl_storeJumpMatResult().

bool ScMatrix::IsValue	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: <TRUE> if value or boolean.

Definition at line 3134 of file scmatrix.cxx.

References pImpl.

bool ScMatrix::IsValueOrEmpty	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Returns: <TRUE> if value or boolean or empty or empty path.

Definition at line 3139 of file scmatrix.cxx.

References pImpl.

Referenced by lcl_MatrixCalculation().

static bool ScMatrix::IsValueType ( ScMatValType nType )

inlinestatic

Value or boolean.

Definition at line 161 of file scmatrix.hxx.

References Boolean.

Referenced by XclExpFmlaCompImpl::ProcessMatrix(), ScInterpreter::ScHyperLink(), ScInterpreter::ScSwitch_MS(), and ScInterpreter::ScT().

size_t ScMatrix::MatchDoubleInColumns	(	double	fValue,
		size_t	nCol1,
		size_t	nCol2
	)		const

Definition at line 3259 of file scmatrix.cxx.

References pImpl.

size_t ScMatrix::MatchStringInColumns	(	const svl::SharedString &	rStr,
		size_t	nCol1,
		size_t	nCol2
	)		const

Definition at line 3264 of file scmatrix.cxx.

References pImpl.

void ScMatrix::MatConcat	(	SCSIZE	nMaxCol,
		SCSIZE	nMaxRow,
		const ScMatrixRef &	xMat1,
		const ScMatrixRef &	xMat2,
		SvNumberFormatter &	rFormatter,
		svl::SharedStringPool &	rPool
	)

Definition at line 3501 of file scmatrix.cxx.

References pImpl.

void ScMatrix::MatCopy ( const ScMatrix & mRes ) const

Definition at line 3154 of file scmatrix.cxx.

References pImpl.

Referenced by Clone(), CloneAndExtend(), and ScInterpreter::ScDde().

void ScMatrix::MatTrans ( const ScMatrix & mRes ) const

Definition at line 3159 of file scmatrix.cxx.

References pImpl.

void ScMatrix::MergeDoubleArrayMultiply ( std::vector< double > & rArray ) const

Definition at line 3301 of file scmatrix.cxx.

References pImpl.

void ScMatrix::MulOp	(	double	fVal,
		const ScMatrix &	rMat
	)

Definition at line 3443 of file scmatrix.cxx.

References a, and pImpl.

void ScMatrix::NegOp ( const ScMatrix & rMat )

Definition at line 3413 of file scmatrix.cxx.

References a, and pImpl.

void ScMatrix::NotOp ( const ScMatrix & rMat )

Definition at line 3406 of file scmatrix.cxx.

References a, and pImpl.

ScMatrix& ScMatrix::operator= ( const ScMatrix & )

privatedelete

double ScMatrix::Or ( ) const

Definition at line 3229 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PowOp	(	bool	bFlag,
		double	fVal,
		const ScMatrix &	rMat
	)

Definition at line 3466 of file scmatrix.cxx.

References a, pImpl, and sc::power().

ScMatrix::IterateResult ScMatrix::Product	(	bool	bTextAsZero,
		bool	bIgnoreErrorValues = `false`
	)		const

Definition at line 3249 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutBoolean	(	bool	bVal,
		SCSIZE	nC,
		SCSIZE	nR
	)

Definition at line 3054 of file scmatrix.cxx.

References pImpl.

Referenced by ScTokenArray::MergeArray(), and ExcelToSc::ReadExtensionArray().

void ScMatrix::PutDouble	(	double	fVal,
		SCSIZE	nC,
		SCSIZE	nR
	)

Definition at line 3009 of file scmatrix.cxx.

References pImpl.

Referenced by lcl_LUP_decompose(), ScTokenArray::MergeArray(), and ExcelToSc::ReadExtensionArray().

void ScMatrix::PutDouble	(	double	fVal,
		SCSIZE	nIndex
	)

Definition at line 3014 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutDouble	(	const double *	pArray,
		size_t	nLen,
		SCSIZE	nC,
		SCSIZE	nR
	)

Definition at line 3019 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutDoubleVector	(	const ::std::vector< double > &	rVec,
		SCSIZE	nC,
		SCSIZE	nR
	)

Put a column vector of doubles, starting at row nR, must fit into dimensions.

Definition at line 3169 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutEmpty	(	SCSIZE	nC,
		SCSIZE	nR
	)

Definition at line 3039 of file scmatrix.cxx.

References pImpl.

Referenced by ScTokenArray::MergeArray(), and ExcelToSc::ReadExtensionArray().

void ScMatrix::PutEmptyPath	(	SCSIZE	nC,
		SCSIZE	nR
	)

Jump sal_False without path.

Definition at line 3044 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutEmptyPathVector	(	SCSIZE	nCount,
		SCSIZE	nC,
		SCSIZE	nR
	)

Put a column vector of empty paths, starting at row nR, must fit into dimensions.

Definition at line 3189 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutEmptyResultVector	(	SCSIZE	nCount,
		SCSIZE	nC,
		SCSIZE	nR
	)

Put a column vector of empty results, starting at row nR, must fit into dimensions.

Definition at line 3184 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutEmptyVector	(	SCSIZE	nCount,
		SCSIZE	nC,
		SCSIZE	nR
	)

Put a column vector of empties, starting at row nR, must fit into dimensions.

Definition at line 3179 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutError	(	FormulaError	nErrorCode,
		SCSIZE	nC,
		SCSIZE	nR
	)

Definition at line 3049 of file scmatrix.cxx.

References pImpl.

Referenced by ExcelToSc::ReadExtensionArray().

void ScMatrix::PutString	(	const svl::SharedString &	rStr,
		SCSIZE	nC,
		SCSIZE	nR
	)

Definition at line 3024 of file scmatrix.cxx.

References pImpl.

Referenced by ScTokenArray::MergeArray(), and ExcelToSc::ReadExtensionArray().

void ScMatrix::PutString	(	const svl::SharedString &	rStr,
		SCSIZE	nIndex
	)

Definition at line 3029 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutString	(	const svl::SharedString *	pArray,
		size_t	nLen,
		SCSIZE	nC,
		SCSIZE	nR
	)

Definition at line 3034 of file scmatrix.cxx.

References pImpl.

void ScMatrix::PutStringVector	(	const ::std::vector< svl::SharedString > &	rVec,
		SCSIZE	nC,
		SCSIZE	nR
	)

Put a column vector of strings, starting at row nR, must fit into dimensions.

Definition at line 3174 of file scmatrix.cxx.

References pImpl.

void ScMatrix::Resize	(	SCSIZE	nC,
		SCSIZE	nR
	)

Resize the matrix to specified new dimension.

Definition at line 2961 of file scmatrix.cxx.

References pImpl.

Referenced by ExcelToSc::ReadExtensionArray().

void ScMatrix::Resize	(	SCSIZE	nC,
		SCSIZE	nR,
		double	fVal
	)

Definition at line 2966 of file scmatrix.cxx.

References pImpl.

void ScMatrix::SetErrorInterpreter ( ScInterpreter * p )

Definition at line 2979 of file scmatrix.cxx.

References pImpl.

Referenced by Clone(), and CloneAndExtend().

void ScMatrix::SetImmutable ( ) const

Set the matrix to immutable for CloneIfConst(), only the interpreter should do this and know the consequences.

Definition at line 2956 of file scmatrix.cxx.

References mbCloneIfConst.

void ScMatrix::SetMutable ( )

Set the matrix to mutable for CloneIfConst(), only the interpreter should do this and know the consequences.

Definition at line 2951 of file scmatrix.cxx.

References mbCloneIfConst.

void ScMatrix::SubOp	(	bool	bFlag,
		double	fVal,
		const ScMatrix &	rMat
	)

Definition at line 3427 of file scmatrix.cxx.

References a, and pImpl.

ScMatrix::IterateResult ScMatrix::Sum	(	bool	bTextAsZero,
		bool	bIgnoreErrorValues = `false`
	)		const

Definition at line 3239 of file scmatrix.cxx.

References pImpl.

ScMatrix::IterateResult ScMatrix::SumSquare	(	bool	bTextAsZero,
		bool	bIgnoreErrorValues = `false`
	)		const

Definition at line 3244 of file scmatrix.cxx.

References pImpl.

bool ScMatrix::ValidColRow	(	SCSIZE	nC,
		SCSIZE	nR
	)		const

Definition at line 2994 of file scmatrix.cxx.

References pImpl.

Referenced by ValidColRowOrReplicated().

bool ScMatrix::ValidColRowOrReplicated	(	SCSIZE &	rC,
		SCSIZE &	rR
	)		const

Checks if the matrix position is within the matrix.

If it is not, for a row vector or column vector the position is adapted such that it points to an element to be replicated, same column row 0 for a row vector, same row column 0 for a column vector. Else, for a 2D matrix and position not within matrix, returns false.

Definition at line 3004 of file scmatrix.cxx.

References ValidColRow(), and ValidColRowReplicated().

bool ScMatrix::ValidColRowReplicated	(	SCSIZE &	rC,
		SCSIZE &	rR
	)		const

For a row vector or column vector, if the position does not point into the vector but is a valid column or row offset it is adapted such that it points to an element to be replicated, same column row 0 for a row vector, same row column 0 for a column vector.

Else, for a 2D matrix, returns false.

Definition at line 2999 of file scmatrix.cxx.

References pImpl.

Referenced by ValidColRowOrReplicated().

double ScMatrix::Xor ( ) const

Definition at line 3234 of file scmatrix.cxx.

References pImpl.

Friends And Related Function Documentation

friend class ScMatrixImpl

friend

Definition at line 115 of file scmatrix.hxx.

Referenced by ScMatrix().

Member Data Documentation

bool ScMatrix::mbCloneIfConst

mutableprivate

Definition at line 118 of file scmatrix.hxx.

Referenced by CloneIfConst(), SetImmutable(), and SetMutable().

size_t ScMatrix::nRefCnt

mutableprivate

Definition at line 117 of file scmatrix.hxx.

std::unique_ptr<ScMatrixImpl> ScMatrix::pImpl

private

Definition at line 119 of file scmatrix.hxx.

Referenced by AddOp(), And(), Clone(), CloneAndExtend(), Collect(), CompareEqual(), CompareGreater(), CompareGreaterEqual(), CompareLess(), CompareLessEqual(), CompareMatrix(), CompareNotEqual(), Count(), DivOp(), ExecuteOperation(), FillDouble(), Get(), GetDimensions(), GetDouble(), GetDoubleArray(), GetDoubleWithStringConversion(), GetElementCount(), GetError(), GetGcd(), GetLcm(), GetMaxValue(), GetMinValue(), GetString(), IsBoolean(), IsEmpty(), IsEmptyCell(), IsEmptyPath(), IsEmptyResult(), IsNumeric(), IsStringOrEmpty(), IsValue(), IsValueOrEmpty(), MatchDoubleInColumns(), MatchStringInColumns(), MatConcat(), MatCopy(), MatTrans(), MergeDoubleArrayMultiply(), MulOp(), NegOp(), NotOp(), Or(), PowOp(), Product(), PutBoolean(), PutDouble(), PutDoubleVector(), PutEmpty(), PutEmptyPath(), PutEmptyPathVector(), PutEmptyResultVector(), PutEmptyVector(), PutError(), PutString(), PutStringVector(), Resize(), ScMatrix(), SetErrorInterpreter(), SubOp(), Sum(), SumSquare(), ValidColRow(), ValidColRowReplicated(), and Xor().

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

Classes

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation