Outdated version of the documentation. Find the latest one here.

Выражения, фильтрация и вычисление значений

QGIS has some support for parsing of SQL-like expressions. Only a small subset of SQL syntax is supported. The expressions can be evaluated either as boolean predicates (returning True or False) or as functions (returning a scalar value). See Expressions in the User Manual for a complete list of available functions.

Поддерживается три основных типа данных:

  • число — как целые, так и десятичные, например, 123, 3.14

  • строка — должна заключаться в одинарные кавычки: 'hello world'

  • ссылка на столбец — при вычислении ссылка заменяется на значение поля. Имена полей не экранируются.

Доступны следующие операции:

  • арифметические операторы: +, -, *, /, ^

  • скобки: для изменения приоритета операций: (1 + 1) * 3

  • унарный плюс и минус: -12, +5

  • математические функции: sqrt, sin, cos, tan, asin, acos, atan

  • conversion functions: to_int, to_real, to_string, to_date

  • геометрические функции: $area, $length

  • geometry handling functions: $x, $y, $geometry, num_geometries, centroid

And the following predicates are supported:

  • сравнение: =, !=, >, >=, <, <=

  • соответствие образцу: LIKE (using % and _), ~ (регулярные выражения)

  • огические операторы: AND, OR, NOT

  • проверка на NULL: IS NULL, IS NOT NULL

Примеры предикатов:

  • 1 + 2 = 3
  • sin(angle) > 0
  • 'Hello' LIKE 'He%'
  • (x > 10 AND y > 10) OR z = 0

Примеры скалярных выражений:

  • 2 ^ 10
  • sqrt(val)
  • $length + 1

Разбор выражений

>>> exp = QgsExpression('1 + 1 = 2')
>>> exp.hasParserError()
False
>>> exp = QgsExpression('1 + 1 = ')
>>> exp.hasParserError()
True
>>> exp.parserErrorString()
PyQt4.QtCore.QString(u'syntax error, unexpected $end')

Вычисление выражений

Простые выражения

>>> exp = QgsExpression('1 + 1 = 2')
>>> value = exp.evaluate()
>>> value
1

Выражения с объектами

The following example will evaluate the given expression against a feature. “Column” is the name of the field in the layer.

>>> exp = QgsExpression('Column = 99')
>>> value = exp.evaluate(feature, layer.pendingFields())
>>> bool(value)
True

You can also use QgsExpression.prepare() if you need check more than one feature. Using QgsExpression.prepare() will increase the speed that evaluate takes to run.

>>> exp = QgsExpression('Column = 99')
>>> exp.prepare(layer.pendingFields())
>>> value = exp.evaluate(feature)
>>> bool(value)
True

Handling errors

exp = QgsExpression("1 + 1 = 2 ")
if exp.hasParserError():
  raise Exception(exp.parserErrorString())

value = exp.evaluate()
if exp.hasEvalError():
  raise ValueError(exp.evalErrorString())

print value

Примеры

Следующие примеры могут использоваться для фильтрации слоя и возвращения объектов, удовлетворяющих условию.

def where(layer, exp):
  print "Where"
  exp = QgsExpression(exp)
  if exp.hasParserError():
    raise Exception(exp.parserErrorString())
  exp.prepare(layer.pendingFields())
  for feature in layer.getFeatures():
    value = exp.evaluate(feature)
    if exp.hasEvalError():
      raise ValueError(exp.evalErrorString())
    if bool(value):
      yield feature

layer = qgis.utils.iface.activeLayer()
for f in where(layer, 'Test > 1.0'):
  print f + " Matches expression"