Soprano::LiteralValue Class Reference

Represents a literal value of an RDF Node. More...

#include <Soprano/LiteralValue>

List of all members.

Public Member Functions

 LiteralValue ()
 ~LiteralValue ()
 LiteralValue (const LiteralValue &other)
 LiteralValue (const QVariant &v)
 LiteralValue (int i)
 LiteralValue (qlonglong i)
 LiteralValue (uint i)
 LiteralValue (qulonglong i)
 LiteralValue (bool b)
 LiteralValue (double d)
 LiteralValue (const char *string)
 LiteralValue (const QLatin1String &string)
 LiteralValue (const QString &string)
 LiteralValue (const QDate &date)
 LiteralValue (const QTime &time)
 LiteralValue (const QDateTime &datetime)
 LiteralValue (const QByteArray &data)
LiteralValueoperator= (const LiteralValue &other)
LiteralValueoperator= (int i)
LiteralValueoperator= (qlonglong i)
LiteralValueoperator= (uint i)
LiteralValueoperator= (qulonglong i)
LiteralValueoperator= (bool b)
LiteralValueoperator= (double d)
LiteralValueoperator= (const QString &s)
LiteralValueoperator= (const QLatin1String &s)
LiteralValueoperator= (const QDate &date)
LiteralValueoperator= (const QTime &time)
LiteralValueoperator= (const QDateTime &datetime)
LiteralValueoperator= (const QByteArray &data)
bool operator== (const LiteralValue &other) const
bool operator!= (const LiteralValue &other) const
bool isValid () const
bool isInt () const
bool isInt64 () const
bool isUnsignedInt () const
bool isUnsignedInt64 () const
bool isBool () const
bool isDouble () const
bool isString () const
bool isDate () const
bool isTime () const
bool isDateTime () const
bool isByteArray () const
int toInt () const
qlonglong toInt64 () const
uint toUnsignedInt () const
qulonglong toUnsignedInt64 () const
bool toBool () const
double toDouble () const
QString toString () const
QDate toDate () const
QTime toTime () const
QDateTime toDateTime () const
QByteArray toByteArray () const
QUrl dataTypeUri () const
QVariant::Type type () const
QVariant variant () const

Static Public Member Functions

static LiteralValue fromString (const QString &value, QVariant::Type type)
static LiteralValue fromString (const QString &value, const QUrl &dataTypeUri)
static QVariant::Type typeFromDataTypeUri (const QUrl &dataTypeUri)
static QUrl dataTypeUriFromType (QVariant::Type type)


Detailed Description

Represents a literal value of an RDF Node.

LiteralValue is based on QVariant to support a subset of the XML Schema types that are compatible with QT types.

The following types are supported natively including automatic type conversion. Other types are represented as strings.

Literal values can be converted from strings via fromString().

Warning:
Be aware that string literals in Soprano always have type xsd:string. There is no direct support for rdfs:Literal. Backend implementations should honour this restriction.
See also:
Vocabulary::XMLSchema
Author:
Sebastian Trueg <trueg@kde.org>

Definition at line 68 of file literalvalue.h.


Constructor & Destructor Documentation

Soprano::LiteralValue::LiteralValue (  ) 

Create an empty literal value

Soprano::LiteralValue::~LiteralValue (  ) 

Destructor

Soprano::LiteralValue::LiteralValue ( const LiteralValue other  ) 

Default copy constructor

Soprano::LiteralValue::LiteralValue ( const QVariant v  ) 

Creates a new LiteralValue from a QVariant. User types are not supported. If v contains an unsupported type an invalid LiteralValue is created.

Soprano::LiteralValue::LiteralValue ( int  i  ) 

Creates a literal value of type int (i.e. http://www.w3.org/2001/XMLSchema#int)

Soprano::LiteralValue::LiteralValue ( qlonglong  i  ) 

Creates a literal value of type long long (i.e. http://www.w3.org/2001/XMLSchema#long)

Soprano::LiteralValue::LiteralValue ( uint  i  ) 

Creates a literal value of type unsigned int (i.e. http://www.w3.org/2001/XMLSchema#unsignedInt)

Soprano::LiteralValue::LiteralValue ( qulonglong  i  ) 

Creates a literal value of type unsigned long long (i.e. http://www.w3.org/2001/XMLSchema#unsignedLong)

Soprano::LiteralValue::LiteralValue ( bool  b  ) 

Creates a literal value of type bool (i.e. http://www.w3.org/2001/XMLSchema#boolean)

Soprano::LiteralValue::LiteralValue ( double  d  ) 

Creates a literal value of type double (i.e. http://www.w3.org/2001/XMLSchema#double)

Soprano::LiteralValue::LiteralValue ( const char *  string  ) 

Creates a literal value of type QString (i.e. http://www.w3.org/2001/XMLSchema#string)

Parameters:
string The value of the new literal interpreted as UTF-8 encoded string.

Soprano::LiteralValue::LiteralValue ( const QLatin1String string  ) 

Creates a literal value of type QString (i.e. http://www.w3.org/2001/XMLSchema#string)

Soprano::LiteralValue::LiteralValue ( const QString string  ) 

Creates a literal value of type QString (i.e. http://www.w3.org/2001/XMLSchema#string)

Soprano::LiteralValue::LiteralValue ( const QDate date  ) 

Creates a literal value of type QDate (i.e. http://www.w3.org/2001/XMLSchema#date)

Soprano::LiteralValue::LiteralValue ( const QTime time  ) 

Creates a literal value of type QTime (i.e. http://www.w3.org/2001/XMLSchema#time)

Soprano::LiteralValue::LiteralValue ( const QDateTime datetime  ) 

Creates a literal value of type QDateTime (i.e. http://www.w3.org/2001/XMLSchema#dateTime)

Soprano::LiteralValue::LiteralValue ( const QByteArray data  ) 

Creates a literal value of type QByteArray (i.e. http://www.w3.org/2001/XMLSchema#base64Binary)


Member Function Documentation

LiteralValue& Soprano::LiteralValue::operator= ( const LiteralValue other  ) 

Creates a copy of other

LiteralValue& Soprano::LiteralValue::operator= ( int  i  ) 

Assigns i to this literal value. The type will be set to int (http://www.w3.org/2001/XMLSchema#int) unless it is already set to a compatible type.

Thus, a type http://www.w3.org/2001/XMLSchema#integer or http://www.w3.org/2001/XMLSchema#decimal will not be changed.

Be aware that Soprano does not check the ranges of the integer value yet.

LiteralValue& Soprano::LiteralValue::operator= ( qlonglong  i  ) 

Assigns i to this literal value. The type will be set to long (http://www.w3.org/2001/XMLSchema#long).

LiteralValue& Soprano::LiteralValue::operator= ( uint  i  ) 

Assigns i to this literal value. The type will be set to uint (http://www.w3.org/2001/XMLSchema#unsignedInt) unless it is already set to a compatible type.

Thus, a type http://www.w3.org/2001/XMLSchema#unsignedShort will not be changed.

Be aware that Soprano does not check the ranges of the unsigned value yet.

LiteralValue& Soprano::LiteralValue::operator= ( qulonglong  i  ) 

Assigns i to this literal value. The type will be set to unsigned long (http://www.w3.org/2001/XMLSchema#unsignedLong).

LiteralValue& Soprano::LiteralValue::operator= ( bool  b  ) 

Assigns b to this literal value. The type will be set to bool (http://www.w3.org/2001/XMLSchema#boolean).

LiteralValue& Soprano::LiteralValue::operator= ( double  d  ) 

Assigns d to this literal value. The type will be set to double (http://www.w3.org/2001/XMLSchema#double).

LiteralValue& Soprano::LiteralValue::operator= ( const QString s  ) 

Assigns s to this literal value. The type will be set to string (http://www.w3.org/2001/XMLSchema#string).

LiteralValue& Soprano::LiteralValue::operator= ( const QLatin1String s  ) 

Assigns s to this literal value. The type will be set to string (http://www.w3.org/2001/XMLSchema#string).

LiteralValue& Soprano::LiteralValue::operator= ( const QDate date  ) 

Assigns date to this literal value. The type will be set to data (http://www.w3.org/2001/XMLSchema#date).

LiteralValue& Soprano::LiteralValue::operator= ( const QTime time  ) 

Assigns time to this literal value. The type will be set to time (http://www.w3.org/2001/XMLSchema#time).

LiteralValue& Soprano::LiteralValue::operator= ( const QDateTime datetime  ) 

Assigns datetime to this literal value. The type will be set to dateTime (http://www.w3.org/2001/XMLSchema#dateTime).

LiteralValue& Soprano::LiteralValue::operator= ( const QByteArray data  ) 

Assigns datetime to this literal value. The type will be set to ByteArray (http://www.w3.org/2001/XMLSchema#base64Binary).

bool Soprano::LiteralValue::operator== ( const LiteralValue other  )  const

bool Soprano::LiteralValue::operator!= ( const LiteralValue other  )  const

bool Soprano::LiteralValue::isValid (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isInt (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isInt64 (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isUnsignedInt (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isUnsignedInt64 (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isBool (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isDouble (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isString (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isDate (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isTime (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isDateTime (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

bool Soprano::LiteralValue::isByteArray (  )  const

Check if the literal contains a string value. Be aware that unknown literal types are also treated as strings. In that case compare dataTypeUrl.

int Soprano::LiteralValue::toInt (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

qlonglong Soprano::LiteralValue::toInt64 (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

uint Soprano::LiteralValue::toUnsignedInt (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

qulonglong Soprano::LiteralValue::toUnsignedInt64 (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

bool Soprano::LiteralValue::toBool (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

double Soprano::LiteralValue::toDouble (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

QString Soprano::LiteralValue::toString (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

QDate Soprano::LiteralValue::toDate (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

QTime Soprano::LiteralValue::toTime (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

QDateTime Soprano::LiteralValue::toDateTime (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

QByteArray Soprano::LiteralValue::toByteArray (  )  const

Each type can be converted to a string which means that toString in combination with dataTypeUrl provides all the information necessary to store this literal as RDF.

The string value is cached so calling it multiple times in a row is fast.

QUrl Soprano::LiteralValue::dataTypeUri (  )  const

The XML Schema datatype URI.

Returns:
The URI of the XML Schema type referring to the stored type or an empty QUrl if the LiteralValue is empty.

QVariant::Type Soprano::LiteralValue::type (  )  const

The type of the data.

Returns:
The QVariant type of the stored data or QVariant::Invalid if it is an empty value.

QVariant Soprano::LiteralValue::variant (  )  const

The literal value represented in a QVariant. Be aware that the RDF typing information is lost in the converted variant.

static LiteralValue Soprano::LiteralValue::fromString ( const QString value,
QVariant::Type  type 
) [static]

Create a LiteralValue object by parsing string value based on type. If type is unknown a simple string LiteralValue object is returned containing the plain string value.

See also:
fromString(const QString&, const QUrl&)

static LiteralValue Soprano::LiteralValue::fromString ( const QString value,
const QUrl dataTypeUri 
) [static]

Create a LiteralValue object by parsing string value based on dataTypeUri.

Parameters:
value The value of the literal. Might be converted based on dataTypeUri.
dataTypeUri The data type URI. Soprano can automatically convert all XML schema types. All other (unknown) types will be stored as a string value with the plain dataTypeUri as type. Thus, unknown literal types can still be used without automatic type conversion. (Be aware though, that changing the value of a LiteralValue instance will reset the type, ie. custom data type URIs will be lost.)
Both an empty value and dataTypeUri will result in an invalid LiteralValue instance but an empty value with a valid dataTypeUri is possible. A valid value with an invalid dataTypeUri will result in a LiteralValue of type Vocabulary::XMLSchema::string.

Returns:
A newly created LiteralValue instance based on the provided value and dataTypeUri.
See also:
fromString(const QString&, QVariant::Type), Vocabulary::XMLSchema

static QVariant::Type Soprano::LiteralValue::typeFromDataTypeUri ( const QUrl dataTypeUri  )  [static]

Convert an XML Schema URI into a QVariant::Type.

Returns:
The QVariant::Type corresponding to dataTypeUri or QVariant::Invalid if dataTypeUri is unknown.

static QUrl Soprano::LiteralValue::dataTypeUriFromType ( QVariant::Type  type  )  [static]

Convert a QVariant::Type into an XML Schema URI.

Returns:
The XML Schema URI that corresponds to type or an empty QUrl if the type os unknown, i.e. can not be mapped to an XML Schema type.


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

Generated on Tue Jul 22 17:39:34 2008 for Soprano by  doxygen 1.5.6