Implementation of a dataset for the PostGIS driver. More...

#include <DataSet.h>

Inheritance diagram for te::pgis::DataSet:

Public Member Functions
	DataSet (PGresult *result, const std::vector< int > &ptypes, bool timeIsInteger=true)
	Constructor. More...

te::common::AccessPolicy	getAccessPolicy () const
	It returns the read and write permission associated to the dataset. More...

std::unique_ptr< te::dt::Array >	getArray (std::size_t i) const
	Method for retrieving an array. More...

bool	getBool (std::size_t i) const
	Method for retrieving a boolean attribute value. More...

std::unique_ptr< te::dt::ByteArray >	getByteArray (std::size_t i) const
	Method for retrieving a byte array. More...

char	getChar (std::size_t i) const
	Method for retrieving a signed character attribute value (1 byte long). More...

std::string	getDatasetNameOfProperty (std::size_t i) const
	It returns the underlying dataset name of the property at position pos. More...

std::unique_ptr< te::dt::DateTime >	getDateTime (std::size_t i) const
	Method for retrieving a date and time attribute value. More...

double	getDouble (std::size_t i) const
	Method for retrieving a double attribute value. More...

std::unique_ptr< te::gm::Envelope >	getExtent (std::size_t i)
	It computes the bounding rectangle for a spatial property of the dataset. More...

float	getFloat (std::size_t i) const
	Method for retrieving a float attribute value. More...

std::unique_ptr< te::gm::Geometry >	getGeometry (std::size_t i) const
	Method for retrieving a geometric attribute value. More...

boost::int16_t	getInt16 (std::size_t i) const
	Method for retrieving a 16-bit integer attribute value (2 bytes long). More...

boost::int32_t	getInt32 (std::size_t i) const
	Method for retrieving a 32-bit integer attribute value (4 bytes long). More...

boost::int64_t	getInt64 (std::size_t i) const
	Method for retrieving a 64-bit integer attribute value (8 bytes long). More...

std::string	getNumeric (std::size_t i) const
	Method for retrieving a numeric attribute value. More...

std::size_t	getNumProperties () const
	It returns the number of properties that composes an item of the dataset. More...

int	getPropertyDataType (std::size_t i) const
	It returns the underlying data type of the property at position pos. More...

std::string	getPropertyName (std::size_t i) const
	It returns the property name at position pos. More...

std::unique_ptr< te::rst::Raster >	getRaster (std::size_t i) const
	Method for retrieving a raster attribute value. More...

std::string	getString (std::size_t i) const
	Method for retrieving a string value attribute. More...

te::common::TraverseType	getTraverseType () const
	It returns the traverse type associated to the dataset. More...

unsigned char	getUChar (std::size_t i) const
	Method for retrieving an unsigned character attribute value (1 byte long). More...

bool	isAfterEnd () const
	It tells if the dataset internal pointer is on the sentinel position after the last element of the collection or not. More...

bool	isAtBegin () const
	It tells if the dataset internal pointer is on the first element of the collection or not. More...

bool	isAtEnd () const
	It tells if the dataset internal pointer is on the last element of the collection. More...

bool	isBeforeBegin () const
	It tells if the dataset internal pointer is in a position before the first element of the collection or not. More...

bool	isConnected () const
	It returns true if the dataset is connected and false if it is disconnected. A dataset can be connected or disconnected. A connected dataset, after its creation through the data source transactor, continues to depend on the connection given by its associated data source. Differently, a disconnected dataset, after its creation, no more depends of the connection given by the data source, and it continues to live after the connection has been released to the data source. More...

bool	isEmpty () const
	It returns true if the collection is empty. More...

bool	isNull (std::size_t i) const
	It checks if the attribute value is NULL. More...

bool	isPositionValid () const
	It tells if the dataset internal pointer is on a valid position. More...

bool	move (std::size_t i)
	It moves the dataset internal pointer to a given position. More...

bool	moveBeforeFirst ()
	It moves the internal pointer to a position before the first item in the collection. More...

bool	moveFirst ()
	It moves the internal pointer to the first item in the collection. More...

bool	moveLast ()
	It sets the dataset internal pointer to the last item in the collection. More...

bool	moveNext ()
	It moves the internal pointer to the next item of the collection. More...

bool	movePrevious ()
	It moves the internal pointer to the previous item of the collection. More...

std::size_t	size () const
	It returns the collection size, if it is known. More...

	~DataSet ()
	The destructor will clear the internal PGresult. More...

PostGIS Extended Methods
Methods that exists only in the PostGIS DataSet implementation.
PGresult *	getPGResult () const
	It returns the internal pg result. More...

DataSet Element Properties
Methods for retrieving/setting the dataset item component values without the need to explicitly instantiate an item via getItem method.
virtual char	getChar (const std::string &name) const
	Method for retrieving a signed character attribute value (1 byte long). More...

virtual unsigned char	getUChar (const std::string &name) const
	Method for retrieving an unsigned character attribute value (1 byte long). More...

virtual boost::int16_t	getInt16 (const std::string &name) const
	Method for retrieving a 16-bit integer attribute value (2 bytes long). More...

virtual boost::int32_t	getInt32 (const std::string &name) const
	Method for retrieving a 32-bit integer attribute value (4 bytes long). More...

virtual boost::int64_t	getInt64 (const std::string &name) const
	Method for retrieving a 64-bit integer attribute value (8 bytes long). More...

virtual bool	getBool (const std::string &name) const
	Method for retrieving a boolean attribute value. More...

virtual float	getFloat (const std::string &name) const
	Method for retrieving a float attribute value. More...

virtual double	getDouble (const std::string &name) const
	Method for retrieving a double attribute value. More...

virtual std::string	getNumeric (const std::string &name) const
	Method for retrieving a numeric attribute value. More...

virtual std::string	getString (const std::string &name) const
	Method for retrieving a string attribute value. More...

virtual std::unique_ptr< te::dt::ByteArray >	getByteArray (const std::string &name) const
	Method for retrieving a byte array. More...

virtual std::unique_ptr< te::gm::Geometry >	getGeometry (const std::string &name) const
	Method for retrieving a geometric attribute value. More...

virtual std::unique_ptr< te::rst::Raster >	getRaster (const std::string &name) const
	Method for retrieving a raster attribute value. More...

virtual std::unique_ptr< te::dt::DateTime >	getDateTime (const std::string &name) const
	Method for retrieving a date and time attribute value. More...

virtual std::unique_ptr< te::dt::Array >	getArray (const std::string &name) const
	Method for retrieving an array. More...

virtual std::unique_ptr< te::dt::AbstractData >	getValue (std::size_t i) const
	Method for retrieving any other type of data value stored in the data source. More...

virtual std::unique_ptr< te::dt::AbstractData >	getValue (const std::string &name) const
	Method for retrieving any other type of data value stored in the data source. More...

virtual std::string	getAsString (std::size_t i, int precision=0) const
	Method for retrieving a data value as a string plain representation. More...

virtual std::string	getAsString (const std::string &name, int precision=0) const
	Method for retrieving a data value as a string plain representation. More...

virtual bool	isNull (const std::string &name) const
	It checks if the attribute value is NULL. More...

Protected Attributes
int	m_i
	The index of the current row. More...

te::gm::Envelope *	m_mbr
	The dataset extent. More...

std::vector< int >	m_ptypes
	The list of property types. More...

PGresult *	m_result
	The internal buffer with the result query. More...

int	m_size
	The number of datasets in the collection. More...

bool	m_timeIsInteger
	It indicates if the postgis stores, internally, the time and timestamp as an integer. More...

Detailed Description

Implementation of a dataset for the PostGIS driver.

See also: te::da::DataSet

Definition at line 61 of file postgis/DataSet.h.

Constructor & Destructor Documentation

te::pgis::DataSet::DataSet	(	PGresult *	result,
		const std::vector< int > &	ptypes,
		bool	timeIsInteger = `true`
	)

Constructor.

Parameters

result	The internal PGresult.
ds	The data source.
timeIsInteger	A flag that indicates if the postgis stores, internally, the time and timestamp as an integer.
ce	The connection character encoding.

Definition at line 130 of file postgis/DataSet.cpp.

References m_result, and m_size.

te::pgis::DataSet::~DataSet ( )

virtual

The destructor will clear the internal PGresult.

Reimplemented from te::da::DataSet.

Definition at line 142 of file postgis/DataSet.cpp.

References m_result.

Member Function Documentation

te::common::AccessPolicy te::pgis::DataSet::getAccessPolicy ( ) const

virtual

It returns the read and write permission associated to the dataset.

Returns: The read and write permission associated to the dataset.

Implements te::da::DataSet.

Definition at line 152 of file postgis/DataSet.cpp.

References te::common::RAccess.

std::unique_ptr< te::dt::Array > te::pgis::DataSet::getArray ( std::size_t i ) const

virtual

Method for retrieving an array.

Parameters

i	The attribute index.

Implements te::da::DataSet.

Definition at line 596 of file postgis/DataSet.cpp.

References d, te::dt::DOUBLE_TYPE, te::dt::INT16_TYPE, m_i, m_result, PG_FLOAT8_TYPE, PG_INT2_TYPE, PG_NAME_TYPE, PG_TEXT_TYPE, PG_VARCHAR_TYPE, te::dt::STRING_TYPE, te::common::SwapBytes(), and TE_TR.

std::unique_ptr< te::dt::Array > te::da::DataSet::getArray ( const std::string & name ) const

virtualinherited

Method for retrieving an array.

Parameters

name	The attribute name.

Returns: An array. The caller will take its ownership.

Reimplemented in te::gdal::DataSet.

Definition at line 145 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getArray(), and te::da::GetPropertyPos().

std::string te::da::DataSet::getAsString	(	std::size_t	i,
		int	precision = `0`
	)		const

virtualinherited

Method for retrieving a data value as a string plain representation.

Parameters

i	The attribute index.
precision	The precision in the conversion.

Returns: The attribute value in a string format.

Note: It is safe to call this method for any data type, the data source implementation will take care of how to convert the internal representation to a string.

Definition at line 219 of file dataaccess/dataset/DataSet.cpp.

Referenced by te::ogr::Transactor::add(), te::gpkg::Transactor::add(), te::sa::AssociateGPMVertexAttribute(), te::sa::KernelMapOperation::buildTree(), te::sa::KernelRatioOperation::buildTree(), te::sa::SkaterOperation::createDataSet(), te::qt::widgets::DataSetTableModel::data(), te::map::QueryLayerRenderer::drawDatSetGeometries(), te::da::DataSet::getAsString(), te::attributefill::VectorToVectorMemory::getDistinctClasses(), te::qt::widgets::DefaultFeatureInfoMaker::getGeometryInfo(), te::edit::EditInfoTool::getInfo(), te::qt::widgets::Promoter::preProcessKeys(), PrintDataSet(), PrintDataSetValues(), te::sa::BayesLocalOperation::runBayesLocal(), ToHighlight(), te::da::TupleToStringConverter(), TupleToStringUpperCaseConverter(), te::ado::Transactor::update(), and te::pgis::Transactor::update().

std::string te::da::DataSet::getAsString	(	const std::string &	name,
		int	precision = `0`
	)		const

virtualinherited

Method for retrieving a data value as a string plain representation.

Parameters

name	The attribute name.
precision	The precision in the conversion.

Returns: The attribute value in a string format.

Exceptions

Exception if property not found.

Note: It is safe to call this method for any data type, the data source implementation will take care of how to convert the internal representation to a string.

Definition at line 307 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getAsString(), te::da::DataSet::getNumProperties(), te::da::GetPropertyPos(), and TE_TR.

bool te::pgis::DataSet::getBool ( std::size_t i ) const

virtual

Method for retrieving a boolean attribute value.

Parameters

i	The attribute index.

Returns: The boolean attribute value in the given position.

Implements te::da::DataSet.

Definition at line 326 of file postgis/DataSet.cpp.

References m_i, and m_result.

bool te::da::DataSet::getBool ( const std::string & name ) const

virtualinherited

Method for retrieving a boolean attribute value.

Parameters

name	The attribute name.

Returns: The boolean attribute value with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 82 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getBool(), and te::da::GetPropertyPos().

std::unique_ptr< te::dt::ByteArray > te::pgis::DataSet::getByteArray ( std::size_t i ) const

virtual

Method for retrieving a byte array.

You can use this method in order to retrieve a BLOB data.

Parameters

i	The attribute index.

Returns: The byte array attribute.

Implements te::da::DataSet.

Definition at line 470 of file postgis/DataSet.cpp.

References b, te::dt::ByteArray::copy(), m_i, m_result, and size().

std::unique_ptr< te::dt::ByteArray > te::da::DataSet::getByteArray ( const std::string & name ) const

virtualinherited

Method for retrieving a byte array.

You can use this method in order to retrieve a BLOB data.

Parameters

name	The attribute name.

Returns: The byte array attribute.

Reimplemented in te::gdal::DataSet.

Definition at line 117 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getByteArray(), and te::da::GetPropertyPos().

char te::pgis::DataSet::getChar ( std::size_t i ) const

virtual

Method for retrieving a signed character attribute value (1 byte long).

Parameters

i	The attribute index.

Returns: The signed character attribute value (1 byte long) in the given position.

Implements te::da::DataSet.

Definition at line 281 of file postgis/DataSet.cpp.

References m_i, and m_result.

char te::da::DataSet::getChar ( const std::string & name ) const

virtualinherited

Method for retrieving a signed character attribute value (1 byte long).

Parameters

name	The attribute name.

Returns: The signed character attribute value (1 byte long) with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 47 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getChar(), and te::da::GetPropertyPos().

std::string te::pgis::DataSet::getDatasetNameOfProperty ( std::size_t i ) const

virtual

It returns the underlying dataset name of the property at position pos.

Parameters

i	The property position of interest.

Returns: The underlying dataset name of the property at position pos.

Implements te::da::DataSet.

Definition at line 172 of file postgis/DataSet.cpp.

References TE_TR.

std::unique_ptr< te::dt::DateTime > te::pgis::DataSet::getDateTime ( std::size_t i ) const

virtual

Method for retrieving a date and time attribute value.

Parameters

i	The attribute index.

Returns: The date and time attribute value in the given position.

Implements te::da::DataSet.

Definition at line 489 of file postgis/DataSet.cpp.

References getDouble(), getInt32(), getInt64(), te::pgis::Internal2Date(), te::pgis::Internal2Time(), te::pgis::Internal2TimeStamp(), te::pgis::Internal2TimeStampTZ(), te::pgis::Internal2TimeTZ(), m_i, m_result, m_timeIsInteger, PG_DATE_TYPE, PG_TIME_TYPE, PG_TIMESTAMP_TYPE, PG_TIMESTAMPTZ_TYPE, PG_TIMETZ_TYPE, te::common::SwapBytes(), and TE_TR.

std::unique_ptr< te::dt::DateTime > te::da::DataSet::getDateTime ( const std::string & name ) const

virtualinherited

Method for retrieving a date and time attribute value.

Parameters

name	The attribute name.

Returns: The date and time attribute value with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 138 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getDateTime(), and te::da::GetPropertyPos().

double te::pgis::DataSet::getDouble ( std::size_t i ) const

virtual

Method for retrieving a double attribute value.

Parameters

i	The attribute index.

Returns: The double attribute value in the given position.

Implements te::da::DataSet.

Definition at line 343 of file postgis/DataSet.cpp.

References m_i, m_result, and te::common::SwapBytes().

Referenced by getDateTime().

double te::da::DataSet::getDouble ( const std::string & name ) const

virtualinherited

Method for retrieving a double attribute value.

Parameters

name	The attribute name.

Returns: The double attribute value with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 96 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getDouble(), and te::da::GetPropertyPos().

std::unique_ptr< te::gm::Envelope > te::pgis::DataSet::getExtent ( std::size_t i )

virtual

It computes the bounding rectangle for a spatial property of the dataset.

Parameters

i	The position of a spatial property to get its bounding box.

Precondition: The position i must be associated to a spatial property of the dataset.

Exceptions

Exception It throws an exception if something goes wrong during MBR search.

Returns: The spatial property bounding rectangle, or an invalid box, if none is found.

Implements te::da::DataSet.

Definition at line 192 of file postgis/DataSet.cpp.

References te::dt::GEOMETRY_TYPE, getGeometry(), m_i, m_mbr, m_ptypes, moveNext(), TE_TR, and te::gm::Envelope::Union().

float te::pgis::DataSet::getFloat ( std::size_t i ) const

virtual

Method for retrieving a float attribute value.

Parameters

i	The attribute index.

Returns: The float attribute value in the given position.

Implements te::da::DataSet.

Definition at line 332 of file postgis/DataSet.cpp.

References m_i, m_result, and te::common::SwapBytes().

float te::da::DataSet::getFloat ( const std::string & name ) const

virtualinherited

Method for retrieving a float attribute value.

Parameters

name	The attribute name.

Returns: The float attribute value with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 89 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getFloat(), and te::da::GetPropertyPos().

std::unique_ptr< te::gm::Geometry > te::pgis::DataSet::getGeometry ( std::size_t i ) const

virtual

Method for retrieving a geometric attribute value.

Parameters

i	The attribute index.

Returns: The geometric attribute value in the given position.

Implements te::da::DataSet.

Definition at line 479 of file postgis/DataSet.cpp.

References m_i, m_result, and te::pgis::EWKBReader::read().

Referenced by getExtent().

std::unique_ptr< te::gm::Geometry > te::da::DataSet::getGeometry ( const std::string & name ) const

virtualinherited

Method for retrieving a geometric attribute value.

Parameters

name	The attribute name.

Returns: The geometric attribute value with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 124 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getGeometry(), and te::da::GetPropertyPos().

boost::int16_t te::pgis::DataSet::getInt16 ( std::size_t i ) const

virtual

Method for retrieving a 16-bit integer attribute value (2 bytes long).

Parameters

i	The attribute index.

Returns: The 16-bit integer attribute value (2 bytes long) in the given position.

Implements te::da::DataSet.

Definition at line 293 of file postgis/DataSet.cpp.

References m_i, m_result, and te::common::SwapBytes().

boost::int16_t te::da::DataSet::getInt16 ( const std::string & name ) const

virtualinherited

Method for retrieving a 16-bit integer attribute value (2 bytes long).

Parameters

name	The attribute name.

Returns: The 16-bit integer attribute value (2 bytes long) with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 61 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getInt16(), and te::da::GetPropertyPos().

boost::int32_t te::pgis::DataSet::getInt32 ( std::size_t i ) const

virtual

Method for retrieving a 32-bit integer attribute value (4 bytes long).

Parameters

i	The attribute index.

Returns: The 32-bit integer attribute value in the given position.

Implements te::da::DataSet.

Definition at line 304 of file postgis/DataSet.cpp.

References m_i, m_result, and te::common::SwapBytes().

Referenced by getDateTime().

boost::int32_t te::da::DataSet::getInt32 ( const std::string & name ) const

virtualinherited

Method for retrieving a 32-bit integer attribute value (4 bytes long).

Parameters

name	The attribute name.

Returns: The 32-bit integer attribute value with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 68 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getInt32(), and te::da::GetPropertyPos().

boost::int64_t te::pgis::DataSet::getInt64 ( std::size_t i ) const

virtual

Method for retrieving a 64-bit integer attribute value (8 bytes long).

Parameters

i	The attribute index.

Returns: The 64-bit integer attribute value in the given position.

Implements te::da::DataSet.

Definition at line 315 of file postgis/DataSet.cpp.

References m_i, m_result, and te::common::SwapBytes().

Referenced by getDateTime().

boost::int64_t te::da::DataSet::getInt64 ( const std::string & name ) const

virtualinherited

Method for retrieving a 64-bit integer attribute value (8 bytes long).

Parameters

name	The attribute name.

Returns: The 64-bit integer attribute value with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 75 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getInt64(), and te::da::GetPropertyPos().

std::string te::pgis::DataSet::getNumeric ( std::size_t i ) const

virtual

Method for retrieving a numeric attribute value.

Parameters

i	The attribute index.

Returns: The numeric attribute value in the given position.

Implements te::da::DataSet.

Definition at line 354 of file postgis/DataSet.cpp.

References te::common::Convert2String(), m_i, m_result, and te::common::SwapBytes().

std::string te::da::DataSet::getNumeric ( const std::string & name ) const

virtualinherited

Method for retrieving a numeric attribute value.

Parameters

name	The attribute name.

Returns: The numeric attribute value with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 103 of file dataaccess/dataset/DataSet.cpp.

References te::da::DataSet::getNumeric(), and te::da::GetPropertyPos().

std::size_t te::pgis::DataSet::getNumProperties ( ) const

virtual

It returns the number of properties that composes an item of the dataset.

Returns: The number of properties that composes an item of the dataset.

Implements te::da::DataSet.

Definition at line 157 of file postgis/DataSet.cpp.

References m_result.

PGresult* te::pgis::DataSet::getPGResult ( ) const

inline

It returns the internal pg result.

Returns: The internal pg result.

Definition at line 164 of file postgis/DataSet.h.

int te::pgis::DataSet::getPropertyDataType ( std::size_t i ) const

virtual

It returns the underlying data type of the property at position pos.

Parameters

i	The property position of interest.

Returns: The underlying data type of the property at position pos.

Implements te::da::DataSet.

Definition at line 162 of file postgis/DataSet.cpp.

References m_ptypes.

std::string te::pgis::DataSet::getPropertyName ( std::size_t i ) const

virtual

It returns the property name at position pos.

Parameters

i	The property name at the position of interest.

Returns: The property name at position pos.

Implements te::da::DataSet.

Definition at line 167 of file postgis/DataSet.cpp.

References m_result.

std::unique_ptr< te::rst::Raster > te::pgis::DataSet::getRaster ( std::size_t i ) const

virtual

Method for retrieving a raster attribute value.

Parameters

i	The attribute index.

Returns: The raster attribute value in the given position.

Exceptions

Exception

It can throw an exception if:

something goes wrong during the data retrieval
the maximum number of simultaneous accesses has been reached

Implements te::da::DataSet.

Definition at line 484 of file postgis/DataSet.cpp.

std::unique_ptr< te::rst::Raster > te::da::DataSet::getRaster ( const std::string & name ) const

virtualinherited

Method for retrieving a raster attribute value.

Parameters

name	The attribute name.

Returns: The raster attribute value with the given name.

Exceptions

Exception

It can throw an exception if:

something goes wrong during the data retrieval
the maximum number of simultaneous accesses has been reached

Reimplemented in te::gdal::DataSet.

Definition at line 131 of file dataaccess/dataset/DataSet.cpp.

References te::da::GetPropertyPos(), and te::da::DataSet::getRaster().

std::string te::pgis::DataSet::getString ( std::size_t i ) const

virtual

Method for retrieving a string value attribute.

Parameters

i	The attribute index.

Returns: The string attribute value in the given position.

Implements te::da::DataSet.

Definition at line 464 of file postgis/DataSet.cpp.

References m_i, and m_result.

std::string te::da::DataSet::getString ( const std::string & name ) const

virtualinherited

Method for retrieving a string attribute value.

Parameters

name	The attribute name.

Returns: The string attribute value with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 110 of file dataaccess/dataset/DataSet.cpp.

References te::da::GetPropertyPos(), and te::da::DataSet::getString().

te::common::TraverseType te::pgis::DataSet::getTraverseType ( ) const

virtual

It returns the traverse type associated to the dataset.

Returns: The traverse type associated to the dataset.

Implements te::da::DataSet.

Definition at line 147 of file postgis/DataSet.cpp.

References te::common::RANDOM.

unsigned char te::pgis::DataSet::getUChar ( std::size_t i ) const

virtual

Method for retrieving an unsigned character attribute value (1 byte long).

Parameters

i	The attribute index.

Returns: The unsigned character attribute value (1 byte long) in the given position.

Implements te::da::DataSet.

Definition at line 287 of file postgis/DataSet.cpp.

References m_i, and m_result.

unsigned char te::da::DataSet::getUChar ( const std::string & name ) const

virtualinherited

Method for retrieving an unsigned character attribute value (1 byte long).

Parameters

name	The attribute name.

Returns: The unsigned character attribute value (1 byte long) with the given name.

Reimplemented in te::gdal::DataSet.

Definition at line 54 of file dataaccess/dataset/DataSet.cpp.

References te::da::GetPropertyPos(), and te::da::DataSet::getUChar().

std::unique_ptr< te::dt::AbstractData > te::da::DataSet::getValue ( std::size_t i ) const

virtualinherited

Method for retrieving any other type of data value stored in the data source.

This method can be use for extensible datatypes.

Parameters

i	The attribute index.

Returns: A pointer to the data value.

Reimplemented in te::stmem::DataSet, and te::mem::DataSet.

Definition at line 152 of file dataaccess/dataset/DataSet.cpp.

Referenced by te::sa::AssociateGPMVertexAttribute(), te::sa::KernelRatioOperation::buildTree(), te::sa::KernelMapOperation::buildTree(), te::mem::DataSet::copy(), te::stmem::DataSet::copy(), te::sa::SkaterOperation::createDataSet(), te::sa::BayesGlobalOperation::createDataSet(), te::sa::BayesLocalOperation::createDataSet(), te::sa::KernelOperation::createDataSet(), te::sa::CreateGeostatisticalData(), te::vp::Union::executeMemory(), te::vp::Difference::executeMemory(), te::vp::Intersection::executeMemory(), te::vp::Merge::executeMemory(), te::da::GenerateOID(), te::da::GenericAttributeConverter(), te::attributefill::VectorToVectorMemory::getDataValues(), Editor::getEditedDataSet(), te::vp::GetFilledItemMemory(), te::edit::EditInfoTool::getInfo(), te::vp::GroupThreadManager::getNextGroup(), te::st::TimeSeriesDataSet::getTimeSeries(), te::st::TimeSeriesDataSet::getTimeSeriesSet(), te::da::DataSet::getValue(), te::edit::EditInfoTool::onOkPushButtonPressed(), te::vp::IntersectionMemory::pairwiseIntersection(), te::sa::SetMainDiagonal(), te::vp::IntersectionQuery::updateGeomType(), and te::vp::Intersection::updateGeomType().

std::unique_ptr< te::dt::AbstractData > te::da::DataSet::getValue ( const std::string & name ) const

virtualinherited

Method for retrieving any other type of data value stored in the data source.

This method can be use for extensible datatypes.

Parameters

name	The attribute name.

Returns: A pointer to the data value.

Definition at line 212 of file dataaccess/dataset/DataSet.cpp.

References te::da::GetPropertyPos(), and te::da::DataSet::getValue().

bool te::pgis::DataSet::isAfterEnd ( ) const

virtual

It tells if the dataset internal pointer is on the sentinel position after the last element of the collection or not.

Returns: True, if the dataset internal pointer is on the sentinel position after the last element otherwise it returns false.

Implements te::da::DataSet.

Definition at line 271 of file postgis/DataSet.cpp.

References m_i, and m_size.

bool te::pgis::DataSet::isAtBegin ( ) const

virtual

It tells if the dataset internal pointer is on the first element of the collection or not.

Returns: True if the dataset internal pointer is on the first element otherwise it returns false.

Implements te::da::DataSet.

Definition at line 256 of file postgis/DataSet.cpp.

References m_i.

bool te::pgis::DataSet::isAtEnd ( ) const

virtual

It tells if the dataset internal pointer is on the last element of the collection.

Returns: True, if the dataset internal pointer is on the last element otherwise it returns false.

Implements te::da::DataSet.

Definition at line 266 of file postgis/DataSet.cpp.

References m_i, and m_size.

bool te::pgis::DataSet::isBeforeBegin ( ) const

virtual

It tells if the dataset internal pointer is in a position before the first element of the collection or not.

Returns: True, if the dataset internal pointer is in a position before the first element otherwise it returns false.

Implements te::da::DataSet.

Definition at line 261 of file postgis/DataSet.cpp.

References m_i.

bool te::pgis::DataSet::isConnected ( ) const

virtual

It returns true if the dataset is connected and false if it is disconnected. A dataset can be connected or disconnected. A connected dataset, after its creation through the data source transactor, continues to depend on the connection given by its associated data source. Differently, a disconnected dataset, after its creation, no more depends of the connection given by the data source, and it continues to live after the connection has been released to the data source.

Returns: True, if the dataset is connected, or false if it is disconnected.

Implements te::da::DataSet.

Definition at line 182 of file postgis/DataSet.cpp.

bool te::pgis::DataSet::isEmpty ( ) const

virtual

It returns true if the collection is empty.

Returns: True, if the collection is empty.

Implements te::da::DataSet.

Definition at line 177 of file postgis/DataSet.cpp.

References m_size.

bool te::pgis::DataSet::isNull ( std::size_t i ) const

virtual

It checks if the attribute value is NULL.

Parameters

i	The attribute index.

Returns: True if the attribute value is NULL.

Implements te::da::DataSet.

Definition at line 833 of file postgis/DataSet.cpp.

References m_i, and m_result.

bool te::da::DataSet::isNull ( const std::string & name ) const

virtualinherited

It checks if the attribute value is NULL.

Parameters

name	The attribute name.

Returns: True if the attribute value is NULL.

Reimplemented in te::gdal::DataSet.

Definition at line 319 of file dataaccess/dataset/DataSet.cpp.

References te::da::GetPropertyPos(), and te::da::DataSet::isNull().

bool te::pgis::DataSet::isPositionValid ( ) const

virtual

It tells if the dataset internal pointer is on a valid position.

Returns: True, if the dataset internal pointer is on a valid position.

Implements te::da::DataSet.

Definition at line 276 of file postgis/DataSet.cpp.

References m_i, and m_size.

Referenced by moveNext(), and movePrevious().

bool te::pgis::DataSet::move ( std::size_t i )

virtual

It moves the dataset internal pointer to a given position.

Parameters

i	The position the dataset internal pointer must be set up.

Returns: True, if it was possible to move the dataset reading to the given position.

Note: The first item in the collection starts at address 0.

Implements te::da::DataSet.

Definition at line 250 of file postgis/DataSet.cpp.

References m_i, and m_size.

bool te::pgis::DataSet::moveBeforeFirst ( )

virtual

It moves the internal pointer to a position before the first item in the collection.

Returns: True, if it was possible to move to a sentinel position before the first item in the collection.

Note: This method is not supported by FORWARDONLY datasets.

Implements te::da::DataSet.

Definition at line 244 of file postgis/DataSet.cpp.

References m_i, and m_size.

bool te::pgis::DataSet::moveFirst ( )

virtual

It moves the internal pointer to the first item in the collection.

Returns: True, if it was possible to move to the first item in the collection.

Note: This method is not supported by FORWARDONLY datasets.

Implements te::da::DataSet.

Definition at line 228 of file postgis/DataSet.cpp.

References m_i, and m_size.

bool te::pgis::DataSet::moveLast ( )

virtual

It sets the dataset internal pointer to the last item in the collection.

Returns: True, if it was possible to move to the last item in the collection.

Implements te::da::DataSet.

Definition at line 234 of file postgis/DataSet.cpp.

References m_i, and m_size.

bool te::pgis::DataSet::moveNext ( )

virtual

It moves the internal pointer to the next item of the collection.

You always has to call this method in order to move the internal pointer to the first item in the collection. This method can be used to traverse a dataset.

Returns: True if the internal pointer is on a valid item, or false otherwise.

Note: All dataset types support this method: FORWARDONLY, BIDIRECTIONAL and RANDOM.

Implements te::da::DataSet.

Definition at line 216 of file postgis/DataSet.cpp.

References isPositionValid(), and m_i.

Referenced by getExtent().

bool te::pgis::DataSet::movePrevious ( )

virtual

It moves the internal pointer to the previous item of the collection.

Returns: True, if the internal pointer (cursor position) is on a valid item, or false otherwise.

Note: This method is not supported by FORWARDONLY datasets.

Implements te::da::DataSet.

Definition at line 222 of file postgis/DataSet.cpp.

References isPositionValid(), and m_i.

std::size_t te::pgis::DataSet::size ( ) const

virtual

It returns the collection size, if it is known.

It may return std::string::npos if the size is not known, or it would be too costly to compute it.

Returns: The size of the collection, if it is known.

Implements te::da::DataSet.

Definition at line 187 of file postgis/DataSet.cpp.

References m_size.

Referenced by getByteArray().

Member Data Documentation

int te::pgis::DataSet::m_i

protected

The index of the current row.

Definition at line 170 of file postgis/DataSet.h.

Referenced by getArray(), getBool(), getByteArray(), getChar(), getDateTime(), getDouble(), getExtent(), getFloat(), getGeometry(), getInt16(), getInt32(), getInt64(), getNumeric(), getString(), getUChar(), isAfterEnd(), isAtBegin(), isAtEnd(), isBeforeBegin(), isNull(), isPositionValid(), move(), moveBeforeFirst(), moveFirst(), moveLast(), moveNext(), and movePrevious().

te::gm::Envelope* te::pgis::DataSet::m_mbr

protected

The dataset extent.

Definition at line 174 of file postgis/DataSet.h.

Referenced by getExtent().

std::vector<int> te::pgis::DataSet::m_ptypes

protected

The list of property types.

Definition at line 173 of file postgis/DataSet.h.

Referenced by getExtent(), and getPropertyDataType().

PGresult* te::pgis::DataSet::m_result

protected

The internal buffer with the result query.

Definition at line 172 of file postgis/DataSet.h.

Referenced by DataSet(), getArray(), getBool(), getByteArray(), getChar(), getDateTime(), getDouble(), getFloat(), getGeometry(), getInt16(), getInt32(), getInt64(), getNumeric(), getNumProperties(), getPropertyName(), getString(), getUChar(), isNull(), and ~DataSet().

int te::pgis::DataSet::m_size

protected

The number of datasets in the collection.

Definition at line 171 of file postgis/DataSet.h.

Referenced by DataSet(), isAfterEnd(), isAtEnd(), isEmpty(), isPositionValid(), move(), moveBeforeFirst(), moveFirst(), moveLast(), and size().

bool te::pgis::DataSet::m_timeIsInteger

protected

It indicates if the postgis stores, internally, the time and timestamp as an integer.

Definition at line 175 of file postgis/DataSet.h.

Referenced by getDateTime().

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

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation