The type for string types: FIXED_STRING, VAR_STRING or STRING. More...

#include <StringProperty.h>

Inheritance diagram for te::dt::StringProperty:

Public Member Functions
Property *	clone () const
	It returns a clone of the object. More...

std::string *	getDefaultValue () const
	It returns the default value associated to the property, or NULL if none is associated. More...

unsigned int	getId () const
	It returns the property identifier. More...

const std::string &	getName () const
	It returns the property name. More...

Property *	getParent () const
	It returns the parent of this property, or NULL, if it doesn't have one. More...

StringType	getSubType () const
	It returns the string property sub type. More...

int	getType () const
	It returns the property data type. More...

bool	has (Property *p) const
	It checks if the Property "p" is associated to this property or any other parent. More...

bool	isAutoNumber () const
	It returns true if the attribute is an autonumber, otherwise it returns false. More...

bool	isRequired () const
	It returns true if the attribute is required, otherwise it returns false. More...

StringProperty &	operator= (const StringProperty &rhs)
	Assignment operator. More...

void	setAutoNumber (bool a)
	It tells if the property is an autonumber or not. More...

void	setDefaultValue (std::string *d)
	It sets the default value associated to the property, or NULL if none is associated. More...

void	setId (unsigned int id)
	It sets the property identifier. More...

void	setName (const std::string &name)
	It sets the property name. More...

void	setParent (Property *p)
	It associate this property to the informed parent. More...

void	setRequired (bool r)
	It tells if the property is required or not. More...

void	setSize (std::size_t s)
	It sets the maximum number of characters for a varying string, or the number of characters for a fixed length string. More...

void	setSubtype (StringType t)
	It sets the string property sub type. More...

std::size_t	size () const
	It returns the maximum number of characters for a varying string, or the number of characters for a fixed length string. No meaning for STRING. More...

	StringProperty (const std::string &name, StringType strType=STRING, std::size_t size=0, bool isRequired=false, std::string defaultValue=0, unsigned int id=0, Property parent=0)
	It constructs a new string property. More...

	StringProperty (const StringProperty &rhs)
	Copy constructor. More...

	~StringProperty ()
	Destructor. More...

Protected Attributes
std::string *	m_defaultValue
	Default value. More...

unsigned int	m_id
	An identification number that can be used internally. More...

bool	m_isAutoNumber
	A flag that indicates if this is an autonumber or serial type. More...

bool	m_isRequired
	This flag indicates if the attribute is required or not. More...

std::string	m_name
	The property name. More...

Property *	m_parent
	The parent property type: it must be a CompositeProperty. More...

std::size_t	m_size
	Maximum number of characters for a varying string or the number of characters for a fixed length string. No meaning for STRING. More...

StringType	m_strSubType
	The sub-type of this string property. More...

int	m_type
	The property data type. More...

Detailed Description

The type for string types: FIXED_STRING, VAR_STRING or STRING.

See Also: SimpleProperty, Property, NumericProperty, ArrayProperty, DateTimeProperty, CompositeProperty

Definition at line 46 of file StringProperty.h.

Constructor & Destructor Documentation

te::dt::StringProperty::StringProperty	(	const std::string &	name,
		StringType	strType = `STRING`,
		std::size_t	size = `0`,
		bool	isRequired = `false`,
		std::string *	defaultValue = `0`,
		unsigned int	id = `0`,
		Property *	parent = `0`
	)

It constructs a new string property.

Parameters

name	The attribute name.
strType	The string subtype. Must be one of: FIXED_STRING, VAR_STRING, or STRING.
size	The maximum size (or 0 for unlimited strings).
isRequired	It indicates if the the property is required (mandatory) or not.
defaultValue	The default value to be used, if none is informed.
id	The property identifier.
parent	A reference to the parent Property of the new object if it has one.

Postcondition: The string property will take the ownership of the defaultValue.

Warning: The identifier value (id) may be used by data source implementations. So, don't rely on its value!

Definition at line 32 of file StringProperty.cpp.

te::dt::StringProperty::StringProperty ( const StringProperty & rhs )

Copy constructor.

Parameters

rhs	The right-hand-side copy used to copy from.

Note: This method is used by clone().

Definition at line 45 of file StringProperty.cpp.

te::dt::StringProperty::~StringProperty ( )

inline

Destructor.

Definition at line 83 of file StringProperty.h.

Member Function Documentation

te::dt::Property * te::dt::StringProperty::clone ( ) const

virtual

It returns a clone of the object.

The new property will NOT have associations to other properties.

Returns: A clone of the object.

Reimplemented from te::dt::SimpleProperty.

Definition at line 66 of file StringProperty.cpp.

std::string* te::dt::SimpleProperty::getDefaultValue ( ) const

inlineinherited

It returns the default value associated to the property, or NULL if none is associated.

Returns: The default value associated to the property, or NULL if none is associated.

Note: The caller of this method will not take the ownership of the given string.

Definition at line 127 of file SimpleProperty.h.

Referenced by te::qt::widgets::UpdateProperty::propertiesComboBoxActivated(), te::qt::widgets::UpdateProperty::setArrayPropertyData(), te::pgis::SetColumnDef(), te::qt::widgets::UpdateProperty::setDateTimePropertyData(), te::qt::widgets::UpdateProperty::setGeometryPropertyData(), te::qt::widgets::UpdateProperty::setNumericPropertyData(), te::qt::widgets::UpdateProperty::setRasterPropertyData(), and te::qt::widgets::UpdateProperty::setStringPropertyData().

unsigned int te::dt::Property::getId ( ) const

inlineinherited

It returns the property identifier.

Returns: A number used to identify the property.

Warning: The identifier value may be used by data source implementations. So, don't rely on its value!

Definition at line 108 of file Property.h.

Referenced by te::da::DataSetTypeConverter::DataSetTypeConverter(), te::pgis::Transactor::getConstraints(), te::pgis::Transactor::getIndexes(), te::pgis::Transactor::getPropertyId(), and te::serialize::xml::Save().

const std::string& te::dt::Property::getName ( ) const

inlineinherited

It returns the property name.

Returns: The property name.

Note: For DataSetTypes the name can have namespace prefix or schema name prefix, it will depend on the data source implementation.

Definition at line 126 of file Property.h.

Property* te::dt::Property::getParent ( ) const

inlineinherited

It returns the parent of this property, or NULL, if it doesn't have one.

Returns: The parent of this property, or NULL, if it doesn't have one.

Definition at line 150 of file Property.h.

Referenced by te::dt::CompositeProperty::add(), te::pgis::Transactor::addSequence(), te::da::DataSourceCatalog::checkSequenceDependency(), te::sqlite::Convert2SQLCreate(), te::da::DataSourceCatalog::dropDependentSequenceEntry(), te::da::DataSourceCatalog::dropDependentSequences(), te::ado::Transactor::dropProperty(), te::pgis::Transactor::getPropertyId(), and te::da::DataSourceCatalog::indexSequenceDependency().

StringType te::dt::StringProperty::getSubType ( ) const

inline

It returns the string property sub type.

Returns: The string property sub type.

Definition at line 99 of file StringProperty.h.

Referenced by te::qt::widgets::UpdateProperty::setArrayPropertyData(), te::pgis::SetColumnDef(), and te::qt::widgets::UpdateProperty::setStringPropertyData().

int te::dt::Property::getType ( ) const

inlineinherited

It returns the property data type.

Returns: The property data type.

Definition at line 143 of file Property.h.

Referenced by te::ado::Transactor::addForeignKey(), te::ado::Transactor::addPrimaryKey(), te::mem::DataSource::addProperty(), te::ogr::Transactor::addProperty(), te::sqlite::DataSourceTransactor::addProperty(), terralib4::Transactor::addProperty(), te::ado::Transactor::addProperty(), te::pgis::Transactor::addProperty(), te::ado::Transactor::addUniqueKey(), te::qt::widgets::UpdateProperty::arrayElementDataTypeComboBoxChanged(), te::graph::LayerRenderer::checkEdgeGeometryProperty(), te::da::DataSourceCatalog::checkSequenceDependency(), te::graph::LayerRenderer::checkVertexGeometryProperty(), te::ogr::Convert2OGR(), te::da::CreateAdapter(), te::sqlite::DataSourceTransactor::createDataSet(), te::graph::DatabaseGraphMetadata::createGraphTableEdgeModel(), te::graph::DatabaseGraphMetadata::createVertexAttrTable(), te::da::DataSetTypeConverter::DataSetTypeConverter(), te::da::DataSourceCatalog::dropDependentSequenceEntry(), te::da::DataSourceCatalog::dropDependentSequences(), te::ado::Transactor::dropProperty(), te::qt::widgets::DataSetAdapterWidget::fillDataSetTable(), te::dt::CompositeProperty::findFirstPropertyOfType(), te::sqlite::DataSourceCatalogLoader::getDataSetType(), te::da::GetEmptyOIDSet(), te::qt::widgets::WhereClauseWidget::getExpression(), te::da::GetFirstSpatialProperty(), te::pgis::Transactor::getProperties(), te::pgis::Transactor::getProperty(), te::pgis::Transactor::getPropertyId(), te::da::GetPropertyInfo(), te::sqlite::DataSourceCatalogLoader::getSpatialIndexes(), te::sqlite::GetSQLType(), te::pgis::GetSQLValue(), GetTabularProperties(), te::da::DataSourceCatalog::indexSequenceDependency(), te::qt::widgets::ChartLayerWidget::listAttributes(), te::qt::widgets::GroupingWidget::listAttributes(), te::da::DataSetTypeConverter::needConverter(), te::graph::DatabaseGraphMetadata::saveProperty(), te::qt::widgets::UpdateProperty::setArrayPropertyData(), and te::pgis::SetColumnDef().

bool te::dt::SimpleProperty::has ( Property * p ) const

virtualinherited

It checks if the Property "p" is associated to this property or any other parent.

This method can be used to ask if a given Property belongs to a more complex type (like: CompositeProperty or DataSetType).

Parameters

p	The Property we are checking.

Returns: True if the given Property "p" is associated to to this Property, otherwise, returns false.

Implements te::dt::Property.

Definition at line 80 of file SimpleProperty.cpp.

bool te::dt::SimpleProperty::isAutoNumber ( ) const

inlineinherited

It returns true if the attribute is an autonumber, otherwise it returns false.

Returns: True if the attribute is an autonumber, otherwise it returns false.

Definition at line 111 of file SimpleProperty.h.

Referenced by te::qt::widgets::UpdateProperty::propertiesComboBoxActivated(), and te::pgis::SetColumnDef().

bool te::dt::SimpleProperty::isRequired ( ) const

inlineinherited

It returns true if the attribute is required, otherwise it returns false.

Returns: True if the attribute is required, otherwise it returns false.

Definition at line 97 of file SimpleProperty.h.

Referenced by te::sqlite::DataSourceTransactor::addProperty(), te::ado::Transactor::addProperty(), te::sqlite::Convert2SQLCreate(), te::qt::widgets::UpdateProperty::propertiesComboBoxActivated(), te::qt::widgets::UpdateProperty::setArrayPropertyData(), te::pgis::SetColumnDef(), te::qt::widgets::UpdateProperty::setDateTimePropertyData(), te::qt::widgets::UpdateProperty::setGeometryPropertyData(), te::qt::widgets::UpdateProperty::setNumericPropertyData(), te::qt::widgets::UpdateProperty::setRasterPropertyData(), and te::qt::widgets::UpdateProperty::setStringPropertyData().

te::dt::StringProperty & te::dt::StringProperty::operator= ( const StringProperty & rhs )

Assignment operator.

Parameters

rhs	The right-hand-side copy used to copy from.

Returns: A reference to this object.

Definition at line 52 of file StringProperty.cpp.

References m_size, m_strSubType, and te::dt::SimpleProperty::operator=().

void te::dt::SimpleProperty::setAutoNumber ( bool a )

inlineinherited

It tells if the property is an autonumber or not.

Parameters

a	If true the property is marked as an autonumber (serial), otherwise it is not.

Definition at line 118 of file SimpleProperty.h.

Referenced by te::qt::widgets::AddProperty::buildArrayProperty(), te::qt::widgets::AddProperty::buildInt32Property(), te::qt::widgets::AddProperty::buildInt64Property(), te::qt::widgets::UpdateProperty::buildUpdatedArrayProperty(), te::qt::widgets::UpdateProperty::buildUpdatedInt32Property(), te::pgis::Convert2TerraLib(), CreateDataSetType(), te::graph::DatabaseGraphMetadata::createGraphAttributesTable(), te::graph::DatabaseGraphMetadata::createGraphMetadataTable(), te::graph::DatabaseGraphMetadata::createGraphTableEdgeModel(), te::graph::DatabaseGraphMetadata::createVertexAttrTable(), getConvertedproperty(), and GetDataSetType().

void te::dt::SimpleProperty::setDefaultValue ( std::string * d )

inherited

It sets the default value associated to the property, or NULL if none is associated.

Parameters

d	The default value associated to the property, or NULL if none is associated.

Note: The SimpleProperty qill take the ownership of the given string.

Definition at line 74 of file SimpleProperty.cpp.

void te::dt::Property::setId ( unsigned int id )

inlineinherited

It sets the property identifier.

Parameters

id	A number used to identify the property.

Warning: The identifier value may be used by data source implementations. So, don't rely on its value!

Definition at line 117 of file Property.h.

Referenced by te::graph::AddDeepAttribute::AddDeepAttribute(), te::graph::AddRasterAttribute::AddRasterAttribute(), te::graph::LDDGraphBuilder::build(), te::pgis::Transactor::createDataSet(), te::graph::FlowGraphBuilder::createEdgeObjects(), te::graph::RAGGraphBuilder::createVertexObjects(), te::graph::FlowGraphBuilder::createVertexObjects(), and te::pgis::Transactor::getPropertyId().

void te::dt::Property::setName ( const std::string & name )

inlineinherited

It sets the property name.

Parameters

name	The new property name.

Warning: Take care when calling this method for a DataSetType associated to a DataSourceCatalog. Prefer using the rename method on the DataSourceCatalog API instead of using this method.

Definition at line 136 of file Property.h.

Referenced by te::ogr::Transactor::createDataSet(), CreateDataSetType(), te::qt::widgets::DirectExchangerDialog::exchangeToDatabase(), te::qt::widgets::DirectExchangerDialog::exchangeToFile(), terralib4::Transactor::getDataSetType(), te::qt::widgets::AddColumnDialog::getNewProperty(), te::qt::widgets::PostGIS2SHPDialog::onOkPushButtonClicked(), te::qt::widgets::SHP2ADODialog::onOkPushButtonClicked(), te::qt::widgets::SHP2PostGISDialog::onOkPushButtonClicked(), and te::stmem::Transactor::renameDataSet().

void te::dt::Property::setParent ( Property * p )

inlineinherited

It associate this property to the informed parent.

Parameters

p	Teh parent property.

Warning: Don't use this method without knowing the internal details of its use.

Definition at line 159 of file Property.h.

Referenced by te::dt::CompositeProperty::add(), te::graph::AddDeepAttribute::AddDeepAttribute(), te::graph::AddRasterAttribute::AddRasterAttribute(), te::dt::ArrayProperty::ArrayProperty(), te::graph::QueryGraphBuilder::build(), te::dt::CompositeProperty::copy(), te::graph::FlowGraphBuilder::createEdgeObjects(), te::graph::DatabaseGraphMetadata::createGraphTableEdgeModel(), te::graph::DatabaseGraphMetadata::createVertexAttrTable(), te::graph::FlowGraphBuilder::createVertexObjects(), te::dt::ArrayProperty::operator=(), and te::dt::ArrayProperty::setElementType().

void te::dt::SimpleProperty::setRequired ( bool r )

inlineinherited

It tells if the property is required or not.

Parameters

r	If true the property is marked as required, otherwise it is not required.

Definition at line 104 of file SimpleProperty.h.

Referenced by te::qt::widgets::AddProperty::buildArrayProperty(), te::qt::widgets::UpdateProperty::buildUpdatedArrayProperty(), and te::ado::Transactor::getProperties().

void te::dt::StringProperty::setSize ( std::size_t s )

inline

It sets the maximum number of characters for a varying string, or the number of characters for a fixed length string.

This value has no meaning for a STRING.

Parameters

size	The maximum size.

Definition at line 122 of file StringProperty.h.

Referenced by te::graph::DatabaseGraphMetadata::createGraphAttributesTable(), te::graph::DatabaseGraphMetadata::createGraphMetadataTable(), te::qt::widgets::StringPropertyWidget::fillProperty(), and te::ado::Transactor::getProperties().

void te::dt::StringProperty::setSubtype ( StringType t )

inline

It sets the string property sub type.

Parameters

t	The string property sub type.

Definition at line 106 of file StringProperty.h.

Referenced by te::qt::widgets::StringPropertyWidget::fillProperty().

std::size_t te::dt::StringProperty::size ( ) const

inline

It returns the maximum number of characters for a varying string, or the number of characters for a fixed length string. No meaning for STRING.

Returns: The maximum number of characters for a varying string, or the number of characters for a fixed length string. No meaning for STRING.

Definition at line 113 of file StringProperty.h.

Referenced by te::ado::Transactor::addProperty(), te::qt::widgets::UpdateProperty::setArrayPropertyData(), te::pgis::SetColumnDef(), and te::qt::widgets::UpdateProperty::setStringPropertyData().

Member Data Documentation

std::string* te::dt::SimpleProperty::m_defaultValue

protectedinherited

Default value.

Definition at line 164 of file SimpleProperty.h.

Referenced by te::dt::SimpleProperty::operator=(), and te::dt::SimpleProperty::SimpleProperty().

unsigned int te::dt::Property::m_id

protectedinherited

An identification number that can be used internally.

Definition at line 187 of file Property.h.

Referenced by te::dt::Property::operator=().

bool te::dt::SimpleProperty::m_isAutoNumber

protectedinherited

A flag that indicates if this is an autonumber or serial type.

Definition at line 163 of file SimpleProperty.h.

Referenced by te::dt::SimpleProperty::operator=().

bool te::dt::SimpleProperty::m_isRequired

protectedinherited

This flag indicates if the attribute is required or not.

Definition at line 162 of file SimpleProperty.h.

Referenced by te::dt::SimpleProperty::operator=().

std::string te::dt::Property::m_name

protectedinherited

The property name.

Definition at line 189 of file Property.h.

Referenced by te::dt::Property::operator=().

Property* te::dt::Property::m_parent

protectedinherited

The parent property type: it must be a CompositeProperty.

Definition at line 186 of file Property.h.

std::size_t te::dt::StringProperty::m_size

protected

Maximum number of characters for a varying string or the number of characters for a fixed length string. No meaning for STRING.

Definition at line 135 of file StringProperty.h.

Referenced by operator=().

StringType te::dt::StringProperty::m_strSubType

protected

The sub-type of this string property.

Definition at line 136 of file StringProperty.h.

Referenced by operator=().

int te::dt::Property::m_type

protectedinherited

The property data type.

Definition at line 188 of file Property.h.

Referenced by te::dt::Property::operator=().

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

/home/castejon/castejon_files/develop/terralib5/git/src/terralib/datatype/StringProperty.h
/home/castejon/castejon_files/develop/terralib5/git/src/terralib/datatype/StringProperty.cpp

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation