Cutelee::Variable Class Reference

A container for static variables defined in Templates. More...

#include <cutelee/variable.h>

Public Member Functions
	Variable ()
	Variable (const QString &var)
	Variable (const Variable &other)
	~Variable ()
bool	isConstant () const
bool	isLocalized () const
bool	isTrue (Context *c) const
bool	isValid () const
QVariant	literal () const
QStringList	lookups () const
Variable &	operator= (const Variable &other)
QVariant	resolve (Context *c) const

Detailed Description

This class is only relevant to Template tag authors.

When processing a template tag in a AbstractNodeFactory implementation, it will sometimes make sense to process arguments to the tag as Cutelee::Variables. Note that usually they should be processed as FilterExpression objects instead.

Arguments to the tag can be used to construct Variables, which may then be resolved into the objects they represent in the given Context in the render stage.

Author

Stephen Kelly steve.nosp@m.ire@.nosp@m.gmail.nosp@m..com

Definition at line 52 of file variable.h.

Constructor & Destructor Documentation

Variable() [1/3]

Variable::Variable

(

)

Constructs an invalid Variable

Definition at line 62 of file variable.cpp.

Referenced by Variable(), Variable(), isConstant(), isLocalized(), isValid(), literal(), lookups(), operator=(), and resolve().

Variable() [2/3]

Variable::Variable ( const QString & var )

explicit

Creates a Variable represented by the given var

Definition at line 77 of file variable.cpp.

References Variable(), QLocale::c(), QString::endsWith(), QVariant::fromValue(), Cutelee::markSafe(), QString::mid(), QString::size(), QString::startsWith(), QLocale::toDouble(), QLocale::toInt(), and Cutelee::unescapeStringLiteral().

Variable() [3/3]

Variable::Variable

(

const Variable &

other

)

Copy constructor

Definition at line 57 of file variable.cpp.

References Variable().

~Variable()

Variable::~Variable

(

)

Destructor

Definition at line 64 of file variable.cpp.

Member Function Documentation

isConstant()

bool Variable::isConstant

(

)

const

Returns whether this Variable is a constant in the Template. A constant is represented as a static string in the template

Text content
{% some_tag "constant" variable %}

Definition at line 139 of file variable.cpp.

References Variable().

isLocalized()

bool Variable::isLocalized

(

)

const

Returns whether this variable is localized, that is, if it is wrapped with _().

See also

Internationalization and Localization

Definition at line 147 of file variable.cpp.

References Variable().

isTrue()

bool Variable::isTrue

(

Context *

c

)

const

Returns whether this Variable evaluates to true with the Context c.

Definition at line 145 of file variable.cpp.

References resolve(), and Cutelee::variantIsTrue().

isValid()

bool Variable::isValid

(

)

const

Returns whether this Variable is valid.

Definition at line 133 of file variable.cpp.

References Variable().

literal()

QVariant Variable::literal

(

)

const

Returns whether this variable is a literal string or number. A literal Variable does not have any lookup components.

Definition at line 153 of file variable.cpp.

References Variable().

Referenced by DictSortFilter::doFilter().

lookups()

QStringList Variable::lookups

(

)

const

Returns the lookup components of this Variable.

Definition at line 159 of file variable.cpp.

References Variable().

Referenced by DictSortFilter::doFilter().

operator=()

Variable & Variable::operator=

(

const Variable &

other

)

Assignment operator.

Definition at line 66 of file variable.cpp.

References Variable().

resolve()

QVariant Variable::resolve

(

Context *

c

)

const

Resolves this Variable with the Context c.

Definition at line 175 of file variable.cpp.

References Variable(), QJsonValue::Array, QJsonValue::Bool, QJsonValue::Double, QVariant::fromValue(), Cutelee::getSafeString(), Cutelee::isSafeString(), QVariant::isValid(), Cutelee::Context::localizer(), Cutelee::Context::lookup(), QJsonValue::Object, QMetaType::QJsonArray, QMetaType::QJsonDocument, QMetaType::QJsonObject, QMetaType::QJsonValue, QJsonValue::String, QVariant::toBool(), QVariant::toDouble(), QVariant::toJsonArray(), QVariant::toJsonDocument(), QVariant::toJsonObject(), QVariant::toJsonValue(), QVariant::toString(), QJsonObject::toVariantHash(), QJsonArray::toVariantList(), and QVariant::userType().

Referenced by isTrue().