QgsField Class Reference

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.
bool	convertCompatible (QVariant &v) const
	Converts the provided variant to a compatible format.

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.

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

QgsField::~QgsField

(

)

Destructor.

Member Function Documentation

const QString & QgsField::comment

(

)

const

Returns the field comment.

bool QgsField::convertCompatible

(

QVariant &

v

)

const

Converts the provided variant to a compatible format.

Parameters

v	The value to convert

Returns

True if the conversion was successful

QString QgsField::displayString

(

const QVariant &

v

)

const

Formats string for display.

int QgsField::length

(

)

const

Gets the length of the field.

Returns

int containing the length of the field

const QString & QgsField::name

(

)

const

Gets the name of the field.

bool QgsField::operator!=

(

const QgsField &

other

)

const

bool QgsField::operator==

(

const QgsField &

other

)

const

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.

void QgsField::setComment

(

const QString &

comment

)

Set the field comment.

void QgsField::setLength

(

int

len

)

Set the field length.

Parameters

len	Length of the field

void QgsField::setName

(

const QString &

nam

)

Set the field name.

Parameters

nam	Name of the field

void QgsField::setPrecision

(

int

prec

)

Set the field precision.

Parameters

prec	Precision of the field

void QgsField::setType

(

QVariant::Type

type

)

Set variant type.

void QgsField::setTypeName

(

const QString &

typ

)

Set the field type.

Parameters

typ	Field type

QVariant::Type QgsField::type

(

)

const

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

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 attempt to standardize the value.

Returns

QString containing the field type

---

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

• /tmp/buildd/qgis-2.6.0+wheezy1/src/core/qgsfield.h
• /tmp/buildd/qgis-2.6.0+wheezy1/src/core/qgsfield.cpp