Nepomuk2::Query::LiteralTerm Class Reference

#include <Nepomuk2/Query/LiteralTerm>

Inheritance diagram for Nepomuk2::Query::LiteralTerm:

Public Member Functions
	LiteralTerm (const LiteralTerm &term)
	LiteralTerm (const Soprano::LiteralValue &value=Soprano::LiteralValue())
	~LiteralTerm ()
LiteralTerm &	operator= (const LiteralTerm &term)
void	setValue (const Soprano::LiteralValue &value)
Soprano::LiteralValue	value () const
Public Member Functions inherited from Nepomuk2::Query::Term
	Term ()
	Term (const Term &other)
	~Term ()
bool	isAndTerm () const
bool	isComparisonTerm () const
bool	isLiteralTerm () const
bool	isNegationTerm () const
bool	isOptionalTerm () const
bool	isOrTerm () const
bool	isResourceTerm () const
bool	isResourceTypeTerm () const
bool	isValid () const
bool	operator!= (const Term &term) const
QDebug	operator<< (QDebug) const
Term &	operator= (const Term &other)
bool	operator== (const Term &term) const
Term	optimized () const
void	setUserData (const QString &key, const QVariant &value)
AndTerm	toAndTerm () const
AndTerm &	toAndTerm ()
ComparisonTerm	toComparisonTerm () const
ComparisonTerm &	toComparisonTerm ()
LiteralTerm	toLiteralTerm () const
LiteralTerm &	toLiteralTerm ()
NegationTerm	toNegationTerm () const
NegationTerm &	toNegationTerm ()
OptionalTerm	toOptionalTerm () const
OptionalTerm &	toOptionalTerm ()
OrTerm	toOrTerm () const
OrTerm &	toOrTerm ()
ResourceTerm	toResourceTerm () const
ResourceTerm &	toResourceTerm ()
ResourceTypeTerm	toResourceTypeTerm () const
ResourceTypeTerm &	toResourceTypeTerm ()
QString	toString () const
Type	type () const
QVariant	userData (const QString &key) const

Additional Inherited Members
Public Types inherited from Nepomuk2::Query::Term
enum	Type {   Invalid, Literal, Resource, And,   Or, Comparison, ResourceType, Negation,   Optional }
Static Public Member Functions inherited from Nepomuk2::Query::Term
static Term	fromString (const QString &s)
static Term	fromVariant (const Variant &variant)
Related Functions inherited from Nepomuk2::Query::Term
static Term	fromProperty (const Types::Property &property, const Variant &variant)

Detailed Description

Match literal properties via full text.

Other than the rest of the terms LiteralTerm has two uses:

Usage in ComparisonTerm

LiteralTerm can be used in a ComparisonTerm with both properties with a literal range and a resource range. The former case is the simple one: the value() of the LiteralTerm will simply be compared to the value of the ComparisonTerm::property(). In the latter case value() will be matched to rdfs:label of any resource. So in essence the following two examples are equal:

ComparisonTerm( Vocabulary::NAO::hasTag(), LiteralTerm("nepomuk") );
ComparisonTerm( Vocabulary::NAO::hasTag(), ComparisonTerm( Vocabulary::RDFS::label(), LiteralTerm("nepomuk") ) );

Usage as "stand-alone" term

As a term by itself LiteralTerm will act like a traditional full text query and match all resources that contain the string value in some property.

LiteralTerm( "nepomuk" );

The example above will match all resources that have a property with a value containing the string "nepomuk".

Examples

LiteralTerm("nepomuk")

searches for the term "nepomuk".

LiteralTerm("'nepomuk*'")

searches for the terms starting with "nepomuk".

LiteralTerm("'nepomuk kde'")

searches for the term "nepomuk kde".

LiteralTerm("'nepomuk* kde'")

searches for terms matching "nepomuk* kde".

LiteralTerm always tries to normalize the query terms as best as possible. This includes automatically adding quotes as needed.

Warning

Be aware that the examples above apply to using LiteralTerm as a stand-alone term or in a ComparisonTerm::Contains term. When using ComparisonTerm::Regexp the test as specified will be used as-is to create the regular expression.

Author

Sebastian Trueg trueg.nosp@m.@kde.nosp@m..org

Since

4.4

Definition at line 86 of file literalterm.h.

Constructor & Destructor Documentation

Nepomuk2::Query::LiteralTerm::LiteralTerm

(

const LiteralTerm &

term

)

Copy constructor.

Definition at line 237 of file literalterm.cpp.

Nepomuk2::Query::LiteralTerm::LiteralTerm

(

const Soprano::LiteralValue &

value = Soprano::LiteralValue()

)

Default constructor.

Parameters

value

The value this LiteralTerm should match to.

Definition at line 243 of file literalterm.cpp.

Nepomuk2::Query::LiteralTerm::~LiteralTerm

(

)

Desctructor.

Definition at line 250 of file literalterm.cpp.

Member Function Documentation

Nepomuk2::Query::LiteralTerm & Nepomuk2::Query::LiteralTerm::operator=

(

const LiteralTerm &

term

)

Assignment operator.

Definition at line 255 of file literalterm.cpp.

void Nepomuk2::Query::LiteralTerm::setValue

(

const Soprano::LiteralValue &

value

)

Set the value this LiteralTerm should match to.

See also

value()

Definition at line 269 of file literalterm.cpp.

Soprano::LiteralValue Nepomuk2::Query::LiteralTerm::value

(

)

const

The value this LiteralTerm should match to.

See also

setValue()

Definition at line 262 of file literalterm.cpp.

---

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

• literalterm.h
• literalterm.cpp