Detailed Description

This class implements the tables of databases.

See also: CSimpleDatabase

Definition at line 29 of file CSimpleDatabase.h.

#include <mrpt/utils/CSimpleDatabase.h>

Inheritance diagram for mrpt::utils::CSimpleDatabaseTable:

Public Member Functions
void *	operator new (size_t size)

void *	operator new[] (size_t size)

void	operator delete (void *ptr) throw ()

void	operator delete[] (void *ptr) throw ()

void	operator delete (void memory, void ptr) throw ()

void *	operator new (size_t size, const std::nothrow_t &) throw ()

void	operator delete (void *ptr, const std::nothrow_t &) throw ()

	CSimpleDatabaseTable ()
	Default constructor. More...

virtual	~CSimpleDatabaseTable ()
	Destructor. More...

size_t	fieldsCount () const
	Get the count of fields. More...

size_t	appendRecord ()
	Append a new and empty record at the end of the table, and return the index of the newly added record. More...

void	addField (const char *fieldName)
	Add a new field to the table. More...

void	addField (const std::string &fieldName)
	Add a new field to the table. More...

std::string	getFieldName (size_t fieldIndex) const
	Get the name of a field by its index. More...

size_t	fieldIndex (const char *fieldName) const
	Get the index for a given field name. More...

size_t	fieldIndex (const std::string &fieldName) const
	Get the index for a given field name. More...

size_t	getRecordCount () const
	Get the records count in the table. More...

std::string	get (size_t recordIndex, std::string field) const
	Returns the cell content of the record indicates by its index, and the field indicated in "field". More...

std::string	get (size_t recordIndex, size_t fieldIndex) const
	Returns the cell content of the record indicates by its index, and the field indicated by its index. More...

void	set (size_t recordIndex, std::string field, std::string value)
	Sets the cell content of the record indicates by its index, and the field indicated in "field". More...

void	set (size_t recordIndex, size_t fieldIndex, std::string value)
	Sets the cell content of the record indicates by its index, and the field indicated by its index. More...

int	query (std::string field, std::string value) const
	Executes a query in the table, returning the record index which a given field has a given value, case insensitive, or -1 if not found. More...

void	deleteRecord (size_t recordIndex)
	Delete the record at the given index. More...

virtual mxArray *	writeToMatlab () const
	Introduces a pure virtual method responsible for writing to a `mxArray` Matlab object, typically a MATLAB `struct` whose contents are documented in each derived class. More...

mrpt::utils::CObjectPtr	duplicateGetSmartPtr () const
	Returns a copy of the object, indepently of its class, as a smart pointer (the newly created object will exist as long as any copy of this smart pointer). More...

CObject *	clone () const
	Cloning interface for smart pointers. More...

Static Public Member Functions
static void *	operator new (size_t size, void *ptr)

Static Public Attributes
static const mrpt::utils::TRuntimeClassId	classCObject

RTTI stuff
static const mrpt::utils::TRuntimeClassId	classCSerializable

Protected Member Functions
CSerializable virtual methods
void	writeToStream (mrpt::utils::CStream &out, int *getVersion) const
	Introduces a pure virtual method responsible for writing to a CStream. More...

void	readFromStream (mrpt::utils::CStream &in, int version)
	Introduces a pure virtual method responsible for loading from a CStream This can not be used directly be users, instead use "stream >> object;" for reading it from a stream or "stream >> object_ptr;" if the class is unknown apriori. More...

Private Attributes
vector_string	field_names
	Field names. More...

std::vector< vector_string >	data
	Data for each cell. More...

RTTI stuff
typedef CSimpleDatabaseTablePtr	Ptr

typedef CSimpleDatabaseTablePtr	ConstPtr

static mrpt::utils::CLASSINIT	_init_CSimpleDatabaseTable

static mrpt::utils::TRuntimeClassId	classCSimpleDatabaseTable

static const mrpt::utils::TRuntimeClassId *	classinfo

static const mrpt::utils::TRuntimeClassId *	_GetBaseClass ()

virtual const mrpt::utils::TRuntimeClassId *	GetRuntimeClass () const
	Returns information about the class of an object in runtime. More...

virtual mrpt::utils::CObject *	duplicate () const
	Returns a copy of the object, indepently of its class. More...

static mrpt::utils::CObject *	CreateObject ()

static CSimpleDatabaseTablePtr	Create ()

Member Typedef Documentation

◆ ConstPtr

typedef CSimpleDatabaseTablePtr mrpt::utils::CSimpleDatabaseTable::ConstPtr

Definition at line 32 of file CSimpleDatabase.h.

◆ Ptr

typedef CSimpleDatabaseTablePtr mrpt::utils::CSimpleDatabaseTable::Ptr

A typedef for the associated smart pointer

Definition at line 32 of file CSimpleDatabase.h.

Constructor & Destructor Documentation

◆ CSimpleDatabaseTable()

CSimpleDatabaseTable::CSimpleDatabaseTable ( )

Default constructor.

Definition at line 233 of file CSimpleDatabase.cpp.

◆ ~CSimpleDatabaseTable()

CSimpleDatabaseTable::~CSimpleDatabaseTable ( )

virtual

Destructor.

Definition at line 240 of file CSimpleDatabase.cpp.

Member Function Documentation

◆ _GetBaseClass()

static const mrpt::utils::TRuntimeClassId* mrpt::utils::CSimpleDatabaseTable::_GetBaseClass ( )

staticprotected

◆ addField() [1/2]

void CSimpleDatabaseTable::addField ( const char * fieldName )

Add a new field to the table.

The table is cleared in this operation.

Definition at line 255 of file CSimpleDatabase.cpp.

◆ addField() [2/2]

void mrpt::utils::CSimpleDatabaseTable::addField ( const std::string & fieldName )

inline

Add a new field to the table.

The table is cleared in this operation.

Definition at line 55 of file CSimpleDatabase.h.

◆ appendRecord()

size_t CSimpleDatabaseTable::appendRecord ( )

Append a new and empty record at the end of the table, and return the index of the newly added record.

See also: deleteRecord

Definition at line 391 of file CSimpleDatabase.cpp.

◆ clone()

CObject* mrpt::utils::CObject::clone ( ) const

inlineinherited

Cloning interface for smart pointers.

Definition at line 143 of file CObject.h.

◆ Create()

static CSimpleDatabaseTablePtr mrpt::utils::CSimpleDatabaseTable::Create ( )

static

Referenced by mrpt::utils::CSimpleDatabase::createTable(), and mrpt::utils::CSimpleDatabase::readFromStream().

◆ CreateObject()

static mrpt::utils::CObject* mrpt::utils::CSimpleDatabaseTable::CreateObject ( )

static

◆ deleteRecord()

void CSimpleDatabaseTable::deleteRecord ( size_t recordIndex )

Delete the record at the given index.

See also: appendRecord

Definition at line 404 of file CSimpleDatabase.cpp.

References ASSERT_, MRPT_END, and MRPT_START.

◆ duplicate()

virtual mrpt::utils::CObject* mrpt::utils::CSimpleDatabaseTable::duplicate ( ) const

virtual

Returns a copy of the object, indepently of its class.

Implements mrpt::utils::CObject.

◆ duplicateGetSmartPtr()

mrpt::utils::CObjectPtr mrpt::utils::CObject::duplicateGetSmartPtr ( ) const

inlineinherited

Returns a copy of the object, indepently of its class, as a smart pointer (the newly created object will exist as long as any copy of this smart pointer).

Definition at line 140 of file CObject.h.

Referenced by mrpt::obs::CRawlog::addActions(), mrpt::slam::CIncrementalMapPartitioner::addMapFrame(), and mrpt::obs::CRawlog::addObservations().

◆ fieldIndex() [1/2]

size_t CSimpleDatabaseTable::fieldIndex ( const char * fieldName ) const

Get the index for a given field name.

Exceptions

std::exception On field not found

Definition at line 277 of file CSimpleDatabase.cpp.

References mrpt::system::os::_strcmpi(), MRPT_END, MRPT_START, and THROW_EXCEPTION_FMT.

◆ fieldIndex() [2/2]

size_t mrpt::utils::CSimpleDatabaseTable::fieldIndex ( const std::string & fieldName ) const

inline

Get the index for a given field name.

Exceptions

std::exception On field not found

Definition at line 72 of file CSimpleDatabase.h.

◆ fieldsCount()

size_t CSimpleDatabaseTable::fieldsCount ( ) const

Get the count of fields.

Definition at line 247 of file CSimpleDatabase.cpp.

◆ get() [1/2]

string CSimpleDatabaseTable::get	(	size_t	recordIndex,
		std::string	field
	)		const

Returns the cell content of the record indicates by its index, and the field indicated in "field".

Exceptions

std::exception On field or record not found

Definition at line 303 of file CSimpleDatabase.cpp.

References ASSERT_, MRPT_END, and MRPT_START.

◆ get() [2/2]

string CSimpleDatabaseTable::get	(	size_t	recordIndex,
		size_t	fieldIndex
	)		const

Returns the cell content of the record indicates by its index, and the field indicated by its index.

Exceptions

std::exception On field or record not found

Definition at line 316 of file CSimpleDatabase.cpp.

References ASSERT_, MRPT_END, and MRPT_START.

◆ getFieldName()

string CSimpleDatabaseTable::getFieldName ( size_t fieldIndex ) const

Get the name of a field by its index.

Exceptions

std::exception On index out of bounds

Definition at line 264 of file CSimpleDatabase.cpp.

References ASSERT_, MRPT_END, and MRPT_START.

◆ getRecordCount()

size_t CSimpleDatabaseTable::getRecordCount ( ) const

Get the records count in the table.

Definition at line 295 of file CSimpleDatabase.cpp.

◆ GetRuntimeClass()

virtual const mrpt::utils::TRuntimeClassId* mrpt::utils::CSimpleDatabaseTable::GetRuntimeClass ( ) const

virtual

Returns information about the class of an object in runtime.

Reimplemented from mrpt::utils::CSerializable.

◆ operator delete() [1/3]

void mrpt::utils::CSimpleDatabaseTable::operator delete	(	void *	memory,
		void *	ptr
	)
throw	(
	)

inline

Definition at line 32 of file CSimpleDatabase.h.

◆ operator delete() [2/3]

void mrpt::utils::CSimpleDatabaseTable::operator delete	(	void *	ptr	)
throw	(
	)

inline

Definition at line 32 of file CSimpleDatabase.h.

◆ operator delete() [3/3]

void mrpt::utils::CSimpleDatabaseTable::operator delete	(	void *	ptr,
		const std::nothrow_t &
	)
throw	(
	)

inline

Definition at line 32 of file CSimpleDatabase.h.

◆ operator delete[]()

void mrpt::utils::CSimpleDatabaseTable::operator delete[]	(	void *	ptr	)
throw	(
	)

inline

Definition at line 32 of file CSimpleDatabase.h.

◆ operator new() [1/3]

void* mrpt::utils::CSimpleDatabaseTable::operator new ( size_t size )

inline

Definition at line 32 of file CSimpleDatabase.h.

◆ operator new() [2/3]

static void* mrpt::utils::CSimpleDatabaseTable::operator new	(	size_t	size,
		void *	ptr
	)

inlinestatic

Definition at line 32 of file CSimpleDatabase.h.

◆ operator new() [3/3]

void* mrpt::utils::CSimpleDatabaseTable::operator new	(	size_t	size,
		const std::nothrow_t &
	)
throw	(
	)

inline

Definition at line 32 of file CSimpleDatabase.h.

◆ operator new[]()

void* mrpt::utils::CSimpleDatabaseTable::operator new[] ( size_t size )

inline

Definition at line 32 of file CSimpleDatabase.h.

◆ query()

int CSimpleDatabaseTable::query	(	std::string	field,
		std::string	value
	)		const

Executes a query in the table, returning the record index which a given field has a given value, case insensitive, or -1 if not found.

Definition at line 363 of file CSimpleDatabase.cpp.

References mrpt::system::os::_strcmpi().

◆ readFromStream()

void CSimpleDatabaseTable::readFromStream	(	mrpt::utils::CStream &	in,
		int	version
	)

protectedvirtual

Introduces a pure virtual method responsible for loading from a CStream This can not be used directly be users, instead use "stream >> object;" for reading it from a stream or "stream >> object_ptr;" if the class is unknown apriori.

Parameters

in	The input binary stream where the object data must read from.
version	The version of the object stored in the stream: use this version number in your code to know how to read the incoming data.

Exceptions

std::exception On any error, see CStream::ReadBuffer

See also: CStream

Implements mrpt::utils::CSerializable.

Definition at line 109 of file CSimpleDatabase.cpp.

References MRPT_THROW_UNKNOWN_SERIALIZATION_VERSION, and version.

◆ set() [1/2]

void CSimpleDatabaseTable::set	(	size_t	recordIndex,
		std::string	field,
		std::string	value
	)

Sets the cell content of the record indicates by its index, and the field indicated in "field".

Exceptions

std::exception On field or record not found

Definition at line 330 of file CSimpleDatabase.cpp.

References ASSERT_, MRPT_END, and MRPT_START.

◆ set() [2/2]

void CSimpleDatabaseTable::set	(	size_t	recordIndex,
		size_t	fieldIndex,
		std::string	value
	)

Sets the cell content of the record indicates by its index, and the field indicated by its index.

Exceptions

std::exception On field or record not found

Definition at line 346 of file CSimpleDatabase.cpp.

References ASSERT_, MRPT_END, and MRPT_START.

◆ writeToMatlab()

virtual mxArray* mrpt::utils::CSerializable::writeToMatlab ( ) const

inlinevirtualinherited

Introduces a pure virtual method responsible for writing to a mxArray Matlab object, typically a MATLAB struct whose contents are documented in each derived class.

Returns: A new mxArray (caller is responsible of memory freeing) or NULL is class does not support conversion to MATLAB.

Definition at line 79 of file CSerializable.h.

◆ writeToStream()

void CSimpleDatabaseTable::writeToStream	(	mrpt::utils::CStream &	out,
		int *	getVersion
	)		const

protectedvirtual

Introduces a pure virtual method responsible for writing to a CStream.

This can not be used directly be users, instead use "stream << object;" for writing it to a stream.

Parameters

out	The output binary stream where object must be dumped.
getVersion	If NULL, the object must be dumped. If not, only the version of the object dump must be returned in this pointer. This enables the versioning of objects dumping and backward compatibility with previously stored data.

Exceptions

std::exception On any error, see CStream::WriteBuffer

See also: CStream

Implements mrpt::utils::CSerializable.

Definition at line 88 of file CSimpleDatabase.cpp.

Member Data Documentation

◆ _init_CSimpleDatabaseTable

mrpt::utils::CLASSINIT mrpt::utils::CSimpleDatabaseTable::_init_CSimpleDatabaseTable

staticprotected

Definition at line 32 of file CSimpleDatabase.h.

◆ classCObject

const mrpt::utils::TRuntimeClassId mrpt::utils::CObject::classCObject

staticinherited

Definition at line 128 of file CObject.h.

◆ classCSerializable

const mrpt::utils::TRuntimeClassId mrpt::utils::CSerializable::classCSerializable

staticinherited

Definition at line 42 of file CSerializable.h.

◆ classCSimpleDatabaseTable

mrpt::utils::TRuntimeClassId mrpt::utils::CSimpleDatabaseTable::classCSimpleDatabaseTable

static

Definition at line 32 of file CSimpleDatabase.h.

◆ classinfo

const mrpt::utils::TRuntimeClassId* mrpt::utils::CSimpleDatabaseTable::classinfo

static

Definition at line 32 of file CSimpleDatabase.h.

◆ data

std::vector<vector_string> mrpt::utils::CSimpleDatabaseTable::data

private

Data for each cell.

Definition at line 109 of file CSimpleDatabase.h.

◆ field_names

vector_string mrpt::utils::CSimpleDatabaseTable::field_names

private

Field names.

Definition at line 108 of file CSimpleDatabase.h.

Detailed Description

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Private Attributes

RTTI stuff

Member Typedef Documentation

◆ ConstPtr

◆ Ptr

Constructor & Destructor Documentation

◆ CSimpleDatabaseTable()

◆ ~CSimpleDatabaseTable()

Member Function Documentation

◆ _GetBaseClass()

◆ addField() [1/2]

◆ addField() [2/2]

◆ appendRecord()

◆ clone()

◆ Create()

◆ CreateObject()

◆ deleteRecord()

◆ duplicate()

◆ duplicateGetSmartPtr()

◆ fieldIndex() [1/2]

◆ fieldIndex() [2/2]

◆ fieldsCount()

◆ get() [1/2]

◆ get() [2/2]

◆ getFieldName()

◆ getRecordCount()

◆ GetRuntimeClass()

◆ operator delete() [1/3]

◆ operator delete() [2/3]

◆ operator delete() [3/3]

◆ operator delete[]()

◆ operator new() [1/3]

◆ operator new() [2/3]

◆ operator new() [3/3]

◆ operator new[]()

◆ query()

◆ readFromStream()

◆ set() [1/2]

◆ set() [2/2]

◆ writeToMatlab()

◆ writeToStream()

Member Data Documentation

◆ _init_CSimpleDatabaseTable

◆ classCObject

◆ classCSerializable

◆ classCSimpleDatabaseTable

◆ classinfo

◆ data

◆ field_names