Encapsulate a field in an attribute table or data source. More...

#include <qgsfield.h>

Public Member Functions
	QgsField (QString name=QString(), QVariant::Type type=QVariant::Invalid, QString typeName=QString(), int len=0, int prec=0, QString comment=QString())
	Constructor.
	~QgsField ()
	Destructor.
bool	operator== (const QgsField &other) const
bool	operator!= (const QgsField &other) const
const QString &	name () const
	Gets the name of the field.
QVariant::Type	type () const
	Gets variant type of the field as it will be retrieved from data source.
const QString &	typeName () const
	Gets the field type.
int	length () const
	Gets the length of the field.
int	precision () const
	Gets the precision of the field.
const QString &	comment () const
	Returns the field comment.
void	setName (const QString &nam)
	Set the field name.
void	setType (QVariant::Type type)
	Set variant type.
void	setTypeName (const QString &typ)
	Set the field type.
void	setLength (int len)
	Set the field length.
void	setPrecision (int prec)
	Set the field precision.
void	setComment (const QString &comment)
	Set the field comment.
QString	displayString (const QVariant &v) const
	Formats string for display.

Private Attributes
QString	mName
	Name.
QVariant::Type	mType
	Variant type.
QString	mTypeName
	Type name from provider.
int	mLength
	Length.
int	mPrecision
	Precision.
QString	mComment
	Comment.

Detailed Description

Encapsulate a field in an attribute table or data source.

QgsField stores metadata about an attribute field, including name, type length, and if applicable, precision.

Definition at line 29 of file qgsfield.h.

Constructor & Destructor Documentation

QgsField::QgsField	(	QString	name = `QString()`,
		QVariant::Type	type = `QVariant::Invalid`,
		QString	typeName = `QString()`,
		int	len = `0`,
		int	prec = `0`,
		QString	comment = `QString()`
	)

Constructor.

Constructs a new QgsField object.

Parameters

name	Field name
type	Field variant type, currently supported: String / Int / Double
typeName	Field type (eg. char, varchar, text, int, serial, double). Field types are usually unique to the source and are stored exactly as returned from the data store.
len	Field length
prec	Field precision. Usually decimal places but may also be used in conjunction with other fields types (eg. variable character fields)
comment	Comment for the field

Definition at line 32 of file qgsfield.cpp.

QgsField::~QgsField ( )

Destructor.

Definition at line 39 of file qgsfield.cpp.

Member Function Documentation

const QString & QgsField::comment ( ) const

Returns the field comment.

Definition at line 80 of file qgsfield.cpp.

References mComment.

Referenced by QgsOfflineEditing::committedAttributesAdded(), QgsVectorLayer::metadata(), and setComment().

QString QgsField::displayString ( const QVariant & v ) const

Formats string for display.

Definition at line 114 of file qgsfield.cpp.

References mPrecision, and mType.

Referenced by QgsAttributeTableModel::data(), and QgsAttributeEditor::setValue().

int QgsField::length ( ) const

Gets the length of the field.

Returns: int containing the length of the field

Definition at line 70 of file qgsfield.cpp.

References mLength.

Referenced by QgsOfflineEditing::committedAttributesAdded(), QgsFieldValidator::fixup(), QgsVectorLayer::metadata(), QgsFieldValidator::QgsFieldValidator(), QgsVectorFileWriter::QgsVectorFileWriter(), QgsVectorDataProvider::supportedType(), and QgsFieldValidator::validate().

const QString & QgsField::name ( ) const

Gets the name of the field.

Definition at line 55 of file qgsfield.cpp.

References mName.

Referenced by QgsVectorLayerEditBuffer::addAttribute(), QgsFields::append(), QgsOfflineEditing::applyAttributesAdded(), QgsDualView::columnBoxInit(), QgsOverlayAnalyzer::combineFieldLists(), QgsVectorLayerEditBuffer::commitChanges(), QgsOfflineEditing::committedAttributesAdded(), QgsFeature::fieldNameIndex(), QgsAttributeTableModel::headerData(), QgsDataDefinedButton::init(), QgsVectorLayer::metadata(), QgsVectorFileWriter::QgsVectorFileWriter(), QgsPalLayerSettings::readDataDefinedProperty(), QgsFields::remove(), and QgsVectorLayerJoinBuffer::updateFields().

bool QgsField::operator!= ( const QgsField & other ) const

Definition at line 49 of file qgsfield.cpp.

bool QgsField::operator== ( const QgsField & other ) const

Definition at line 43 of file qgsfield.cpp.

References mLength, mName, mPrecision, and mType.

int QgsField::precision ( ) const

Gets the precision of the field.

Not all field types have a related precision.

Returns: int containing the precision or zero if not applicable to the field type.

Definition at line 75 of file qgsfield.cpp.

References mPrecision.

Referenced by QgsOfflineEditing::committedAttributesAdded(), QgsVectorLayer::metadata(), QgsFieldValidator::QgsFieldValidator(), QgsVectorFileWriter::QgsVectorFileWriter(), and QgsVectorDataProvider::supportedType().

void QgsField::setComment ( const QString & comment )

Set the field comment.

Definition at line 109 of file qgsfield.cpp.

References comment(), and mComment.

void QgsField::setLength ( int len )

Set the field length.

Parameters

len	Length of the field

Definition at line 100 of file qgsfield.cpp.

References mLength.

void QgsField::setName ( const QString & nam )

Set the field name.

Parameters

nam	Name of the field

Definition at line 85 of file qgsfield.cpp.

References mName.

Referenced by QgsVectorLayerJoinBuffer::updateFields().

void QgsField::setPrecision ( int prec )

Set the field precision.

Parameters

prec	Precision of the field

Definition at line 104 of file qgsfield.cpp.

References mPrecision.

void QgsField::setType ( QVariant::Type type )

Set variant type.

Definition at line 90 of file qgsfield.cpp.

References mType, and type().

Referenced by QgsGmlSchema::endElement().

void QgsField::setTypeName ( const QString & typ )

Set the field type.

Parameters

typ	Field type

Definition at line 95 of file qgsfield.cpp.

References mTypeName, and typeName().

Referenced by QgsOfflineEditing::applyAttributesAdded().

QVariant::Type QgsField::type ( ) const

Gets variant type of the field as it will be retrieved from data source.

Definition at line 60 of file qgsfield.cpp.

References mType.

Referenced by QgsOfflineEditing::applyAttributesAdded(), QgsOverlayAnalyzer::combineFieldLists(), QgsOfflineEditing::committedAttributesAdded(), QgsAttributeEditor::createAttributeEditor(), QgsAttributeTableModel::data(), QgsGmlSchema::endElement(), QgsFieldValidator::fixup(), QgsSearchQueryBuilder::getFieldValues(), QgsDataDefinedButton::init(), QgsAttributeDialog::QgsAttributeDialog(), QgsFieldValidator::QgsFieldValidator(), QgsVectorFileWriter::QgsVectorFileWriter(), QgsAttributeEditor::retrieveValue(), setType(), QgsAttributeEditor::setValue(), QgsVectorDataProvider::supportedType(), and QgsFieldValidator::validate().

const QString & QgsField::typeName ( ) const

Gets the field type.

Field types vary depending on the data source. Examples are char, int, double, blob, geometry, etc. The type is stored exactly as the data store reports it, with no attenpt to standardize the value.