CellArray is a particular type of Variable specialized for cell arrays. More...

#include <matioCpp/CellArray.h>

Inheritance diagram for matioCpp::CellArray:

Public Types
using	index_type = size_t

Public Member Functions
	CellArray ()
	The type used for indices.

	CellArray (const std::string &name)
	Constructor.

	CellArray (const std::string &name, const std::vector< index_type > &dimensions)
	Constructor.

	CellArray (const std::string &name, const std::vector< index_type > &dimensions, std::vector< Variable > &elements)
	Constructor.

	CellArray (const CellArray &other)
	Copy constructor.

	CellArray (CellArray &&other)
	Move constructor.

	CellArray (const MatvarHandler &handler)
	Constructor to share the data ownership of another variable.

	~CellArray ()
	Destructor.

CellArray &	operator= (const CellArray &other)
	Assignement operator (copy) from another CellArray.

CellArray &	operator= (CellArray &&other)
	Assignement operator (move) from another CellArray.

bool	fromVectorOfVariables (const std::vector< index_type > &dimensions, std::vector< Variable > &elements)
	Set from a vector of Variables.

index_type	rawIndexFromIndices (const std::vector< index_type > &el) const
	Get the linear index corresponding to the provided indices.

bool	indicesFromRawIndex (size_t rawIndex, std::vector< index_type > &el) const
	Get the indices given the raw index.

bool	setName (const std::string &newName)
	Change the name of the Variable.

void	resize (const std::vector< index_type > &newDimensions)
	Resize the cell array.

void	clear ()
	Clear the cell array.

index_type	numberOfElements () const
	Get the total number of elements in the array.

bool	setElement (const std::vector< index_type > &el, const Variable &newValue)
	Set the element at the specified position.

bool	setElement (index_type el, const Variable &newValue)
	Set the element at the specified position.

matioCpp::Variable	operator() (const std::vector< index_type > &el)
	Access specified element.

const matioCpp::Variable	operator() (const std::vector< index_type > &el) const
	Access specified element.

matioCpp::Variable	operator() (index_type el)
	Access specified element.

const matioCpp::Variable	operator() (index_type el) const
	Access specified element.

matioCpp::Variable	operator[] (const std::vector< index_type > &el)
	Access specified element.

const matioCpp::Variable	operator[] (const std::vector< index_type > &el) const
	Access specified element.

matioCpp::Variable	operator[] (index_type el)
	Access specified element.

const matioCpp::Variable	operator[] (index_type el) const
	Access specified element.

Public Member Functions inherited from matioCpp::Variable
	Variable ()
	Default constructor.

	Variable (const matvar_t *inputVar)
	Constructor from an existing matvar_t pointer.

	Variable (const Variable &other)
	Copy constructor.

	Variable (Variable &&other)
	Move constructor.

	Variable (const MatvarHandler &handler)
	Constructor to share the data ownership of another variable.

	~Variable ()
	Destructor.

Variable &	operator= (const Variable &other)
	Copy assignement.

Variable &	operator= (Variable &&other)
	Move assignement.

bool	fromMatio (const matvar_t *inputVar)
	Set this variable from an existing matio variable.

bool	fromOther (const Variable &other)
	Set this variable from another variable.

bool	fromOther (Variable &&other)
	Set this variable from another variable.

const matvar_t *	toMatio () const
	Convert this Variable to a matio variable.

matvar_t *	toMatio ()
	Convert this Variable to a matio variable.

std::string	name () const
	Get the name of the Variable.

matioCpp::VariableType	variableType () const
	Get the VariableType.

matioCpp::ValueType	valueType () const
	Get the ValueType.

bool	isComplex () const
	Get if the variable is complex.

matioCpp::Span< const size_t >	dimensions () const
	Get the dimensions of this object.

bool	isValid () const
	Check if the variable is valid.

matioCpp::Variable	operator[] (const std::string &el)
	Access field with specific name.

const matioCpp::Variable	operator[] (const std::string &el) const
	Access field with specific name.

template<typename T >
matioCpp::Element< T >	asElement ()
	Cast the variable as a Element.

template<typename T >
const matioCpp::Element< T >	asElement () const
	Cast the variable as a const Element.

template<typename T >
matioCpp::Vector< T >	asVector ()
	Cast the variable as a Vector.

template<typename T >
const matioCpp::Vector< T >	asVector () const
	Cast the variable as a const Vector.

matioCpp::String	asString ()
	Cast the variable as a String.

const matioCpp::String	asString () const
	Cast the variable as a const String.

matioCpp::String16	asString16 ()
	Cast the variable as a String16.

const matioCpp::String16	asString16 () const
	Cast the variable as a const String16.

matioCpp::String32	asString32 ()
	Cast the variable as a String32.

const matioCpp::String32	asString32 () const
	Cast the variable as a const String32.

template<typename T >
matioCpp::MultiDimensionalArray< T >	asMultiDimensionalArray ()
	Cast the variable as a MultiDimensionalArray.

template<typename T >
const matioCpp::MultiDimensionalArray< T >	asMultiDimensionalArray () const
	Cast the variable as a const MultiDimensionalArray.

matioCpp::CellArray	asCellArray ()
	Cast the variable as a CellArray.

const matioCpp::CellArray	asCellArray () const
	Cast the variable as a const CellArray.

matioCpp::Struct	asStruct ()
	Cast the variable as a Struct.

const matioCpp::Struct	asStruct () const
	Cast the variable as a const Struct.

matioCpp::StructArray	asStructArray ()
	Cast the variable as a StructArray.

const matioCpp::StructArray	asStructArray () const
	Cast the variable as a const StructArray.

Additional Inherited Members
Protected Member Functions inherited from matioCpp::Variable
bool	initializeVariable (const std::string &name, const VariableType &variableType, const ValueType &valueType, matioCpp::Span< const size_t > dimensions, void *data)
	Initialize the variable.

bool	initializeComplexVariable (const std::string &name, const VariableType &variableType, const ValueType &valueType, matioCpp::Span< const size_t > dimensions, void realData, void imaginaryData)
	Initialize a complex variable.

template<typename T >
bool	initializeComplexVector (const std::string &name, const Span< T > realInputVector, const Span< T > imaginaryInputVector)
	Initialize a complex vector.

bool	changeName (const std::string &newName)
	Change the name of the variable.

size_t	getArrayNumberOfElements () const
	Get the total number of elements in the array.

bool	setCellElement (size_t linearIndex, const Variable &newValue)
	Set a cell element at a specified linear position.

Variable	getCellElement (size_t linearIndex)
	Get a cell element at a specified linear position.

const Variable	getCellElement (size_t linearIndex) const
	Get a cell element at a specified linear position.

size_t	getStructNumberOfFields () const
	Get the total number of fields in the variable, considered as a struct.

char const	getStructFields () const
	Get the list of fields in the variable, considered as a struct.

bool	getStructFieldIndex (const std::string &field, size_t &index) const
	Get the index of the specified field in the variable, considered as a struct.

bool	setStructField (size_t index, const Variable &newValue, size_t structPositionInArray=0)
	Set the field of the struct at the specified position.

bool	addStructField (const std::string &newField)
	Add a new field to the variable, considered as a struct.

bool	setStructField (const std::string &field, const Variable &newValue, size_t structPositionInArray=0)
	Set the field of the struct given the newValue name.

Variable	getStructField (size_t index, size_t structPositionInArray=0)
	Get the specified field in the variable, considered as a struct.

const Variable	getStructField (size_t index, size_t structPositionInArray=0) const
	Get the specified field in the variable, considered as a struct.

Struct	getStructArrayElement (size_t linearIndex)
	Get an element of the variable, considered as a StructArray.

const Struct	getStructArrayElement (size_t linearIndex) const
	Get an element of the variable, considered as a StructArray.

Detailed Description

CellArray is a particular type of Variable specialized for cell arrays.

Definition at line 17 of file CellArray.h.

Member Typedef Documentation

◆ index_type

using matioCpp::CellArray::index_type = size_t

Definition at line 31 of file CellArray.h.

Constructor & Destructor Documentation

◆ CellArray() [1/7]

matioCpp::CellArray::CellArray ( )

The type used for indices.

Default Constructor

Note: The name is set to "unnamed_cell_array".

Definition at line 27 of file CellArray.cpp.

References matioCpp::CellArray, and matioCpp::VARIABLE.

◆ CellArray() [2/7]

matioCpp::CellArray::CellArray ( const std::string & name )

Constructor.

Parameters

name	The name of the CellArray

Definition at line 36 of file CellArray.cpp.

References matioCpp::CellArray, and matioCpp::VARIABLE.

◆ CellArray() [3/7]

matioCpp::CellArray::CellArray	(	const std::string &	name,
		const std::vector< index_type > &	dimensions
	)

Constructor.

Parameters

name	The name of the CellArray
dimensions	The dimensions of the CellArray

Definition at line 45 of file CellArray.cpp.

References matioCpp::CellArray, std::endl(), and matioCpp::VARIABLE.

◆ CellArray() [4/7]

matioCpp::CellArray::CellArray	(	const std::string &	name,
		const std::vector< index_type > &	dimensions,
		std::vector< Variable > &	elements
	)

Constructor.

Parameters

name	The name of the CellArray
dimensions	The dimensions of the CellArray
elements	The elements to be added to the CellArray (they are copied)

Note: The name of the variables in the vector is not used; The vector is supposed to contain the variables in column-major format. For example, an array of dimension 2x3x4 needs a dimension vector of size 3 with content {2,3,4}. The elements vector is supposed to be 24 dimensional.

Definition at line 62 of file CellArray.cpp.

References matioCpp::CellArray, matioCpp::MultiDimensionalArray< T >::data(), std::endl(), matioCpp::MatvarHandler::GetMatvarDuplicate(), std::vector< T >::size(), and matioCpp::VARIABLE.

◆ CellArray() [5/7]

matioCpp::CellArray::CellArray ( const CellArray & other )

Copy constructor.

Definition at line 92 of file CellArray.cpp.

◆ CellArray() [6/7]

matioCpp::CellArray::CellArray ( CellArray && other )

Move constructor.

Definition at line 97 of file CellArray.cpp.

◆ CellArray() [7/7]

matioCpp::CellArray::CellArray ( const MatvarHandler & handler )

Constructor to share the data ownership of another variable.

Parameters

handler The MatvarHandler handler to the matvar_t which has to be shared.

Definition at line 102 of file CellArray.cpp.

References matioCpp::CellArray, matioCpp::Variable::initializeVariable(), matioCpp::Variable::valueType(), matioCpp::VARIABLE, and matioCpp::Variable::variableType().

◆ ~CellArray()

matioCpp::CellArray::~CellArray ( )

Destructor.

Definition at line 116 of file CellArray.cpp.

Member Function Documentation

◆ clear()

void matioCpp::CellArray::clear ( )

Clear the cell array.

Definition at line 225 of file CellArray.cpp.

References std::move().

◆ fromVectorOfVariables()

bool matioCpp::CellArray::fromVectorOfVariables	(	const std::vector< index_type > &	dimensions,
		std::vector< Variable > &	elements
	)

Set from a vector of Variables.

Note: The vector is supposed to contain the variables in column-major format.; The name of the variables is not used

Parameters

dimensions	The input dimensions
elements	The input vector of variables.

Returns: True if successful. False otherwise, for example if one of the input variables is not valid.

Definition at line 133 of file CellArray.cpp.

References matioCpp::CellArray, matioCpp::MultiDimensionalArray< T >::data(), std::endl(), matioCpp::MatvarHandler::GetMatvarDuplicate(), std::vector< T >::size(), and matioCpp::VARIABLE.

◆ indicesFromRawIndex()

bool matioCpp::CellArray::indicesFromRawIndex	(	size_t	rawIndex,
		std::vector< index_type > &	el
	)		const

Get the indices given the raw index.

Parameters

rawIndex	The input raw index from which to compute the indices
el	The output indices

Returns: True if successful, false otherwise (for example if rawIndex is out of bounds)

Definition at line 182 of file CellArray.cpp.

References std::endl(), and matioCpp::MultiDimensionalArray< T >::resize().

◆ numberOfElements()

matioCpp::CellArray::index_type matioCpp::CellArray::numberOfElements ( ) const

Get the total number of elements in the array.

Returns: The total number of elements

Definition at line 230 of file CellArray.cpp.

◆ operator()() [1/4]

matioCpp::Variable matioCpp::CellArray::operator() ( const std::vector< index_type > & el )

Access specified element.

Parameters

el	The element to be accessed.

Warning: Each element of el has to be strictly smaller than the corresponding dimension.

Returns: A Variable with a weak ownership to the underlying mat variable. This means that the data can be changed, but the variable cannot be resized and the name cannot change.

Definition at line 283 of file CellArray.cpp.

◆ operator()() [2/4]

const matioCpp::Variable matioCpp::CellArray::operator() ( const std::vector< index_type > & el ) const

Access specified element.

Parameters

el	The element to be accessed.

Warning: Each element of el has to be strictly smaller than the corresponding dimension.

Returns: A const Variable with a weak ownership to the underlying mat variable.

Definition at line 288 of file CellArray.cpp.

◆ operator()() [3/4]

matioCpp::Variable matioCpp::CellArray::operator() ( index_type el )

Access specified element.

Parameters

el	The element to be accessed (raw index).

Returns: A Variable with a weak ownership to the underlying mat variable. This means that the data can be changed, but the variable cannot be resized and the name cannot change.

Definition at line 293 of file CellArray.cpp.

◆ operator()() [4/4]

const matioCpp::Variable matioCpp::CellArray::operator() ( index_type el ) const

Access specified element.

Parameters

el	The element to be accessed (raw index).

Returns: A const Variable with a weak ownership to the underlying mat variable.

Definition at line 299 of file CellArray.cpp.

◆ operator=() [1/2]

matioCpp::CellArray & matioCpp::CellArray::operator= ( matioCpp::CellArray && other )

Assignement operator (move) from another CellArray.

Parameters

other The other CellArray.

Note: Also the name is copied

Returns: A reference to this CellArray.

Definition at line 127 of file CellArray.cpp.

◆ operator=() [2/2]

matioCpp::CellArray & matioCpp::CellArray::operator= ( const CellArray & other )

Assignement operator (copy) from another CellArray.

Parameters

other The other CellArray.

Note: Also the name is copied

Returns: A reference to this CellArray.

Definition at line 121 of file CellArray.cpp.

◆ operator[]() [1/4]

matioCpp::Variable matioCpp::CellArray::operator[] ( const std::vector< index_type > & el )

Access specified element.

Parameters

el	The element to be accessed.

Warning: Each element of el has to be strictly smaller than the corresponding dimension.

Returns: A Variable with a weak ownership to the underlying mat variable. This means that the data can be changed, but the variable cannot be resized and the name cannot change.

Definition at line 305 of file CellArray.cpp.

◆ operator[]() [2/4]

const matioCpp::Variable matioCpp::CellArray::operator[] ( const std::vector< index_type > & el ) const

Access specified element.

Parameters

el	The element to be accessed.

Warning: Each element of el has to be strictly smaller than the corresponding dimension.

Returns: A const Variable with a weak ownership to the underlying mat variable.

Definition at line 310 of file CellArray.cpp.

◆ operator[]() [3/4]

matioCpp::Variable matioCpp::CellArray::operator[] ( index_type el )

Access specified element.

Parameters

el	The element to be accessed.

Returns: A Variable with a weak ownership to the underlying mat variable. This means that the data can be changed, but the variable cannot be resized and the name cannot change.

Definition at line 315 of file CellArray.cpp.

◆ operator[]() [4/4]

const matioCpp::Variable matioCpp::CellArray::operator[] ( index_type el ) const

Access specified element.

Parameters

el	The element to be accessed.

Returns: A const Variable with a weak ownership to the underlying mat variable.

Definition at line 321 of file CellArray.cpp.

◆ rawIndexFromIndices()

matioCpp::CellArray::index_type matioCpp::CellArray::rawIndexFromIndices ( const std::vector< index_type > & el ) const

Get the linear index corresponding to the provided indices.

Parameters

el	The desired element

Warning: It checks if the element is in the bounds only in debug mode.

Since the variables are stored internally in column-major, an element (i,j,k,l,..) of an array of dimensions (n,m,p,k,...) corresponds to a row index equal to i + j*n + k*n*m + l*n*m*p +...

Returns: the linear index corresponding to the provided indices

Definition at line 163 of file CellArray.cpp.

◆ resize()

void matioCpp::CellArray::resize ( const std::vector< index_type > & newDimensions )

Resize the cell array.

Parameters

newDimensions The new dimensions.

Warning: Previous data is lost.

Definition at line 219 of file CellArray.cpp.

References std::move().

◆ setElement() [1/2]

bool matioCpp::CellArray::setElement	(	const std::vector< index_type > &	el,
		const Variable &	newValue
	)

Set the element at the specified position.

Parameters

el	The indices of the specified element
newValue	The Variable that will be copied in the specified location

Returns: True if successful, false otherwise (for example if the newValue is not valid)

Note: An assertion is thrown if el is out of bounds, but only in debug mode

Definition at line 235 of file CellArray.cpp.

References std::endl(), and matioCpp::Variable::isValid().

◆ setElement() [2/2]

bool matioCpp::CellArray::setElement	(	index_type	el,
		const Variable &	newValue
	)

Set the element at the specified position.

Parameters

el	The raw index of the specified element
newValue	The Variable that will be copied in the specified location

Returns: True if successful, false otherwise (for example if the newValue is not valid)

Note: An assertion is thrown if el is out of bounds, but only in debug mode

Definition at line 258 of file CellArray.cpp.

References std::endl(), and matioCpp::Variable::isValid().

◆ setName()

bool matioCpp::CellArray::setName ( const std::string & newName )

Change the name of the Variable.

Parameters

newName The new name

Returns: True if successful.

Definition at line 214 of file CellArray.cpp.

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

include/matioCpp/CellArray.h
src/CellArray.cpp

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ index_type

Constructor & Destructor Documentation

◆ CellArray() [1/7]

◆ CellArray() [2/7]

◆ CellArray() [3/7]

◆ CellArray() [4/7]

◆ CellArray() [5/7]

◆ CellArray() [6/7]

◆ CellArray() [7/7]

◆ ~CellArray()

Member Function Documentation

◆ clear()

◆ fromVectorOfVariables()

◆ indicesFromRawIndex()

◆ numberOfElements()

◆ operator()() [1/4]

◆ operator()() [2/4]

◆ operator()() [3/4]

◆ operator()() [4/4]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]() [1/4]

◆ operator[]() [2/4]

◆ operator[]() [3/4]

◆ operator[]() [4/4]

◆ rawIndexFromIndices()

◆ resize()

◆ setElement() [1/2]

◆ setElement() [2/2]

◆ setName()