Variant Class Reference
from PyKDE4.nepomuk import *
Namespace: Nepomuk
Detailed Description
\class Variant variant.h Nepomuk/Variant
The %Nepomuk Variant extends over QVariant by introducing
direct support for Resource embedding, automatic list conversion
and a restricted set of supported types.
Important differences are:
 No new types can be added other than the ones that have defined 
constructors and get-methods
 Variant supports automatic list generation. For example a Variant 
containing an int also can produce an int-list via the toIntList
method.
 toString and toStringList always return a valid list and do automatic 
conversion from the actual type used in the Variant. Thus, if one only
needs to display the value in a Variant toString and toStringList
do the job.
 Variant comes with direct support for Resource. There is one special 
thing about QUrl Variants though: for both isUrl() and
isResource() return 
true. However, toUrl() will return different
values for Resource and for QUrl Variants: in the former case the
actual Resource.resourceUri() is returned which can be different
in case of file:/ URLs.
- Author:
-  Sebastian Trueg <trueg@kde.org> 
| 
 Methods | 
|  | __init__ (self) | 
|  | __init__ (self, Nepomuk.Variant other) | 
|  | __init__ (self, QVariant other) | 
|  | __init__ (self, long i) | 
|  | __init__ (self, float d) | 
|  | __init__ (self, QString string) | 
|  | __init__ (self, QDate date) | 
|  | __init__ (self, QTime time) | 
|  | __init__ (self, QDateTime datetime) | 
|  | __init__ (self, QUrl url) | 
|  | __init__ (self, Nepomuk.Resource r) | 
|  | __init__ (self, [int] i) | 
|  | __init__ (self, [long] i) | 
|  | __init__ (self, [float] d) | 
|  | __init__ (self, QStringList stringlist) | 
|  | __init__ (self, [QDate] date) | 
|  | __init__ (self, [QTime] time) | 
|  | __init__ (self, [QDateTime] datetime) | 
|  | __init__ (self, [QUrl] url) | 
|  | __init__ (self, [Nepomuk.Resource] r) | 
|  | __init__ (self, [Nepomuk.Variant] vl) | 
|  | append (self, long i) | 
|  | append (self, float d) | 
|  | append (self, QString string) | 
|  | append (self, QDate date) | 
|  | append (self, QTime time) | 
|  | append (self, QDateTime datetime) | 
|  | append (self, QUrl url) | 
|  | append (self, Nepomuk.Resource r) | 
|  | append (self, Nepomuk.Variant v) | 
| bool | isBool (self) | 
| bool | isBoolList (self) | 
| bool | isDate (self) | 
| bool | isDateList (self) | 
| bool | isDateTime (self) | 
| bool | isDateTimeList (self) | 
| bool | isDouble (self) | 
| bool | isDoubleList (self) | 
| bool | isInt (self) | 
| bool | isInt64 (self) | 
| bool | isInt64List (self) | 
| bool | isIntList (self) | 
| bool | isList (self) | 
| bool | isResource (self) | 
| bool | isResourceList (self) | 
| bool | isString (self) | 
| bool | isStringList (self) | 
| bool | isTime (self) | 
| bool | isTimeList (self) | 
| bool | isUnsignedInt (self) | 
| bool | isUnsignedInt64 (self) | 
| bool | isUnsignedInt64List (self) | 
| bool | isUnsignedIntList (self) | 
| bool | isUrl (self) | 
| bool | isUrlList (self) | 
| bool | isValid (self) | 
| bool | operator != (self, Nepomuk.Variant other) | 
| bool | operator == (self, Nepomuk.Variant other) | 
| int | simpleType (self) | 
| bool | toBool (self) | 
| QDate | toDate (self) | 
| [QDate] | toDateList (self) | 
| QDateTime | toDateTime (self) | 
| [QDateTime] | toDateTimeList (self) | 
| float | toDouble (self) | 
| [float] | toDoubleList (self) | 
| int | toInt (self) | 
| long | toInt64 (self) | 
| [int] | toIntList (self) | 
| Nepomuk.Resource | toResource (self) | 
| [Nepomuk.Resource] | toResourceList (self) | 
| QString | toString (self) | 
| QStringList | toStringList (self) | 
| QTime | toTime (self) | 
| [QTime] | toTimeList (self) | 
| long | toUnsignedInt (self) | 
| long | toUnsignedInt64 (self) | 
| [long] | toUnsignedIntList (self) | 
| QUrl | toUrl (self) | 
| [QUrl] | toUrlList (self) | 
| [Nepomuk.Variant] | toVariantList (self) | 
| int | type (self) | 
| QVariant | variant (self) | 
| 
 Static Methods | 
| Nepomuk.Variant | fromNode (Soprano.Node node) | 
| Nepomuk.Variant | fromString (QString value, int type) | 
Method Documentation
Will create an invalid Variant if other has an unsupported type.
 
Will create an invalid Variant if other has an unsupported type.
 
| __init__ | ( | self, |  | 
|  |  | long | i | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | float | d | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | QDate | date | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | QTime | time | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | QUrl | url | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | [int] | i | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | [long] | i | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | [float] | d | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | [QDate] | date | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | [QTime] | time | 
|  | ) |  |  |  | 
 
 
| __init__ | ( | self, |  | 
|  |  | [QUrl] | url | 
|  | ) |  |  |  | 
 
 
Create a new Variant from a list of Variants.
- Since:
-  4.3
 
Appends the value stored in v to the list in this
Variant. If this Variant contains a value with the same
simple type as v they are merged into a list. Otherwise
this Variant will contain one list of simple type v.simpleType()
 
Appends the value stored in v to the list in this
Variant. If this Variant contains a value with the same
simple type as v they are merged into a list. Otherwise
this Variant will contain one list of simple type v.simpleType()
 
Appends the value stored in v to the list in this
Variant. If this Variant contains a value with the same
simple type as v they are merged into a list. Otherwise
this Variant will contain one list of simple type v.simpleType()
 
| append | ( | self, |  | 
|  |  | QDate | date | 
|  | ) |  |  |  | 
 
Appends the value stored in v to the list in this
Variant. If this Variant contains a value with the same
simple type as v they are merged into a list. Otherwise
this Variant will contain one list of simple type v.simpleType()
 
| append | ( | self, |  | 
|  |  | QTime | time | 
|  | ) |  |  |  | 
 
Appends the value stored in v to the list in this
Variant. If this Variant contains a value with the same
simple type as v they are merged into a list. Otherwise
this Variant will contain one list of simple type v.simpleType()
 
Appends the value stored in v to the list in this
Variant. If this Variant contains a value with the same
simple type as v they are merged into a list. Otherwise
this Variant will contain one list of simple type v.simpleType()
 
| append | ( | self, |  | 
|  |  | QUrl | url | 
|  | ) |  |  |  | 
 
Appends the value stored in v to the list in this
Variant. If this Variant contains a value with the same
simple type as v they are merged into a list. Otherwise
this Variant will contain one list of simple type v.simpleType()
 
Appends the value stored in v to the list in this
Variant. If this Variant contains a value with the same
simple type as v they are merged into a list. Otherwise
this Variant will contain one list of simple type v.simpleType()
 
Appends the value stored in v to the list in this
Variant. If this Variant contains a value with the same
simple type as v they are merged into a list. Otherwise
this Variant will contain one list of simple type v.simpleType()
 
| bool isDateTimeList | ( |  | self ) |  | 
 
 
| bool isDoubleList | ( |  | self ) |  | 
 
 
| bool isInt64List | ( |  | self ) |  | 
 
 
This methods does not handle all list types.
It checks the following:
 QList<Resource> 
 QList<int> 
 QList<double> 
 QList<bool> 
 QList<QDate> 
 QList<QTime> 
 QList<QDateTime> 
 QList<QUrl> 
 QList<String> (QStringList) 
 
| bool isResourceList | ( |  | self ) |  | 
 
 
| bool isStringList | ( |  | self ) |  | 
 
 
| bool isUnsignedInt | ( |  | self ) |  | 
 
 
| bool isUnsignedInt64 | ( |  | self ) |  | 
 
 
| bool isUnsignedInt64List | ( |  | self ) |  | 
 
 
| bool isUnsignedIntList | ( |  | self ) |  | 
 
 
Does compare two Variant objects. single-valued lists are treated
as the single value itself. For example a QStringList variant with
one element "x" equals a QString variant with value "x".
 
- Returns:
-  the type of the simple value, i.e. with
the list stripped.
 
Convert into a bool value.
Will return the first value of a bool list.
 
Convert into a QDate value.
Will return the first value of a QDate list.
 
| [QDate] toDateList | ( |  | self ) |  | 
 
 
Convert into a QDateTime value.
Will return the first value of a QDateTime list.
 
Convert into a double value.
Will return the first value of a double list.
 
| [float] toDoubleList | ( |  | self ) |  | 
 
 
Convert into an int value. Returns a valid value for
all decimal types.
Will return the first value of an int list.
 
Convert into a qlonglong value. Returns a valid value for
all decimal types.
Will return the first value of a qlonglong list.
 
Convert into a Resource value.
Will return the first value of a Resource list. Will also convert QUrl
variants.
 
The toString() method is a little more powerful than other
toXXX methods since it actually converts all values to string.
Thus, toString should work always (even list variants are converted
to a comma-separated list)
Resources are converted to a string representation of their URI.
 
Just like the toString method toStringList is able to convert all
supported types into a list of strings.
 
Convert into a QTime value.
Will return the first value of a QTime list.
 
| [QTime] toTimeList | ( |  | self ) |  | 
 
 
| long toUnsignedInt | ( |  | self ) |  | 
 
Convert into a uint value. Returns a valid value for
all decimal types.
Will return the first value of a uint list.
 
| long toUnsignedInt64 | ( |  | self ) |  | 
 
Convert into a qulonglong value. Returns a valid value for
all decimal types.
Will return the first value of a qulonglong list.
 
| [long] toUnsignedIntList | ( |  | self ) |  | 
 
 
Convert into a QUrl value. Can handle both QUrl and Resource variants.
The latter will be converted into its resource URI
Will return the first value of a QUrl list.
\sa Resource.resourceUri
 
| [QUrl] toUrlList | ( |  | self ) |  | 
 
 
Convert a Variant to a list of Variants.
- Since:
-  4.3
 
- Returns:
-  the QT Meta type id of the type
 
Static Method Documentation
Create a Variant object from a Soprano.Node.
- Since:
-  4.5
 
Create a Variant object by parsing string value based on type.
If type is unknown a simple string Variant object is returned
containing the plain string value.