12.2. Lista de funções

As funções, operadores e variáveis disponíveis no QGIS estão listadas abaixo, agrupadas por categorias.

12.2.1. Funções de Agregação

Este grupo contém funções que agregam valores em camadas e campos.

12.2.1.1. aggregate

Retorna um valor agregado calculado usando feições de outra camada.

Sintaxe	aggregate(layer, aggregate, expression, [filter], [concatenator=’’], [order_by]) [] indica argumentos opcionais
Argumentos	layer - uma string, representando um nome de camada ou um ID de camada aggregate - uma string correspondente à agregação a ser calculada. As opções válidas são: count count_distinct count_missing min max sum mean median stdev stdevsample range minority majority q1: primeiro quartil q3:terceiro quartil iqr: intervalo interquartil min_length: comprimento mínimo da string max_length: comprimento máximo da string concatenate: unir strings com um concatenador concatenate_unique: junte strings únicas com um concatenador collect: cria uma geometria multiparte agregada array_agg: cria um array de valores agregados expression - sub expressão ou nome do campo para agregar filter - expressão de filtro opcional para limitar os recursos usados ​​para calcular a agregação. Campos e geometria são das feições na camada unida. O recurso de origem pode ser acessado com a variável @parent. concatenator - string opcional a ser usada para unir valores para agregação ‘concatenar’ order_by - expressão de filtro opcional para ordenar os recursos usados ​​para calcular o agregado. Campos e geometria são as das feições da camada unida. Por padrão, os recursos serão retornadas em uma ordem não especificada.
Exemplos	aggregate(layer:='estações_ferroviárias',aggregate:='sum',expression:="passageiros") → soma de todos os valores do campo de passageiros na camada estações_ferroviárias aggregate('estações_ferroviárias','sum', "passageiros"/7) → calcula uma média diária de “passageiros” dividindo o campo “passageiros” por 7 antes de somar os valores aggregate(layer:='estações_ferroviárias',aggregate:='sum',expression:="passageiros",filter:="classe">3) → soma todos os valores do campo “passageiros” das feições onde o atributo “classe” é maior que 3 apenas aggregate(layer:='estações_ferroviárias',aggregate:='concatenate,expression:="nome",concatenator:'.') → lista separada por vírgulas do campo de nome para todas as feições na camada estações_ferroviárias aggregate(layer:='countries', aggregate:='max', expression:="código", filter:=intersects( $geometry, geometry(@parent) ) ) → O código do país de um país de interseção no camada ‘countries’ aggregate(layer:='rail_stations',aggregate:='sum',expression:="passengers",filter:=contains( @atlas_geometry, $geometry)) → soma de todos os valores do campo passengers da camada rail_stations que são contidas pela feição atual do atlas aggregate(layer:='rail_stations', aggregate:='collect', expression:=centroid($geometry), filter:="region_name" = attribute(@parent,'name') ) → agrega o centroide das geometrias de rail_stations da mesma região que a feição atual

12.2.1.2. array_agg

Retorna um array de valores agregados de um campo ou expressão.

Sintaxe	array_agg(expression, [group_by], [filter], [order_by]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação order_by - expressão opcional a ser usada para ordenar recursos usados ​​para calcular a agregação. Por padrão, os recursos serão devolvidos em uma ordem não especificada.
Exemplos	array_agg("nome",group_by:="estado") → lista de valores de name, agrupados por campo state

12.2.1.3. collect

Retorna a geometria multipartes de geometrias agregadas de uma expressão

Sintaxe	collect(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expressão - expressão geométrica para agregar group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	collect($geometry ) → geometria multipartes de geometrias agregadas collect( centroid($geometry), group_by:="region", filter:= "use" = 'civilian' ) → centroides agregados das feições civilian com base em seu valor de region

12.2.1.4. concatenate

Retorna todas as strings agregadas de um campo ou expressão unidas por um delimitador.

Sintaxe	concatenate(expression, [group_by], [filter], [concatenator], [group_by]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação concatenator - string opcional a ser usada para unir valores. Vazio por padrão. order_by - expressão opcional a ser usada para ordenar recursos usados ​​para calcular a agregação. Por padrão, os recursos serão devolvidos em uma ordem não especificada.
Exemplos	concatenate("tow_name",group_by:="state", concatenator:=',') → lista separada por vírgulas de town_name, agrupadas pelo campo de state

12.2.1.5. concatenate_unique

Retorna todas as strings exclusivas de um campo ou expressão unidas por um delimitador.

Sintaxe	concatenate_unique(expression, [group_by], [filter], [concatenator], [order_by]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação concatenator - string opcional a ser usada para unir valores. Vazio por padrão. order_by - expressão opcional a ser usada para ordenar recursos usados ​​para calcular a agregação. Por padrão, os recursos serão devolvidos em uma ordem não especificada.
Exemplos	concatenate_unique("town_name",group_by:="state",concatenator:=',') → lista separada por vírgulas de town_name exclusivos, agrupados pelo campo state

12.2.1.6. count

Retorna a contagem de feições correspondentes.

Sintaxe	count(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	count("stations",group_by:="status") → contagem de stations, agrupadas pelo campo state

12.2.1.7. count_distinct

Retorna a contagem de valores distintos.

Sintaxe	count_distinct(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	count_distinct("stations",group_by:="state") → contagem dos valores de stations distintos, agrupados pelo campo state

12.2.1.8. count_missing

Retorna a contagem de valores ausentes (NULL).

Sintaxe	count_missing(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	count_missing("stations",group_by:="state") → contagem dos valores faltantes (NULL) de stations. agrupados pelo campo state

12.2.1.9. iqr

Retorna o intervalo interquartil calculado de um campo ou expressão.

Sintaxe	iqr(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	iqr("population",group_by:="state") → intervalo inter quartil dos valores em population, agrupados pelo campo state

12.2.1.10. majority

Retorna a maioria agregada dos valores (o valor mais comum) de um campo ou expressão.

Sintaxe	majority(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	majority("class", group_by:="state") → valor de class mais comum, agrupado pelo campo state

12.2.1.11. max_length

Retorna o comprimento máximo de strings de um campo ou expressão.

Sintaxe	max_length(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	max_length("town_name",group_by:="state") → tamanho máximo de town_name, agrupado pelo campo state

12.2.1.12. maximum

Retorna o valor máximo agregado de um campo ou expressão.

Sintaxe	maximum(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	maximum("population",group_by:="state") → valor máximo em population, agrupado pelo campo state

12.2.1.13. mean

Retorna o valor médio agregado de um campo ou expressão.

Sintaxe	mean(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	mean("population",group_by:="state") → mediana dos valores em population, agrupados pelo campo state

12.2.1.14. median

Retorna o valor médio agregado de um campo ou expressão.

Sintaxe	median(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	median("population",group_by:="state") → mediana dos valores em population, agrupado pelo campo state

12.2.1.15. min_length

Retorna o comprimento mínimo de strings de um campo ou expressão.

Sintaxe	min_length(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	min_length("town_name",group_by:="state") → menor tamanho de town_name, agrupado pelo campo state

12.2.1.16. minimum

Retorna o valor mínimo agregado de um campo ou expressão.

Sintaxe	minimum(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	minimum("population",group_by:="state") → valor mínimo de population, agrupado pelo campo state

12.2.1.17. minority

Retorna a minoria agregada de valores (valor de menor ocorrência) de um campo ou expressão.

Sintaxe	minority(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	minority("class",group_by:="state") → valor de menor ocorrência em class, agrupado pelo campo state

12.2.1.18. q1

Retorna o primeiro quartil calculado de um campo ou expressão.

Sintaxe	q1(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	q1("population",group_by:="state") → primeiro quartil do valor population, agrupado pelo campo state

12.2.1.19. q3

Retorna o terceiro quartil calculado de um campo ou expressão.

Sintaxe	q3(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	q3("population",group_by:="state") → terceiro quartil do valor population agrupado pelo campo estado

12.2.1.20. range

Retorna o intervalo agregado de valores (máximo - mínimo) de um campo ou expressão.

Sintaxe	range(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	range("population",group_by:="state") → range de valores da população agrupados pelo campo estado

12.2.1.21. relation_aggregate

Retorna um valor agregado calculado usando todas as feições filhas que coincidirem com a relação da camada.

Sintaxe	relation_aggregate(relation, aggregate, expression, [concatenator=’’], [order_by]) [] indica argumentos opcionais
Argumentos	relation - uma strinng, representando o ID da relação aggregate - uma string correspondente à agregação a ser calculada. As opções válidas são: count count_distinct count_missing min max sum mean median stdev stdevsample range minority majority q1: primeiro quartil q3:terceiro quartil iqr: intervalo interquartil min_length: comprimento mínimo da string max_length: comprimento máximo da string concatenate: unir strings com um concatenador concatenate_unique: junte strings únicas com um concatenador collect: cria uma geometria multiparte agregada array_agg: cria um array de valores agregados expression - sub expressão ou nome do campo para agregar concatenator - string opcional a ser usada para unir valores para agregação ‘concatenar’ order_by - expressão opcional para ordenação das feições usadas no cálculo da agregação. Campos e geometria são provenientes das feições da camada unida. Por padrão, as feições serão retornadas sem ordem específica.
Exemplos	relation_aggregate(relation:='my_relation',aggregate:='mean',expression:="passengers") → valor médio de todas feições filhas encontradas utilizando a relação ‘my_relation’ relation_aggregate('my_relation','sum', "passengers"/7) → soma do campo passengers divididos por 7 para todas as feições filhas usando a relação ‘my_relation’ relation_aggregate('my_relation','concatenate', "towns", concatenator:=',') → lista separada por vírgulas do campo towns para todas as camadas filhas encontradas utilizando a relação ‘my_relation’ relation_aggregate('my_relation','array_agg', "id") → array do campo id de todas as feições filhas encontradas usando a relação ‘my_relation’

Leitura adicional: Criando uma ou muitas para muitas relações

12.2.1.22. stdev

Retorna o valor agregado do desvio padrão de um campo ou expressão.

Sintaxe	stdev(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	stdev("population",group_by:="state") → desvio padrão do valor em population, agrupado pelo campo state

12.2.1.23. sum

Retorna o valor somado agregado de um campo ou expressão.

Sintaxe	sum(expression, [group_by], [filter]) [] indica argumentos opcionais
Argumentos	expression - sub expressão do campo a ser agregado group_by - expressão opcional a ser usada para agrupar cálculos agregados filter - expressão opcional a ser usada para filtrar recursos usados ​​para calcular a agregação
Exemplos	sum("population",group_by:="state") → soma dos valores population, agrupados pelo campo state

12.2.2. Funções de Array

Este grupo contém funções para criar e manipular arrays (também conhecidas como estruturas de dados da lista). A ordem dos valores no array é importante, diferentemente da ‘map’ data structure, onde a ordem dos pares chave-valor é irrelevante e os valores são identificados por suas chaves.

12.2.2.1. array

Retorna um array contendo todos os valores passados como parâmetros.

Sintaxe	matriz(valor1, valor2, …)
Argumentos	valor - um valor
Exemplos	matriz(2,10) → [ 2, 10 ] matriz(2,10)[0] → 2

12.2.2.2. array_all

Retorna verdadeiro se uma matriz contiver todos os valores de uma determinada matriz.

Sintaxe	array_all(array_a, array_b)
Argumentos	matriz_a - uma matriz array_b - o array de valores a procurar
Exemplos	array_all(array(1,2,3),array(2,3)) → true array_all(array(1,2,3),array(1,2,4)) → false

12.2.2.3. array_append

Retorna uma matriz com o valor fornecido adicionado no final.

Sintaxe	array_append(array, value)
Argumentos	array - um array value - o valor a ser adicionado
Exemplos	array_append(array(1,2,3),4) → [ 1, 2, 3, 4 ]

12.2.2.4. array_cat

Retorna um array com todos os arrays informados concatenados.

Sintaxe	array_cat(array1, array2, …)
Argumentos	array - um array
Exemplos	array_cat(array(1,2),array(2,3)) → [ 1, 2, 2, 3 ]

12.2.2.5. array_contains

Retorna verdadeiro se um array contiver o valor fornecido.

Sintaxe	array_contains(array, value)
Argumentos	array - um array value - valor a pesquisar
Exemplos	array_contains(array(1,2,3),2) → true

12.2.2.6. array_count

Conta o número de ocorrências de um determinado valor em um array.

Sintaxe	array_count(array, value)
Argumentos	array - um array value - o valor a ser contado
Exemplos	array_count(array('a', 'b', 'c', 'b'), 'b') → 2

12.2.2.7. array_distinct

Retorna um array contendo valores distintos do array fornecido.

Sintaxe	matriz_distinta(matriz)
Argumentos	array - um array
Exemplos	matriz_distinta(matriz(1,2,3,2,1)) → [ 1, 2, 3 ]

12.2.2.8. array_filter

Retorna um array com apenas os itens para os quais a expressão é avaliada como verdadeira.

Sintaxe	filtro_matriz(matriz, expressão, [limite=0]) [] indica argumentos opcionais
Argumentos	array - um array expression - uma expressão a ser aplicada em cada item. A variável @element será substituída pelo valor atual limit - número máximo de elementos a serem retornados. Use 0 para retornar todos os valores.
Exemplos	array_filter(array(1,2,3),@element < 3) → [ 1, 2 ] array_filter(array(1,2,3),@element < 3, 1) → [ 1 ]

12.2.2.9. array_find

Retorna o menor index (0 para o primeiro) do valor dentro de um array. Retorna -1 se o valor não for encontrado.

Sintaxe	array_find(array, value)
Argumentos	array - um array value - valor a pesquisar
Exemplos	array_find(array('a', 'b', 'c'), 'b') → 1 array_find(array('a', 'b', 'c', 'b'), 'b') → 1

12.2.2.10. array_first

Retorna o primeiro valor de um array.

Sintaxe	array_first(array)
Argumentos	array - um array
Exemplos	array_first(array('a','b','c')) → ‘a’

12.2.2.11. array_foreach

Retorna um array com a expressão aplicada em cada item.

Sintaxe	array_foreach(array, expression)
Argumentos	array - um array expression - uma expressão a ser aplicada em cada item. A variável @element será substituída pelo valor atual
Exemplos	array_foreach(array('a','b','c'),upper(@element)) → [ ‘A’, ‘B’, ‘C’ ] array_foreach(array(1,2,3),@element + 10) → [ 11, 12, 13 ]

12.2.2.12. array_get

Retorna o enésimo (N) valor (0 para o primeiro) ou ultimo -enésimo valor (-1 para o último) de um array.

Sintaxe	array_get(array, pos)
Argumentos	array - um array pos - índice a ser acessado (baseado em 0)
Exemplos	array_get(array('a','b','c'),1) → ‘b’ array_get(array('a','b','c'),-1) → ‘c’

Dica

Você pode usar também o operador de índice ([]) para pegar um valor de um array.

12.2.2.13. array_insert

Retorna um array com o valor fornecido adicionado na posição especificada.

Sintaxe	array_insert(array, pos, value)
Argumentos	array - um array pos - posição onde adicionar (baseado em 0) value - o valor a ser adicionado
Exemplos	array_insert(array(1,2,3),1,100) → [ 1, 100, 2, 3 ]

12.2.2.14. array_intersect

Retorna verdadeiro se pelo menos um elemento do array1 existir em array2.

Sintaxe	array_intersect(array1, array2)
Argumentos	array1 - um array array2 - outro array
Exemplos	array_intersect(array(1,2,3,4),array(4,0,2,5)) → true

12.2.2.15. array_last

Retorna o último valor de um array.

Sintaxe	array_last(array)
Argumentos	array - um array
Exemplos	array_last(array('a','b','c')) → ‘c’

12.2.2.16. array_length

Retorna o número de elementos de um array.

Sintaxe	array_length(array)
Argumentos	array - um array
Exemplos	array_length(array(1,2,3)) → 3

12.2.2.17. array_majority

Retorna os valores mais comuns em um array.

Sintaxe	array_majority(array, [option=’all’]) [] indica argumentos opcionais
Argumentos	array - um array option=’all’ - uma string especificando o tratamento dos valores retornados. As opções válidas são: todos: Por padrão, todos os valores mais comuns são devolvidos em um array. qualquer: Retorna um dos valores mais comuns. median: Retorna a mediana dos valores mais comuns. Os valores não aritméticos são ignorados. real_majority: Retorna o valor que ocorre em mais da metade do tamanho do array.
Exemplos	array_majority(array(0,1,42,42,43), 'all') → [ 42 ] array_majority(array(0,1,42,42,43,1), 'all') → [ 42, 1 ] array_majority(array(0,1,42,42,43,1), 'any') → 1 or 42 array_majority(array(0,1,1,2,2), 'median') → 1.5 array_majority(array(0,1,42,42,43), 'real_majority') → NULL array_majority(array(0,1,42,42,43,42), 'real_majority') → NULL array_majority(array(0,1,42,42,43,42,42), 'real_majority') → 42

12.2.2.18. array_max

Retorna o valor máximo de um array.

Sintaxe	array_max(array)
Argumentos	array - um array
Exemplos	array_max(array(0,42,4,2)) → 42

12.2.2.19. array_mean

Retorna a média dos valores aritméticos de um array. Valores não numéricos no array são ignorados.

Sintaxe	array_mean(array)
Argumentos	array - um array
Exemplos	array_mean(array(0,1,7,66.6,135.4)) → 42 array_mean(array(0,84,'a','b','c')) → 42

12.2.2.20. array_median

Retorna a mediana dos valores aritméticos de um array. Valores não aritméticos no array são ignorados.

Sintaxe	array_median(array)
Argumentos	array - um array
Exemplos	array_median(array(0,1,42,42,43)) → 42 array_median(array(0,1,2,42,'a','b')) → 1.5

12.2.2.21. array_min

Retorna o valor mínimo de um array.

Sintaxe	array_min(array)
Argumentos	array - um array
Exemplos	array_min(array(43,42,54)) → 42

12.2.2.22. array_minority

Retorna os valores menos comuns de um array.

Sintaxe	array_minority(array, [option=’all’]) [] indica argumentos opcionais
Argumentos	array - um array option=’all’ - uma string especificando o tratamento dos valores retornados. As opções válidas são: all: Padrão, todos os valores menos comuns são retornados em um array. any: Retorna um dos valores menos comuns. median: Retorna a mediana dos valores menos comuns. Valores não aritméticos são ignorados. real_minority: Rentorna os valores com ocorrência menor que a metade do tamanho do array.
Exemplos	array_minority(array(0,42,42), 'all') → [ 0 ] array_minority(array(0,1,42,42), 'all') → [ 0, 1 ] array_minority(array(0,1,42,42,43,1), 'any') → 0 or 43 array_minority(array(1,2,3,3), 'median') → 1.5 array_minority(array(0,1,42,42,43), 'real_minority') → [ 42, 43, 0, 1 ] array_minority(array(0,1,42,42,43,42), 'real_minority') → [ 42, 43, 0, 1 ] array_minority(array(0,1,42,42,43,42,42), 'real_minority') → [ 43, 0, 1 ]

12.2.2.23. array_prepend

Retorna um array com o valor informado inserido no início.

Sintaxe	array_prepend(array, value)
Argumentos	array - um array value - o valor a ser adicionado
Exemplos	array_prepend(array(1,2,3),0) → [ 0, 1, 2, 3 ]

12.2.2.24. array_prioritize

Retorna um array ordenado utilizando a ordenação especificada em outro array. Os valores que estiverem presentes no primeiro array mas faltam no segundo array serão inseridos no final do resultado.

Sintaxe	array_prioritize(array, array_prioritize)
Argumentos	array - um array array_prioritize - an array with values ordered by priority
Exemplos	array_prioritize(array(1, 8, 2, 5), array(5, 4, 2, 1, 3, 8)) → [ 5, 2, 1, 8 ] array_prioritize(array(5, 4, 2, 1, 3, 8), array(1, 8, 6, 5)) → [ 1, 8, 5, 4, 2, 3 ]

12.2.2.25. array_remove_all

Retorna um array com todas as entradas do valor informado removidas.

Sintaxe	array_remove_all(array, value)
Argumentos	array - um array value - os valores a serem removidos
Exemplos	array_remove_all(array('a','b','c','b'),'b') → [ ‘a’, ‘c’ ]

12.2.2.26. array_remove_at

Retorna um array com o index informado removido.

Sintaxe	array_remove_at(array, pos)
Argumentos	array - um array pos - posição a ser removida (baseado em 0)
Exemplos	array_remove_at(array(1,2,3),1) → [ 1, 3 ]

12.2.2.27. array_replace

Retorna um array com o valor fornecido, array, ou um map dos valores substituídos.

Value & variant do array

Retorna um array com o valor fornecido ou array dos valores substituídos por outro valor ou um array de valores

Sintaxe	array_replace(array, before, after)
Argumentos	array - array de entrada before - o valor ou matriz de valores a serem substituídos after - o valor ou matriz de valores a serem usados como substituição
Exemplos	array_replace(array('QGIS','SHOULD','ROCK'),'SHOULD','DOES') → [ ‘QGIS’, ‘DOES’, ‘ROCK’ ] array_replace(array(3,2,1),array(1,2,3),array(7,8,9)) → [ 9, 8, 7 ] array_replace(array('Q','G','I','S'),array('Q','S'),'-') → [ ‘-’, ‘G’, ‘I’, ‘-’ ]

Variação por mapeamento

Retorna um array com as chaves do map fornecido substituído pelo valores pareados.

Sintaxe	array_replace(array, map)
Argumentos	array - array de entrada map - map que contém chaves e valores
Exemplos	array_replace(array('APP', 'SHOULD', 'ROCK'),map('APP','QGIS','SHOULD','DOES')) → [ ‘QGIS’, ‘DOES’, ‘ROCK’ ]

12.2.2.28. array_reverse

Retorna a matriz fornecida com valores da matriz na ordem inversa.

Sintaxe	array_reverse(array)
Argumentos	array - um array
Exemplos	array_reverse(array(2,4,0,10)) → [ 10, 0, 4, 2 ]

12.2.2.29. array_slice

Retorna uma parcela do array, O fatiamento é definido pelos argumentos start_pos e end_pos.

Sintaxe	array_slice(array, start_pos, end_pos)
Argumentos	array - um array start_pos - o index da posição inicial da fatia (baseada em 0). O índice strart_pos é incluido na fatia. Se você usar um start_pos negativo, o índice será contado a partir do final da lista (baseado em -1). end_pos - O índice da posição final da fatia (base 0). O índice endo_pos é incluido na fatia. Se você usar um endo_pos negativo, o índice é contato a partir do final da lista (base -1)
Exemplos	array_slice(array(1,2,3,4,5),0,3) → [ 1, 2, 3, 4 ] array_slice(array(1,2,3,4,5),0,-1) → [ 1, 2, 3, 4, 5 ] array_slice(array(1,2,3,4,5),-5,-1) → [ 1, 2, 3, 4, 5 ] array_slice(array(1,2,3,4,5),0,0) → [ 1 ] array_slice(array(1,2,3,4,5),-2,-1) → [ 4, 5 ] array_slice(array(1,2,3,4,5),-1,-1) → [ 5 ] array_slice(array('Dufour','Valmiera','Chugiak','Brighton'),1,2) → [ ‘Valmiera’, ‘Chugiak’ ] array_slice(array('Dufour','Valmiera','Chugiak','Brighton'),-2,-1) → [ ‘Chugiak’, ‘Brighton’ ]

12.2.2.30. array_sort

Retorna o array fornecido com os elementos ordenados.

Sintaxe	array_sort(array, [ascending=true]) [] indica argumentos opcionais
Argumentos	array - um array ascending - defina esse parâmetro para false para ordenar o array na ordem decrescente.
Exemplos	array_sort(array(3,2,1)) → [ 1, 2, 3 ]

12.2.2.31. array_sum

Retorna a soma dos valores aritméticos em uma array. Valores não numéricos na array são ignorados.

Sintaxe	array_sum(array)
Argumentos	array - um array
Exemplos	array_sum(array(0,1,39.4,1.6,'a')) → 42.0

12.2.2.32. array_to_string

Contatena os elementos do array em uma string separada pelo delimitador e utilizando uma string opcional para valores vazios.

Sintaxe	array_to_string(array, [delimiter=’,’], [empty_value=’’]) [] indica argumentos opcionais
Argumentos	array - array de entrada delimiter - string delimitadora usada para separar os elementos concatenados empty_value - string opcional a ser usada em substituição para correspondências vazias (tamanho 0)
Exemplos	array_to_string(array('1','2','3')) → ‘1,2,3’ array_to_string(array(1,2,3),'-') → ‘1-2-3’ array_to_string(array('1','','3'),',','0') → ‘1,0,3’

12.2.2.33. generate_series

Cria uma array contendo uma sequência de números.

Sintaxe	generate_series(start, stop, [step=1]) [] indica argumentos opcionais
Argumentos	start - primeiro valor da sequência stop - valor que termina a sequência uma vez alcançada step - valor usado como incremento entre valores
Exemplos	generate_series(1,5) → [ 1, 2, 3, 4, 5 ] generate_series(5,1,-1) → [ 5, 4, 3, 2, 1 ]

12.2.2.34. regexp_matches

Retorna um array de todas as strings capturadas pelos grupos de captura, na ordem em que os próprios grupos aparecem na expressão regular fornecida em relação a uma string.

Sintaxe	regexp_matches(string, regex, [empty_value=’’]) [] indica argumentos opcionais
Argumentos	string - string para capturar grupos em relação a expressão regular regex - expressão regular para os grupos de captura empty_value - string opcional a ser usada em substituição para correspondências vazias (tamanho 0)
Exemplos	regexp_matches('QGIS=>rocks','(.*)=>(.*)') → [ ‘QGIS’, ‘rocks’ ] regexp_matches('key=>','(.*)=>(.*)','empty value') → [ ‘key’, ‘empty value’ ]

12.2.2.35. string_to_array

Divide a string em um array usando o delimitador fornecido e string opcional fornecida para valores vazios,

Sintaxe	string_to_array(string, [delimiter=’,’], [empty_value=’’]) [] indica argumentos opcionais
Argumentos	string - string de entrada delimiter - string delimitadora utilizada para dividir a string de entrada empty_value - string opcional a ser usada em substituição para correspondências vazias (tamanho 0)
Exemplos	string_to_array('1,2,3',',') → [ ‘1’, ‘2’, ‘3’ ] string_to_array('1,,3',',','0') → [ ‘1’, ‘0’, ‘3’ ]

12.2.3. Funções de Cor

Este grupo contém funções para manipulação de cores.

12.2.3.1. color_cmyk

Retorna uma representação em string de uma cor com base em seus componentes ciano, magenta, amarelo e preto

Sintaxe	color_cmyk(cyan, magenta, yellow, black)
Argumentos	cyan - componente ciano da cor, como um valor percentual inteiro de 0 a 100 magenta - componente magenta da cor, como um valor percentual inteiro de 0 a 100 yellow - componente amarelo da cor, como um valor percentual inteiro de 0 a 100 balck - componente preto da cor, como um valor percentual inteiro de 0 a 100
Exemplos	color_cmyk(100,50,0,10) → ‘0,115,230’

12.2.3.2. color_cmyka

Retorna uma representação em string de uma cor com base em seus componentes ciano, magenta, amarelo, preto e alfa (transparência)

Sintaxe	color_cmyka(cyan, magenta, yellow, black, alpha)
Argumentos	cyan - componente ciano da cor, como um valor percentual inteiro de 0 a 100 magenta - componente magenta da cor, como um valor percentual inteiro de 0 a 100 yellow - componente amarelo da cor, como um valor percentual inteiro de 0 a 100 balck - componente preto da cor, como um valor percentual inteiro de 0 a 100 alpha - componente alpha como um valor inteiro a partir do 0 (completamente transparente) até 255 (opaco)
Exemplos	color_cmyka(100,50,0,10,200) → ‘0,115,230,200’

12.2.3.3. color_grayscale_average

Aplica um filtro de escala cinza e retorna uma representação em string de uma cor fornecida.

Sintaxe	color_grayscale_average(color)
Argumentos	color - uma string de cor
Exemplos	color_grayscale_average('255,100,50') → ‘135,135,135,255’

12.2.3.4. color_hsl

Retorna uma representação em string de uma cor com base em seus atributos de matiz, saturação e luminosidade.

Sintaxe	color_hsl(hue, saturation, lightness)
Argumentos	hue - matiz da cor, um valor inteiro de 0 a 360 saturation - porcentagem de saturação da cor como um valor inteiro de 0 a 100 lightness - porcentagem de luminosidade da cor como um valor inteiro de 0 a 100
Exemplos	color_hsl(100,50,70) → ‘166,217,140’

12.2.3.5. color_hsla

Retorna uma representação em string de uma cor com base em seus atributos de matiz, saturação, brilho e alfa (transparência)

Sintaxe	color_hsla(hue, saturation, lightness, alpha)
Argumentos	hue - matiz da cor, um valor inteiro de 0 a 360 saturation - porcentagem de saturação da cor como um valor inteiro de 0 a 100 lightness - porcentagem de luminosidade da cor como um valor inteiro de 0 a 100 alpha - componente alpha como um valor inteiro a partir do 0 (completamente transparente) até 255 (opaco)
Exemplos	color_hsla(100,50,70,200) → ‘166,217,140,200’

12.2.3.6. color_hsv

Retorna uma representação em string de uma cor baseada na sua matiz, saturação e valores dos atributos.

Sintaxe	color_hsv(hue, saturation, value)
Argumentos	hue - matiz da cor, um valor inteiro de 0 a 360 saturation - porcentagem de saturação da cor como um valor inteiro de 0 a 100 value - porcentagem do valor da cor como um número inteiro de 0 a 100
Exemplos	color_hsv(40,100,100) → ‘255,170,0’

12.2.3.7. color_hsva

Retorna uma representação em string de uma cor com base em seus atributos de matiz, saturação, valor e alfa (transparência).

Sintaxe	color_hsva(hue, saturation, value, alpha)
Argumentos	hue - matiz da cor, um valor inteiro de 0 a 360 saturation - porcentagem de saturação da cor como um valor inteiro de 0 a 100 value - porcentagem do valor da cor como um número inteiro de 0 a 100 alfa - componente alfa como um valor inteiro de 0 (completamente transparente) a 255 (opaco)
Exemplos	color_hsva(40,100,100,200) → ‘255,170,0,200’

12.2.3.8. color_mix_rgb

Returns a string representing a color mixing the red, green, blue, and alpha values of two provided colors based on a given ratio.

Sintaxe	color_mix_rgb(color1, color2, ratio)
Argumentos	color1 - a color string color2 - a color string ratio - a ratio
Exemplos	color_mix_rgb('0,0,0','255,255,255',0.5) → ‘127,127,127,255’

12.2.3.9. color_part

Retorna um componente específico de uma string de cores, por exemplo, o componente vermelho ou o componente alfa.

Sintaxe	color_part(color, component)
Argumentos	color - uma string de cor component - uma string correspondente com o componente da cor a retornar. As opções válidas são: red: componente vermelho RGB (0-255) green: componente verde RGB (0-255) blue: componente azul RGB (0-255) alfa: valor alfa (transparência) (0-255) hue: matiz HSV (0-360) saturation: saturação HSV (0-100) value: valor HSV (0-100) hsl_hue: HSL hue (0-360) hsl_saturation: saturação HSL (0-100) lightness: luminosidade HSL (0-100) cyan: ciano componente CMYK (0-100) magenta: componente magenta CMYK (0-100) yellow: componente amarelo CMYK (0-100) black: componente preto CMYK (0-100)
Exemplos	color_part('200,10,30','green') → 10

12.2.3.10. color_rgb

Retorna uma representação em string de uma cor baseada em seus componentes vermelho, verde e azul.

Sintaxe	color_rgb(red, green, blue)
Argumentos	red - componente vermelho como um valor inteiro de 0 a 255 verde - componente verde como um valor inteiro de 0 a 255 blue - componente azul como um valor inteiro de 0 a 255
Exemplos	color_rgb(255,127,0) → ‘255,127,0’

12.2.3.11. color_rgba

Retorna uma representação em string de uma cor baseada em seus componentes vermelho, verde, azul e alpha (transparência).

Sintaxe	color_rgba(red, green, blue, alpha)
Argumentos	red - componente vermelho como um valor inteiro de 0 a 255 verde - componente verde como um valor inteiro de 0 a 255 blue - componente azul como um valor inteiro de 0 a 255 alpha - componente alpha como um valor inteiro a partir do 0 (completamente transparente) até 255 (opaco)
Exemplos	color_rgba(255,127,0,200) → ‘255,127,0,200’

12.2.3.12. create_ramp

Retorna um rampa gradiente a partir de um mapa de cores e passos.

Sintaxe	create_ramp(map, [discrete=false]) [] indica argumentos opcionais
Argumentos	map - um mapa de string de cores e passos discrete - defina esse parâmetro para true para criar uma rampa de cor discreta
Exemplos	ramp_color(create_ramp(map(0,'0,0,0',1,'255,0,0')),1) → ‘255,0,0,255’

12.2.3.13. darker

Retorna uma string de cor mais escura (ou mais clara)

Sintaxe	darker(color, factor)
Argumentos	color - uma string de cor factor - um inteiro correspondente ao fator de escurecimento: se o fator for maior que 100, esta função retornará uma cor mais escura (por exemplo, definir o fator para 200 retornará uma cor com metade do brilho); se o fator for menor que 100, a cor de retorno é mais clara, mas é recomendado usar a função lighter() para este fim; se o fator for 0 ou negativo, o valor de retorno não será especificado.
Exemplos	darker('200,10,30', 200) → ‘100,5,15,255’

Leitura adicional: lighter

12.2.3.14. lighter

Retorna uma string de cor mais clara (ou mais escura)

Sintaxe	lighter(color, factor)
Argumentos	color - uma string de cor factor - um iinteiro correspondente ao fator de clareamento: se o fator for maior que 100, esta função retornará uma cor mais clara (por exemplo, definir o fator para 150 retornará uma cor 50% mais clara); se o fator for menor que 100, a cor de retorno é mais escura, mas é recomendado usar a função darker() para este fim; se o fator for 0 ou negativo, o valor de retorno não será especificado.
Exemplos	lighter('200,10,30', 200) → ‘255,158,168,255’

Leitura adicional: darker

12.2.3.15. project_color

Retorna uma cor do esquema de cores do projeto.

Sintaxe	project_color(name)
Argumentos	name - um nome de cor
Exemplos	project_color('Logo color') → ‘20,140,50’

Leitura adicional: configurando cores do projeto

12.2.3.16. ramp_color

Retorna uma representação em string de uma rampa de cores.

Variante de rampa salva

Retorna uma representação em string de uma cor a partir de uma rampa salva

Sintaxe	ramp_color(ramp_name, value)
Argumentos	ramp_name - the name of the color ramp as a string, for example ‘Spectral’ value - posição na rampa para selecionar a cor a partir de um número real entre 0 e 1
Exemplos	ramp_color('Spectral',0.3) → ‘253,190,115,255’

Nota

As rampas de cores podem variar entre as instalações do QGIS. Esta função pode não retornar o resultado esperado se você mudar seu projeto QGIS entre instalações.

Variante de rampa criada por expressão

Retorna uma representação em string de uma cor a partir de uma rampa criada por expressão

Sintaxe	ramp_color(ramp, value)
Argumentos	ramp - a rampa de cor value - posição na rampa para selecionar a cor a partir de um número real entre 0 e 1
Exemplos	ramp_color(create_ramp(map(0,'0,0,0',1,'255,0,0')),1) → ‘255,0,0,255’

Leitura adicional: Setting a Color Ramp, The color ramp drop-down shortcut

12.2.3.17. set_color_part

Define um componente de cor específico para uma sttring cores, por exemplo, o componente vermelho ou o componente alfa.

Sintaxe	set_color_part(color, component, value)
Argumentos	color - uma string de cor component - uma string correspondente ao componente da cor a ser definida, As opções válidas são: red: componente vermelho RGB (0-255) green: componente verde RGB (0-255) blue: componente azul RGB (0-255) alfa: valor alfa (transparência) (0-255) hue: matiz HSV (0-360) saturation: saturação HSV (0-100) value: valor HSV (0-100) hsl_hue: HSL hue (0-360) hsl_saturation: saturação HSL (0-100) lightness: luminosidade HSL (0-100) cyan: ciano componente CMYK (0-100) magenta: componente magenta CMYK (0-100) yellow: componente amarelo CMYK (0-100) black: componente preto CMYK (0-100) value - novo valor do componente da cor, respeitando os intervalos listados acima
Exemplos	set_color_part('200,10,30','green',50) → ‘200,50,30,255’

12.2.4. Funções Condicionais

Este grupo contém funções para lidar com verificações condicionais em expressões.

12.2.4.1. CASE

CASE é utilizado para verificar uma série de condições e retornar o resultado para a primeira condição que atender. As condições são verificadas sequencialmente, e se uma condição for verdadeira, a verificação para, e o valor correspondente é retornado, Se nenhuma condição for verdadeira, o valor na cláusula ELSE é retornada. No entanto, se nenhuma cláusula ELSE for declarada e nenhuma das condições forem atendidas, NULL é retornado.

CASE

WHEN condição THEN resultado

[ …n ]

[ ELSE resultado ]

END

[] indica componentes opcionais

Argumentos	WHEN condição - Uma expressão de condição para avaliar THEN resultado - Se a condição for avaliada como Verdadeira, então resultado será avaliado e retornado. ELSE resultado - Se nenhuma das condições acima for avaliada como Verdadeiro, o resultado será avaliado e retornado.
Exemplos	CASE WHEN "name" IS NULL THEN 'None' END → Retorna a sintring ‘None’ se o campo “name” for NULL CASE WHEN $area > 10000 THEN 'Big property' WHEN $area > 5000 THEN 'Medium property' ELSE 'Small property' END → Retorna a string ‘Big property’ se a área for maior que 10000, ‘Medium property’ se a área estiver entre 5000 e 10000, e ‘Small property’ para as outras

12.2.4.2. coalesce

Retorna o primeiro valor não NULO da lista de expressões.

Esta função pode receber qualquer número de argumentos.

Sintaxe	coalesce(expression1, expression2, …)
Argumentos	expression - qualquer expressão ou valor válido, independentemente do tipo.
Exemplos	coalesce(NULL, 2) → 2 coalesce(NULL, 2, 3) → 2 coalesce(7, NULL, 3*2) → 7 coalesce("fieldA", "fallbackField", 'ERROR') → valor do campo fieldA se ele for não-NULL se não o valor de “fallbackField” ou a string ‘ERROR’ se ambos forem NULL

12.2.4.3. if

Testa uma condição e retorna um resultado diferente dependendo da verificação condicional.

Sintaxe	if(condition, result_when_true, result_when_false)
Argumentos	condition - a condição que deve ser verificada result_when_true - resultado que será retornado quando a condição for verdadeira ou outro valor que não seja falso. result_when_false - resultado a ser retornado quando a condição for falsa ou outro valor que seja falso como o 0 ou ‘’. NULL também é convertido para falso.
Exemplos	if( 1+1=2, 'Sim', 'Não' ) → ‘Sim’ if( 1+1=3, 'Sim', 'Não' ) → ‘Não’ if( 5 > 3, 1, 0) → 1 if( '', 'é verdadeiro (não está vazio)', 'é falso (vazio )`) → ‘é falso (vazio)’ if( ' ',  'é verdadeiro (não está vazio)', 'é falso (vazio )`) → ‘é verdadeiro (não está vazio)’ if( 0, 'Um', 'Zero' ) → ‘Zero’ if( 10, 'Um', 'Zero' ) → ‘Um’

12.2.4.4. nullif

Retorna um valor NULL se value1 for igual ao value2; caso contrário irá retornar value1. Isso pode ser usado para substituir valores condicionalmente por NULL.

Sintaxe	nullif(value1, value2)
Argumentos	value1 - O valor que deve ser usado ou substituído por NULO. value2 - O valor de controle que acionará a substituição NULO.
Exemplos	nullif('(none)', '(none)') → NULL nullif('text', '(none)') → ‘text’ nullif("name", '') → NULL, se name for uma string vazia (ou já NULL), ou name em qualquer outro caso.

12.2.4.5. regexp_match

Retorna a primeira posição que corresponda com a expressão regular em uma string unicode, ou 0 se a sub string não for encontrada.

Sintaxe	regexp_match(input_string, regex)
Argumentos	input_string - a string a ser usada contra a expressão regular regex - A expressão regular a ser testada contra a string, os caracteres de barra invertida precisam ser escapados (Ex., “\\s” para combinar com espaço em branco ou “\\b” para corresponder a um limite de palavra).
Exemplos	regexp_match('QGIS ROCKS','\\sROCKS') → 5 regexp_match('Budač','udač\\b') → 2

12.2.4.6. try

Testa uma expressão e retorna seu valor se não tiver erros. Se a expressão retornar algum erro, um valor alternativo será retornado quando fornecido, caso contrário a função retornará NULL.

Sintaxe	try(expression, [alternative]) [] indica argumentos opcionais
Argumentos	expression - expressão que deve ser executada alternative - o resultado que será retornado se a expressão retornar um erro.
Exemplos	try( to_int( '1' ), 0 ) → 1 try( to_int( 'a' ), 0 ) → 0 try( to_date( 'invalid_date' ) ) → NULL

12.2.5. Funções de Conversão

Este grupo contém funções para conversão de um tipo de dado em outro (ex.: string de/para inteiro, binário de/para string, string para data, …).

12.2.5.1. from_base64

Decodifica uma string codificada em Base64 em um valor binário.

Sintaxe	from_base64(string)
Argumentos	string - a cadeia a ser decodificada
Exemplos	from_base64('UUdJUw==') → ‘QGIS’

12.2.5.2. hash

Cria uma hash de uma string fornecida com um determinado método. Um byte (8 bits) é representado por dois “dígitos” hexadecimais, então ‘md4’ (16 bytes) gera uma string hexadecimal de 16 * 2 = 32 caracteres de extensão e ‘keccak_512’ (64 bytes) gera uma string hexadecimal de 64 * 2 = 128 caracteres de extensão.

Sintaxe	hash(string, method)
Argumentos	string - string para transformar em hash method - O método hash entre ‘md4’, ‘md5’, ‘sha1’, ‘sha224’, ‘sha384’, ‘sha512’, ‘sha3_224’, ‘sha3_256’, ‘sha3_384’, ‘sha3_512’, ‘keccak_224’, ‘keccak_256’, ‘keccak_384’, ‘keccak_512’
Exemplos	hash('QGIS', 'md4') → ‘c0fc71c241cdebb6e888cbac0e2b68eb’ hash('QGIS', 'md5') → ‘57470aaa9e22adaefac7f5f342f1c6da’ hash('QGIS', 'sha1') → ‘f87cfb2b74cdd5867db913237024e7001e62b114’ hash('QGIS', 'sha224') → ‘4093a619ada631c770f44bc643ead18fb393b93d6a6af1861fcfece0’ hash('QGIS', 'sha256') → ‘eb045cba7a797aaa06ac58830846e40c8e8c780bc0676d3393605fae50c05309’ hash('QGIS', 'sha384') → ‘91c1de038cc3d09fdd512e99f9dd9922efadc39ed21d3922e69a4305cc25506033aee388e554b78714c8734f9cd7e610’ hash('QGIS', 'sha512') → ‘c2c092f2ab743bf8edbeb6d028a745f30fc720408465ed369421f0a4e20fa5e27f0c90ad72d3f1d836eaa5d25cd39897d4cf77e19984668ef58da6e3159f18ac’ hash('QGIS', 'sha3_224') → ‘467f49a5039e7280d5d42fd433e80d203439e338eaabd701f0d6c17d’ hash('QGIS', 'sha3_256') → ‘540f7354b6b8a6e735f2845250f15f4f3ba4f666c55574d9e9354575de0e980f’ hash('QGIS', 'sha3_384') → ‘96052da1e77679e9a65f60d7ead961b287977823144786386eb43647b0901fd8516fa6f1b9d243fb3f28775e6dde6107’ hash('QGIS', 'sha3_512') → ‘900d079dc69761da113980253aa8ac0414a8bd6d09879a916228f8743707c4758051c98445d6b8945ec854ff90655005e02aceb0a2ffc6a0ebf818745d665349’ hash('QGIS', 'keccak_224') → ‘5b0ce6acef8b0a121d4ac4f3eaa8503c799ad4e26a3392d1fb201478’ hash('QGIS', 'keccak_256') → ‘991c520aa6815392de24087f61b2ae0fd56abbfeee4a8ca019c1011d327c577e’ hash('QGIS', 'keccak_384') → ‘c57a3aed9d856fa04e5eeee9b62b6e027cca81ba574116d3cc1f0d48a1ef9e5886ff463ea8d0fac772ee473bf92f810d’

12.2.5.3. md5

Cria uma hash md5 de uma string.

Sintaxe	md5(string)
Argumentos	string - string para transformar em hash
Exemplos	md5('QGIS') → ‘57470aaa9e22adaefac7f5f342f1c6da’

12.2.5.4. sha256

Cria uma hash sha256 de uma string.

Sintaxe	sha256(string)
Argumentos	string - string para transformar em hash
Exemplos	sha256('QGIS') → ‘eb045cba7a797aaa06ac58830846e40c8e8c780bc0676d3393605fae50c05309’

12.2.5.5. to_base64

Codifica um valor binário em uma string, usando a codificação Base64.

Sintaxe	to_base64(value)
Argumentos	value - o valor binário a ser codificado
Exemplos	to_base64('QGIS') → ‘UUdJUw==’

12.2.5.6. to_date

Converte uma string em um objeto de data. Uma string de formatação pode ser fornecida para analisar a string; veja QDate::fromString ou a documentação da função format_date para documentação adicional da fomatação. Por padrão o locale atual do usuário do QGIS será utilizado.

Sintaxe	to_date(string, [format], [language]) [] indica argumentos opcionais
Argumentos	string - string representando um valor de data format - formato usado para converter a cadeia em uma data language - idioma (minúsculo, duas ou três letras, código de idioma ISO 639) usado para converter a cadeia em uma data. Por padrão, a localidade atual do usuário QGIS é usada.
Exemplos	to_date('2012-05-04') → 2012-05-04 to_date('June 29, 2019','MMMM d, yyyy') → 2019-06-29, se o locale atual utilizar o nome ‘June’ para o sexto mês, caso contrário irá ocorrer um erro to_date('29 juin, 2019','d MMMM, yyyy','fr') → 2019-06-29

12.2.5.7. to_datetime

Converte uma string em um objeto datetime. Uma string opcional pode ser fornecido para avaliar a string; veja QDate::fromString, QTime::fromString ou a documentação da função format_date para documentação adicional do formato. Por padrão a localização atual do usuário do QGIS é utilizada.

Sintaxe	to_datetime(string, [format], [language]) [] indica argumentos opcionais
Argumentos	string - string representando o valor datetime format - formato utilizado para converter a string em datetime language - lingua (caixa baixa, duas ou três letras, código de lingua ISO 639) usada para converter a string em datetime. Por padrão a localização atual do usuário do QGIS é utilizada.
Exemplos	to_datetime('2012-05-04 12:50:00') → 2012-05-04T12:50:00 to_datetime('June 29, 2019 @ 12:34','MMMM d, yyyy @ HH:mm') → 2019-06-29T12:34, se a localização atual utilizar o nome ‘June’ para o sexto mês, caso contrário acontece um erro to_datetime('29 juin, 2019 @ 12:34','d MMMM, yyyy @ HH:mm','fr') → 2019-06-29T12:34

12.2.5.8. to_decimal

Converte uma coordenada de grau, minuto e segundo em seu equivalente decimal.

Sintaxe	to_decimal(value)
Argumentos	value - Uma string grau, minuto, segundo.
Exemplos	to_decimal('6°21\'16.445') → 6.3545680555

12.2.5.9. to_dm

Converte uma coordenada em grau, minuto.

Sintaxe	to_dm(coordinate, axis, precision, [formatting=]) [] indica argumentos opcionais
Argumentos	coordinate - Um valor de latitude ou longitude. axys - O eixo da coordenada. Ou ‘x’ ou ‘y’. precision - Número de casas decimais. formatting - Designa o tipo da formatação. Valores aceitáveis são NULL (padrão), ‘aligned’ ou ‘suffix’.
Exemplos	to_dm(6.1545681, 'x', 3) → 6°9.274′ to_dm(6.1545681, 'y', 4, 'aligned') → 6°09.2741′N to_dm(6.1545681, 'y', 4, 'suffix') → 6°9.2741′N

12.2.5.10. to_dms

Converte uma coordenada para grau, minuto, segundo.

Sintaxe	to_dms(coordinate, axis, precision, [formatting=]) [] indica argumentos opcionais
Argumentos	coordinate - Um valor de latitude ou longitude. axys - O eixo da coordenada. Ou ‘x’ ou ‘y’. precision - Número de casas decimais. formatting - Designa o tipo da formatação. Valores aceitáveis são NULL (padrão), ‘aligned’ ou ‘suffix’.
Exemplos	to_dms(6.1545681, 'x', 3) → 6°9′16.445″ to_dms(6.1545681, 'y', 4, 'aligned') → 6°09′16.4452″N to_dms(6.1545681, 'y', 4, 'suffix') → 6°9′16.4452″N

12.2.5.11. to_int

Converte uma string para um número inteiro. Nada será retornado se o valor não puder ser convertido para inteiro (ex. ‘123asd’ é inválido).

Sintaxe	to_int(string)
Argumentos	string - string a ser convertida para número inteiro
Exemplos	to_int('123') → 123

12.2.5.12. to_interval

Converte uma string para o tipo intervalo. Pode ser utilizado dias, horas, mês, etc de uma data.

Sintaxe	to_interval(string)
Argumentos	string - um string representando um intervalo. Formatos permitidos são {n} days {n} hours {n} months.
Exemplos	to_interval('1 day 2 hours') → interval: 1.08333 dias to_interval( '0.5 hours' ) → interval: 30 minutos to_datetime('2012-05-05 12:00:00') - to_interval('1 day 2 hours') → 2012-05-04T10:00:00

12.2.5.13. to_real

Converte uma string para um número real. Nada é retornado se um valor não puder ser convertido para real (ex.: ‘123.56asd’ é inválido). Os números são arredondados após salvar as alterações se a precisão for menor que o resultado da conversão.

Sintaxe	to_real(string)
Argumentos	string - string a ser convertida para número real
Exemplos	to_real('123.45') → 123.45

12.2.5.14. to_string

Converte um número em string.

Sintaxe	to_string(number)
Argumentos	number - Interio ou valor real. Número a ser convertido para string.
Exemplos	to_string(123) → ‘123’

12.2.5.15. to_time

Converte uma string em um objeto time. Uma string de formato opcional pode ser fornecida para analisar a string; veja QTime::fromString para documentação adicional sobre o formato.

Sintaxe	to_time(string, [format], [language]) [] indica argumentos opcionais
Argumentos	string - string representando um valor time format - formato utilizado para converter a string em time language - lingua (caixa baixa, duas ou três letras, codigo de linguagem ISO 639) usado para converter a string em time
Exemplos	to_time('12:30:01') → 12:30:01 to_time('12:34','HH:mm') → 12:34:00 to_time('12:34','HH:mm','fr') → 12:34:00

12.2.6. Funções Personalizadas

Este grupo contém funções criadas pelo usuário. Veja Editor de Funções para mais detalhes.

12.2.7. Funções de Data e Hora

Este grupo contém funções para manipulação de data e hora. este grupo compartilha várias funções com os grupos Funções de Conversão (to_date, to_time, to_datetime, to_interval) e Funções de String (format_date).

Nota

Armazenando data, datetime e intervalos em campos

A habilidade para armazenar valores data, hora and datetime depende diretamente do provedor da fonte (ex., Shapefile aceita o formato date, mas não datetime ou formato time). A seguir estão algumas sugestões para superar essa limitação:

• date, datetime and time podem ser convertidos e armazenados em campos do tipo texto usando a função format_date() .

• Intervals podem ser armazenados em campos do tipo inteiro ou decimal após a utilização de uma das funções de extração de data (ex., day() para pegar o intervalo em dias)

12.2.7.1. age

Retorna a diferença entre duas datas ou datetimes.

A diferença é retornada como um Interval e precisa ser usada com uma das seguintes funções para extrair informações úteis:

• year

• month

• week

• day

• hour

• minute

• second

Sintaxe	age(datetime1, datetime2)
Argumentos	datetime1 - uma string, date ou datetime representando a data posterior datetime2 - uma string, data ou datetime representando a data anterior
Exemplos	day(age('2012-05-12','2012-05-02')) → 10 hour(age('2012-05-12','2012-05-02')) → 240

12.2.7.2. datetime_from_epoch

Retorna um datetime cujo a data e hora são o número de milisegundos, mseg, que se passaram desde 1970-01-01T00:00:00.000, Coordinated Universal Time (Qt.UTC), e convertido para Qt.LocalTime.

Sintaxe	datetime_from_epoch(int)
Argumentos	int - número (milissegundos)
Exemplos	datetime_from_epoch(1483225200000) → 2017-01-01T00:00:00

12.2.7.3. day

Extrai o dia de uma data ou o número de dias de um intervalo.

Variante Data

Extrai o dia de um date ou datetime.

Sintaxe	day(date)
Argumentos	date - um valor do tipo data ou datetime
Exemplos	day('2012-05-12') → 12

Variante Intervalo

Calcula a duração em dias de um intervalo.

Sintaxe	day(interval)
Argumentos	interval - valor do intervalo para retornar o número de dias
Exemplos	day(to_interval('3 days')) → 3 day(to_interval('3 weeks 2 days')) → 23 day(age('2012-01-01','2010-01-01')) → 730

12.2.7.4. day_of_week

Retorna o dia da semana para um date ou datetime específico. O valor retornado varia de 0 até 6, onde 0 corresponde a Domingo e 6 Sábado.

Sintaxe	day_of_week(date)
Argumentos	date - valor date ou datetime
Exemplos	day_of_week(to_date('2015-09-21')) → 1

12.2.7.5. epoch

Retorna o intervalo em milisegundos entre a epoc unix e um valor de data fornecida.

Sintaxe	epoch(date)
Argumentos	date - um valor do tipo data ou datetime
Exemplos	epoch(to_date('2017-01-01')) → 1483203600000

12.2.7.6. format_date

Fomata o tipo date ou string em uma string formadata customizada. Usa o formato de string do Qt date/time . Veja QDateTime::toString.

Sintaxe	format_date(datetime, format, [language]) [] indica argumentos opcionais
Argumentos	datetime - valor data, hora ou datetime format - String do modelo usado para formatar a string. Expressão Output d o dia como número sem zero à esquerda (1 a 31) dd o dia como número com um zero à esquerda (01 a 31) ddd localização abreveada do nome do dia (ex. ‘Seg’ a ‘Dom’) dddd o nome longo do dia localizado (ex., ‘Segunda-feira’ a ‘Domingo’) M o mês como número sem zero à esquerda (1-12) MM o mês como número com um zero à esquerda (01-12) MMM o nome abreviado do mês localizado (ex., ‘Jan’ a ‘Dez’) MMMM o nome longo do mês localizado (ex., ‘janeiro’ a ‘dezembro’) yy o ano como número de dois dígitos (00-99) yyyy o ano como número de quatro dígitos Estas expressões podem ser usadas para a parte da hora da string de formatação: Expressão Output h a hora sem zero à esquerda (0 a 23 ou 1 a 12 se for exibido AM/PM) hh a hora com um zero à esquerda (00 a 23 ou 01 a 12 se for exibido AM/PM) H a hora sem zero à esquerda (0 a 23, mesmo com exibição AM/PM) HH a hora com um zero à esquerda (00 a 23, mesmo com exibição AM/PM) m o minuto sem zero à esquerda (0 a 59) mm o minuto com um zero à esquerda (00 a 59) s o segundo sem zero à esquerda (0 a 59) ss o segundo com um zero à esquerda (00 a 59) z os milissegundos sem zeros à direita (0 a 999) zzz os milissegundos com zeros à direita (000 a 999) AP or A Iinterprete como uma hora AM/PM. AP precisa ser ambos ‘AM’ ou ‘PM’. ap or a Interprete como uma hora AM/PM. ap precisa ser ambos ‘am’ ou ‘pm’. language - lingua (caixa baixa, duas ou três letras, código de linguagem ISO 639) usada para formatar a data em uma string customizada. Por padrão a localização do usuário atual do QGIS é utilizada.
Exemplos	format_date('2012-05-15','dd.MM.yyyy') → ‘15.05.2012’ format_date('2012-05-15','d MMMM yyyy','fr') → ‘15 mai 2012’ format_date('2012-05-15','dddd') → ‘Terça-feira’, se a localização é uma variante do Português. format_date('2012-05-15 13:54:20','dd.MM.yy') → ‘15.05.12’ format_date('13:54:20','hh:mm AP') → ‘01:54 PM’

12.2.7.7. hour

Extrai a parte das horas de uma daterime ou hora, ou o número de horas de um intervalo.

Variação de tempo

Extrai a parte das horas de uma daterime ou hora.

Sintaxe	hour(datetime)
Argumentos	datetime - um valor de hora ou datetime
Exemplos	hour( to_datetime('2012-07-22 13:24:57') ) → 13

Variante Intervalo

Calcula a duração em horas de um intervalo.

Sintaxe	hour(interval)
Argumentos	interval - valor do intervalo para retornar o número de horas
Exemplos	hour(to_interval('3 hours')) → 3 hour(age('2012-07-22T13:00:00','2012-07-22T10:00:00')) → 3 hour(age('2012-01-01','2010-01-01')) → 17520

12.2.7.8. make_date

Cria um valor de data a partir de números de ano, mês e dia.

Sintaxe	make_date(year, month, day)
Argumentos	year - Número do ano. Os anos de 1 a 99 são interpretados como estão. O ano 0 é inválido. month - Número do mês, onde 1=Janeiro day - Número do dia, começando com 1 para o primeiro dia do mês
Exemplos	make_date(2020,5,4) → date value 2020-05-04

12.2.7.9. make_datetime

Cria um valor de data e hora a partir de números de ano, mês, dia, hora, minuto e segundo.

Sintaxe	make_datetime(year, month, day, hour, minute, second)
Argumentos	year - Número do ano. Os anos de 1 a 99 são interpretados como estão. O ano 0 é inválido. month - Número do mês, onde 1=Janeiro day - Número do dia, começando com 1 para o primeiro dia do mês hour - Número da hora minute - Minutos second - Segundos (valores fracionários incluem milissegundos)
Exemplos	make_datetime(2020,5,4,13,45,30.5) → datetime value 2020-05-04 13:45:30.500

12.2.7.10. make_interval

Cria um intervalo de valores para os valores de ano, mês, semanas, dias, horas, minutos e segundos.

Sintaxe	make_interval([years=0], [months=0], [weeks=0], [days=0], [hours=0], [minutes=0], [seconds=0]) [] indica argumentos opcionais
Argumentos	years - Número de anos (supõe uma duração de ano de 365,25 dias). months - Número de meses (considera uma duração de mês de 30 dias) weeks - Número de semanas days - Número de dias hours - Número de horas minutes - Número de minutos seconds - Número de segundos
Exemplos	make_interval(hours:=3) → interval: 3 hours make_interval(days:=2, hours:=3) → interval: 2.125 days make_interval(minutes:=0.5, seconds:=5) → interval: 35 seconds

12.2.7.11. make_time

Cria um valor de tempo a partir de números de hora, minuto e segundo.

Sintaxe	make_time(hour, minute, second)
Argumentos	hour - Número da hora minute - Minutos second - Segundos (valores fracionários incluem milissegundos)
Exemplos	make_time(13,45,30.5) → time value 13:45:30.500

12.2.7.12. minute

Extrai a parte de minutos de um datetime ou hora, ou o número de minutos de um intevalor.

Variação de tempo

Extrai a parte dos minutos de uma hora ou datetime.

Sintaxe	minute(datetime)
Argumentos	datetime - um valor de hora ou datetime
Exemplos	minute( to_datetime('2012-07-22 13:24:57') ) → 24

Variante Intervalo

Calcula a extensão em minutos de um intervalo.

Sintaxe	minute(interval)
Argumentos	interval - valor do intervalo para retornar o número de minutos
Exemplos	minute(to_interval('3 minutes')) → 3 minute(age('2012-07-22T00:20:00','2012-07-22T00:00:00')) → 20 minute(age('2012-01-01','2010-01-01')) → 1051200

12.2.7.13. month

Extrai a parte do mês de uma data ou o número de meses de um intervalo.

Variante Data

Extrai a parte de mês de uma data ou datetime.

Sintaxe	month(date)
Argumentos	date - um valor do tipo data ou datetime
Exemplos	month('2012-05-12') → 05

Variante Intervalo

Calcula a duração em meses de um intervalo.

Sintaxe	month(interval)
Argumentos	interval - valor do intervalo para retornar o número de meses
Exemplos	month(to_interval('3 months')) → 3 month(age('2012-01-01','2010-01-01')) → 4.03333

12.2.7.14. now

Retorna a data e hora atuais. A função é estática e retornará resultados consistentes durante a avaliação. A hora retornada é a hora em que a expressão é preparada.

Sintaxe	now()
Exemplos	now() → 2012-07-22T13:24:57

12.2.7.15. second

Extrai a parte dos segundos de um datetime ou hora, ou o número de segundos de um intervalo.

Variação de tempo

Extrai a parte do segundos de uma hora ou datetime.

Sintaxe	second(datetime)
Argumentos	datetime - um valor de hora ou datetime
Exemplos	second( to_datetime('2012-07-22 13:24:57') ) → 57

Variante Intervalo

Calcula a duração em segundos de um intervalo.

Sintaxe	second(interval)
Argumentos	interval - valor do intervalo para retornar o número de segundos
Exemplos	second(to_interval('3 minutes')) → 180 second(age('2012-07-22T00:20:00','2012-07-22T00:00:00')) → 1200 second(age('2012-01-01','2010-01-01')) → 63072000

12.2.7.16. to_date

Converte uma string em um objeto de data. Uma string de formatação pode ser fornecida para analisar a string; veja QDate::fromString ou a documentação da função format_date para documentação adicional da fomatação. Por padrão o locale atual do usuário do QGIS será utilizado.

Sintaxe	to_date(string, [format], [language]) [] indica argumentos opcionais
Argumentos	string - string representando um valor de data format - formato usado para converter a cadeia em uma data language - idioma (minúsculo, duas ou três letras, código de idioma ISO 639) usado para converter a cadeia em uma data. Por padrão, a localidade atual do usuário QGIS é usada.
Exemplos	to_date('2012-05-04') → 2012-05-04 to_date('June 29, 2019','MMMM d, yyyy') → 2019-06-29, se o locale atual utilizar o nome ‘June’ para o sexto mês, caso contrário irá ocorrer um erro to_date('29 juin, 2019','d MMMM, yyyy','fr') → 2019-06-29

12.2.7.17. to_datetime

Converte uma string em um objeto datetime. Uma string opcional pode ser fornecido para avaliar a string; veja QDate::fromString, QTime::fromString ou a documentação da função format_date para documentação adicional do formato. Por padrão a localização atual do usuário do QGIS é utilizada.

Sintaxe	to_datetime(string, [format], [language]) [] indica argumentos opcionais
Argumentos	string - string representando o valor datetime format - formato utilizado para converter a string em datetime language - lingua (caixa baixa, duas ou três letras, código de lingua ISO 639) usada para converter a string em datetime. Por padrão a localização atual do usuário do QGIS é utilizada.
Exemplos	to_datetime('2012-05-04 12:50:00') → 2012-05-04T12:50:00 to_datetime('June 29, 2019 @ 12:34','MMMM d, yyyy @ HH:mm') → 2019-06-29T12:34, se a localização atual utilizar o nome ‘June’ para o sexto mês, caso contrário acontece um erro to_datetime('29 juin, 2019 @ 12:34','d MMMM, yyyy @ HH:mm','fr') → 2019-06-29T12:34

12.2.7.18. to_interval

Converte uma string para o tipo intervalo. Pode ser utilizado dias, horas, mês, etc de uma data.

Sintaxe	to_interval(string)
Argumentos	string - um string representando um intervalo. Formatos permitidos são {n} days {n} hours {n} months.
Exemplos	to_interval('1 day 2 hours') → interval: 1.08333 dias to_interval( '0.5 hours' ) → interval: 30 minutos to_datetime('2012-05-05 12:00:00') - to_interval('1 day 2 hours') → 2012-05-04T10:00:00

12.2.7.19. to_time

Converte uma string em um objeto time. Uma string de formato opcional pode ser fornecida para analisar a string; veja QTime::fromString para documentação adicional sobre o formato.

Sintaxe	to_time(string, [format], [language]) [] indica argumentos opcionais
Argumentos	string - string representando um valor time format - formato utilizado para converter a string em time language - lingua (caixa baixa, duas ou três letras, codigo de linguagem ISO 639) usado para converter a string em time
Exemplos	to_time('12:30:01') → 12:30:01 to_time('12:34','HH:mm') → 12:34:00 to_time('12:34','HH:mm','fr') → 12:34:00

12.2.7.20. week

Extrai o número da semana de uma data ou o número de semanas de um intervalo.

Variante Data

Extrai o número da semana de uma data ou datetime.

Sintaxe	week(date)
Argumentos	date - um valor do tipo data ou datetime
Exemplos	week('2012-05-12') → 19

Variante Intervalo

Calcula a duração em semanas de um intervalo.

Sintaxe	week(interval)
Argumentos	interval - valor do intervalo para retornar o número de meses
Exemplos	week(to_interval('3 weeks')) → 3 week(age('2012-01-01','2010-01-01')) → 104.285

12.2.7.21. year

Extrai a parte do ano de uma data ou o número de anos de um intervalo.

Variante Data

Extrai a parte do ano de uma data ou de um datetime.

Sintaxe	year(date)
Argumentos	date - um valor do tipo data ou datetime
Exemplos	year('2012-05-12') → 2012

Variante Intervalo

Calcula a duração em anos de um intervalo.

Sintaxe	year(interval)
Argumentos	interval - valor do intervalo para retornar o número de anos
Exemplos	year(to_interval('3 years')) → 3 year(age('2012-01-01','2010-01-01')) → 1.9986

Alguns exemplos:

Além dessas funções, subtrair datas, datas ou horas usando o operador - (menos) retornará um intervalo.

Adicionar ou subtrair um intervalo a datas, data/hora ou horas, usando os operadores + (mais) e - (menos), retornará uma data/hora.

• Obtenha o número de dias até o lançamento do QGIS 3.0:

  to_date('2017-09-29') - to_date(now())
  -- Returns <interval: 203 days>
  

• O mesmo com o tempo:

  to_datetime('2017-09-29 12:00:00') - now()
  -- Returns <interval: 202.49 days>
  

• Obtenha a data/hora de 100 dias a partir de agora:

  now() + to_interval('100 days')
  -- Returns <datetime: 2017-06-18 01:00:00>
  

12.2.8. Campos e Valores

Contém uma lista de campos da camada e valores especiais.

Clique duas vezes no nome de um campo para adicioná-lo à sua expressão. Você também pode digitar o nome do campo (de preferência entre aspas duplas) ou seu alias.

Para recuperar os valores dos campos a serem usados ​​em uma expressão, selecione o campo apropriado e, no widget mostrado, escolha entre 10 Amostras e Todos os Únicos. Os valores solicitados são exibidos e você pode usar a caixa Pesquisar na parte superior da lista para filtrar o resultado. Valores de amostra também podem ser acessados ​​clicando com o botão direito do mouse em um campo.

Para adicionar um valor à expressão que você está escrevendo, clique duas vezes nela na lista. Se o valor for de um tipo de string, deve ser simples entre aspas, caso contrário, nenhuma citação será necessária.

12.2.8.1. NULL

Equivale a um valor NULO.

Sintaxe	NULL
Exemplos	NULO → um valor NULO

Nota

Para testar NULO, use uma expressão IS NULL ou IS NOT NULL.

12.2.9. Funções de Arquivos e Caminhos

Este grupo contém funções que manipulam nomes de arquivos e caminhos.

12.2.9.1. base_file_name

Retorna o nome base do arquivo sem o diretório ou sufixo do arquivo.

Sintaxe	base_file_name(path)
Argumentos	path - um caminho de arquivo
Exemplos	base_file_name('/home/qgis/data/country_boundaries.shp') → ‘country_boundaries’

12.2.9.2. exif

Recupera valores de tag exif de um arquivo de imagem.

Sintaxe	exif(path, [tag]) [] indica argumentos opcionais
Argumentos	path - Um caminho de image. tag - A tag a ser retornada. se vazio, um mapa com todos os valores será retornado.
Exemplos	exif('/my/photo.jpg','Exif.Image.Orientation') → 0

12.2.9.3. file_exists

Retorna verdadeiro se existir um caminho de arquivo.

Sintaxe	file_exists(path)
Argumentos	path - um caminho de arquivo
Exemplos	file_exists('/home/qgis/data/country_boundaries.shp') → true

12.2.9.4. file_name

Retorna o nome de um arquivo (incluindo a extensão do arquivo), excluindo o diretório.

Sintaxe	file_name(path)
Argumentos	path - um caminho de arquivo
Exemplos	file_name('/home/qgis/data/country_boundaries.shp') → ‘country_boundaries.shp’

12.2.9.5. file_path

Retorna o componente de diretório de um caminho de arquivo. Isso não inclui o nome do arquivo.

Sintaxe	file_path(path)
Argumentos	path - um caminho de arquivo
Exemplos	file_path('/home/qgis/data/country_boundaries.shp') → ‘/home/qgis/data’

12.2.9.6. file_size

Retorna o tamanho (em bytes) de um arquivo.

Sintaxe	file_size(path)
Argumentos	path - um caminho de arquivo
Exemplos	file_size('/home/qgis/data/country_boundaries.geojson') → 5674

12.2.9.7. file_suffix

Retorna o sufixo de um arquivo (extensão) de um caminho de arquivo.

Sintaxe	file_suffix(path)
Argumentos	path - um caminho de arquivo
Exemplos	file_suffix('/home/qgis/data/country_boundaries.shp') → ‘shp’

12.2.9.8. is_directory

Retorna verdadeiro se um caminho corresponder a um diretório.

Sintaxe	is_directory(path)
Argumentos	path - um caminho de arquivo
Exemplos	is_directory('/home/qgis/data/country_boundaries.shp') → false is_directory('/home/qgis/data/') → true

12.2.9.9. is_file

Retorna verdadeiro se um caminho corresponder a um arquivo.

Sintaxe	is_file(path)
Argumentos	path - um caminho de arquivo
Exemplos	is_file('/home/qgis/data/country_boundaries.shp') → true is_file('/home/qgis/data/') → false

12.2.10. Funções de Formulário

Este grupo contém funções que operam exclusivamente sobre os atributos de um contexto. Por exemplo, na configuração dos widgets de campos.

12.2.10.1. current_parent_value

Utilizável apenas em um contexto de formulário incorporado, esta função retorna o valor atual e não salvo de um campo no formulário pai que está sendo editado no momento. Isso será diferente dos valores de atributo reais da feição pai para feições que estão sendo editadas no momento ou que ainda não foram adicionadas a uma camada pai. Quando usada em um widget de filtro por expressão de relação de valor, essa função deve ser agrupada em um ‘coalesce()’ que pode recuperar o recurso pai real da camada quando o formulário não é usado em um contexto incorporado.

Sintaxe	current_parent_value(field_name)
Argumentos	field_name - um nome de campo no fomulátio pai atual
Exemplos	current_parent_value( 'FIELD_NAME' ) → O valot atual no campo ‘FIELD_NAME’ no formulário pai.

12.2.10.2. current_value

Retorna o valor atual não salvo de um campo no formulário ou linha da tabela que está sendo editada no momento. Isso será diferente dos valores de atributo reais da feição para feições que estão sendo editadas no momento ou que ainda não foram adicionadas a uma camada.

Sintaxe	current_value(field_name)
Argumentos	field_name - um nome de campo no formulário pai ou linha da tabela.
Exemplos	current_value( 'FIELD_NAME' ) → O valor atual do campo ‘FIELD_NAME’.

12.2.11. Funções de Combinação Fuzzy

Este grupo contém funções para comaparações fuzzy entre valores.

12.2.11.1. hamming_distance

Retorna a distância de Hamming entre duas strings. Isso equivale ao número de caracteres em posições correspondentes nas strings de entrada onde os caracteres são diferentes. As cadeias de caracteres de entrada devem ter o mesmo comprimento e a comparação diferencia maiúsculas de minúsculas.

Sintaxe	hamming_distance(string1, string2)
Argumentos	string1 - a string string2 - a string
Exemplos	hamming_distance('abc','xec') → 2 hamming_distance('abc','ABc') → 2 hamming_distance(upper('abc'),upper('ABC')) → 0 hamming_distance('abc','abcd') → NULL

12.2.11.2. levenshtein

Retorna a distância de edição Levenshtein entre duas cadeias. Isso equivale ao número mínimo de edições de caracteres (inserções, exclusões ou substituições) necessárias para alterar uma cadeia para outra.

A distância Levenshtein é uma medida da semelhança entre duas astrings. Distâncias menores significam que as string são mais semelhantes, e distâncias maiores indicam mais strings diferentes. A distância diferencia maiúsculas de minúsculas.

Sintaxe	levenshtein(cadeia1, cadeia2)
Argumentos	string1 - a string string2 - a string
Exemplos	levenshtein('kittens','mitten') → 2 levenshtein('Kitten','kitten') → 1 levenshtein(upper('Kitten'),upper('kitten')) → 0

12.2.11.3. longest_common_substring

Retorna a sub string comum mais longa entre duas strings. Essa sub string é a cadeia mais longa que é uma sub string das duas strings de entrada. Por exemplo, a sub string comum mais longa de “ABABC” e “BABCA” é “BABC”. A substring faz distinção entre maiúsculas e minúsculas.

Sintaxe	longest_common_substring(string1, string2)
Argumentos	string1 - a string string2 - a string
Exemplos	longest_common_substring('ABABC','BABCA') → ‘BABC’ longest_common_substring('abcDeF','abcdef') → ‘abc’ longest_common_substring(upper('abcDeF'),upper('abcdex')) → ‘ABCDE’

12.2.11.4. soundex

Retorna a representação Soundex de uma string. Soundex é um algoritmo de correspondência fonética, portanto, strings com sons semelhantes devem ser representadas pelo mesmo código Soundex.

Sintaxe	soundex(string)
Argumentos	string - a string
Exemplos	soundex('robert') → ‘R163’ soundex('rupert') → ‘R163’ soundex('rubin') → ‘R150’

12.2.12. Funções Gerais

Este grupo contém funções gerais variadas.

12.2.12.1. env

Obtém uma variável de ambiente e retorna seu conteúdo como uma string. Se a variável não for encontrada, NULL será retornado. Isso é útil para injetar configurações específicas do sistema, como letras de unidade ou prefixos de caminho. A definição de variáveis de ambiente depende do sistema operacional, verifique com o administrador do sistema ou a documentação do sistema operacional como isso pode ser definido.

Sintaxe	env(name)
Argumentos	name - O nome da variável de ambiente que deve ser recuperada.
Exemplos	env( 'LANG' ) → ‘en_US.UTF-8’ env( 'MY_OWN_PREFIX_VAR' ) → ‘Z:’ env( 'I_DO_NOT_EXIST' ) → NULL

12.2.12.2. eval

Avalia uma expressão que é passada em uma string. Útil para expandir parâmetros dinâmicos passados ​​como campos ou variáveis ​​de contexto.

Sintaxe	eval(expression)
Argumentos	expression - uma string de expressão
Exemplos	eval('\'nice\'') → ‘nice’ eval(@expression_var) → [qualquer que seja o resultado da avaliação de @expression_var…]

12.2.12.3. eval_template

Avalia um modelo que é passado em uma string. Útil para expandir parâmetros dinâmicos passados como variáveis de contexto ou campos.

Sintaxe	eval_template(template)
Argumentos	template - uma string modelo
Exemplos	eval_template('QGIS [% upper(\'rocks\') %]') → QGIS ROCKS

12.2.12.4. is_layer_visible

Retorna verdadeiro se uma camada especificada estiver visível.

Sintaxe	is_layer_visible(layer)
Argumentos	layer - uma string, representando um nome de camada ou um ID de camada
Exemplos	is_layer_visible('baseraster') → True

12.2.12.5. mime_type

Retorna o mime type dos dados binários.

Sintaxe	mime_type(bytes)
Argumentos	bytes - os dados binários
Exemplos	mime_type('<html><body></body></html>') → text/html mime_type(from_base64('R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAIAOw==')) → image/gif

12.2.12.6. var

Retorna o valor armazenado em uma variável especificada.

Sintaxe	var(nome)
Argumentos	name - um nome de variável
Exemplos	var('qgis_version') → ‘2.12’

Leitura adicional: Lista de variáveis padrão

12.2.12.7. with_variable

Esta função define uma variável para qualquer código de expressão que será fornecido como 3º argumento. Isso só é útil para expressões complicadas, onde o mesmo valor calculado precisa ser usado em lugares diferentes.

Sintaxe	with_variable(name, value, expression)
Argumentos	name - o nome da variável a ser definida value - o valor a ser definido expression - a expressão para a qual a variável estará disponível
Exemplos	with_variable('my_sum', 1 + 2 + 3, @my_sum * 2 + @my_sum * 5) → 42

12.2.13. Funções de Geometria

Este grupo contém funções que operam em objetos de geometria (por exemplo, buffer, transform, $area).

12.2.13.1. affine_transform

Retorna a geometria após uma transformação afim. Os cálculos estão no Sistema de Referência Espacial desta geometria. As operações são realizadas em escala, rotação, ordem de translação. Se houver um deslocamento Z ou M, mas a coordenada não estiver presente na geometria, ela será adicionada.

Sintaxe	affine_transform(geometry, delta_x, delta_y, rotation_z, scale_x, scale_y, [delta_z=0], [delta_m=0], [scale_z=1], [scale_m=1]) [] indica argumentos opcionais
Argumentos	geometry - uma geometria delta_x - tradução do eixo x delta_y - tradução do eixo y rotation_z - rotação em torno do eixo z em graus no sentido anti-horário scale_x - fator de escala do eixo x scale_y - fator de escala do eixo y delta_z - tradução do eixo z delta_m - tradução do eixo m scale_z - fator de escala do eixo z scale_m - fator de escala do eixo m
Exemplos	geom_to_wkt(affine_transform(geom_from_wkt('LINESTRING(1 1, 2 2)'), 2, 2, 0, 1, 1)) → ‘LineString (3 3, 4 4)’ geom_to_wkt(affine_transform(geom_from_wkt('POLYGON((0 0, 0 3, 2 2, 0 0))'), 0, 0, -90, 1, 2)) → ‘Polygon ((0 0, 6 0, 4 -2, 0 0))’ geom_to_wkt(affine_transform(geom_from_wkt('POINT(3 1)'), 0, 0, 0, 1, 1, 5, 0)) → ‘PointZ (3 1 5)’

12.2.13.2. angle_at_vertex

Retorna o ângulo da bissetriz (ângulo médio) para a geometria de um vértice especificado em uma geometria de linha. Os ângulos estão em graus no sentido horário a partir do norte.

Sintaxe	angle_at_vertex(geometry, vertex)
Argumentos	geometry - Uma geometria de linha vertex - índice do vértice, a partir de 0; se o valor for negativo, o índice do vértice selecionado será sua contagem total menos o valor absoluto
Exemplos	angle_at_vertex(geometry:=geom_from_wkt('LineString(0 0, 10 0, 10 10)'),vertex:=1) → 45.0

12.2.13.3. $area

Retorna a área do recurso atual. A área calculada por esta função respeita tanto a configuração do elipsóide do projeto atual quanto as configurações da unidade de área. Por exemplo, se um elipsóide foi definido para o projeto, a área calculada será elipsoidal, e se nenhum elipsóide for definido, a área calculada será planimétrica.

Sintaxe	$area
Exemplos	$area → 42

12.2.13.4. area

Retorna a área de um objeto de geometria polígono. Os cálculos são sempre planimétricos no Sistema de Referência Espacial (SRS) dessa geometria, e as unidades da área retornada corresponderão às unidades do SRS. Isso difere dos cálculos realizados pela função $area, que realizará cálculos elipsoidais com base nas configurações de elipsóide e unidade de área do projeto.

Sintaxe	area(geometry)
Argumentos	geometry - objeto de geometria de polígono
Exemplos	area(geom_from_wkt('POLYGON((0 0, 4 0, 4 2, 0 2, 0 0))')) → 8.0

12.2.13.5. azimuth

Retorna o azimute baseado no norte como o ângulo em radianos medido no sentido horário da vertical em point_a a point_b.

Sintaxe	azimuth(point_a, point_b)
Argumentos	point_a - geometria de ponto point_b - geometria de ponto
Exemplos	degrees( azimuth( make_point(25, 45), make_point(75, 100) ) ) → 42.273689 degrees( azimuth( make_point(75, 100), make_point(25,45) ) ) → 222.273689

12.2.13.6. boundary

Retorna o fechamento do limite combinatório da geometria (ou seja, o limite topológico da geometria). Por exemplo, uma geometria de polígono terá um limite que consiste nas cadeias de linhas para cada anel no polígono. Alguns tipos de geometria não têm um limite definido, por exemplo, pontos ou coleções de geometria, e retornarão NULO.

Sintaxe	boundary(geometry)
Argumentos	geometry - uma geometria
Exemplos	geom_to_wkt(boundary(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))'))) → ‘LineString(1 1,0 0,-1 1,1 1)’ geom_to_wkt(boundary(geom_from_wkt('LineString(1 1,0 0,-1 1)'))) → ‘MultiPoint ((1 1),(-1 1))’

Leitura adicional: algoritmo Limite

12.2.13.7. bounds

Retorna uma geometria que representa a caixa delimitadora de uma geometria de entrada. Os cálculos estão no Sistema de Referência Espacial desta geometria.

Sintaxe	bounds(geometry)
Argumentos	geometry - uma geometria
Exemplos	bounds($geometry) → caixa delimitadora da geometria da feição atual geom_to_wkt(bounds(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))'))) → ‘Polygon ((-1 0, 1 0, 1 1, -1 1, -1 0))’

Fig. 12.4 As linhas pretas representam as caixas delimitadoras de cada feição do polígono

Leitura adicional: Caixas delimitadoras. algorithm

12.2.13.8. bounds_height

Retorna a altura do rentângulo envolvente de uma geometria. O cálculos são no Sistema de Referencia Espacial da geometria.

Sintaxe	bounds_height(geometry)
Argumentos	geometry - uma geometria
Exemplos	bounds_height($geometry) → altura do retângulo envolvente da geometria da feição atual bounds_height(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))')) → 1

12.2.13.9. bounds_width

Retorna a largura do retângulo envolvente de uma geometria. Os cálculos estão no Sistema de Referência Espacial desta geometria.

Sintaxe	bounds_width(geometry)
Argumentos	geometry - uma geometria
Exemplos	bounds_width($geometry) → largura do retângulo envolvente da geometria da feição atual bounds_width(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))')) → 2

12.2.13.10. buffer

Retorna uma geometria que representa todos os pontos cuja distância dessa geometria é menor ou igual à distância. Os cálculos estão no Sistema de Referência Espacial desta geometria.

Sintaxe	buffer(geometry, distance, [segments=8], [cap=’round’], [join=’round’], [miter_limit=2]) [] indica argumentos opcionais
Argumentos	geometry - uma geometria distance - distância do buffer em unidades de camada segments - número de segmentos a serem usados para representar um quarto de círculo quando um estilo de junção arredondada é usado. Um número maior resulta em um buffer mais suave com mais nós. cap - estilo do end cap style do buffer. Valores válidos são ‘round’, ‘flat’ ou ‘square’ join - estilo da junção do buffer. Valores válidos são ‘round’, ‘bevel’ ou ‘miter’. miter_limit - distância limite do miter, para ser utilizado quando o estilo de junção for configurado para ‘miter’
Exemplos	buffer($geometry, 10.5) → polígono da geometria da feição atual com buffer de 10.5 unidades

Fig. 12.5 Buffer (em amarelo) de pontos, linha e polígono

Leitura adicional: Buffer algorithm

12.2.13.11. buffer_by_m

Cria um buffer ao longo de uma geometria de linha onde o diâmetro do buffer varia de acordo com os valores m nos vértices da linha.

Sintaxe	buffer_by_m(geometry, [segments=8]) [] indica argumentos opcionais
Argumentos	geometry - geometria de entrada. Deve ser uma geometria de (multi)linha com valores m. segments - número de segmentos para aproximar as curvas de um quarto de círculo no buffer.
Exemplos	buffer_by_m(geometry:=geom_from_wkt('LINESTRINGM(1 2 0.5, 4 2 0.2)'),segments:=8) → Um buffer de largura variável começando com um diâmetro de 0,5 e terminando com um diâmetro de 0,2 ao longo da geometria da linha

Fig. 12.6 Buffer nas feições de linha usando o valor m nos vértices

Leitura adicional: Buffer de largura variável (por valor M) algorithm

12.2.13.12. centroid

Retorna o centro geométrico de uma geometria.

Sintaxe	centroid(geometry)
Argumentos	geometry - uma geometria
Exemplos	centroid($geometry) → uma geometria de ponto

Leitura adicional: Centroides algorithm

12.2.13.13. close_line

Retorna uma linha fechada da linha de entrada anexando o primeiro ponto ao final da linha, se ainda não estiver fechada. Se a geometria não for uma sequência de linhas ou sequência de várias linhas, o resultado será NULL.

Sintaxe	close_line(geometry)
Argumentos	geometry - uma geometria de linha
Exemplos	geom_to_wkt(close_line(geom_from_wkt('LINESTRING(0 0, 1 0, 1 1)'))) → ‘LineString (0 0, 1 0, 1 1, 0 0)’ geom_to_wkt(close_line(geom_from_wkt('LINESTRING(0 0, 1 0, 1 1, 0 0)'))) → ‘LineString (0 0, 1 0, 1 1, 0 0)’

12.2.13.14. closest_point

Retorna o ponto em geometria1 que está mais próximo de geometria2.

Sintaxe	closest_point(geometry1, geometry2)
Argumentos	geometry1 - geometria para encontrar o ponto mais próximo em geometry2 - geometria para encontrar o ponto mais próximo de
Exemplos	geom_to_wkt(closest_point(geom_from_wkt('LINESTRING (20 80, 98 190, 110 180, 50 75 )'),geom_from_wkt('POINT(100 100)'))) → ‘Point(73.0769 115.384)’

12.2.13.15. collect_geometries

Coleta uma série de geometrias em um objeto de geometria multi parte.

Lista de variantes de argumentos

As partes geométricas são especificadas como argumentos separados para a função.

Sintaxe	collect_geometries(geometry1, geometry2, …)
Argumentos	geometry - uma geometria
Exemplos	geom_to_wkt(collect_geometries(make_point(1,2), make_point(3,4), make_point(5,6))) → ‘MultiPoint ((1 2),(3 4),(5 6))’

Variante array

As partes de geometria são especificadas como um array de partes de geometria.

Sintaxe	collect_geometries(array)
Argumentos	array - array de objetos de geometria
Exemplos	geom_to_wkt(collect_geometries(array(make_point(1,2), make_point(3,4), make_point(5,6)))) → ‘MultiPoint ((1 2),(3 4),(5 6))’

Leitura adicional: Coletar geometrias algorithm

12.2.13.16. combine

Retorna a combinação de duas geometrias.

Sintaxe	combine(geometria1, geometria2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	geom_to_wkt( combine( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 2 1)' ) ) ) → ‘MULTILINESTRING((4 4, 2 1), (3 3, 4 4), (4 4, 5 5))’ geom_to_wkt( combine( geom_from_wkt( 'LINESTRING(3 3, 4 4)' ), geom_from_wkt( 'LINESTRING(3 3, 6 6, 2 1)' ) ) ) → ‘LINESTRING(3 3, 4 4, 6 6, 2 1)’

12.2.13.17. contains

Testa se uma geometria contém outra. Retorna true se e somente se nenhum ponto de geometry2 estiver no exterior de geometry1 e pelo menos um ponto do interior de geometry2 estiver no interior de geometry1.

Sintaxe	contains(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	contains( geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))' ), geom_from_wkt( 'POINT(0.5 0.5 )' ) ) → true contains( geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → false

Leitura adicional: overlay_contains

12.2.13.18. convex_hull

Retorna o convex hull de uma geometria. Ele representa a geometria convexa mínima que encerra todas as geometrias dentro do conjunto.

Sintaxe	convex_hull(geometry)
Argumentos	geometry - uma geometria
Exemplos	geom_to_wkt( convex_hull( geom_from_wkt( 'LINESTRING(3 3, 4 4, 4 10)' ) ) ) → ‘POLYGON((3 3, 4 10, 4 4, 3 3))’

Leitura adicional: Casco convexo. algorithm

12.2.13.19. crosses

Testa se uma geometria cruza outra. Retorna verdadeiro se as geometrias fornecidas tiverem alguns, mas não todos, pontos internos em comum.

Sintaxe	crosses(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	crosses( geom_from_wkt( 'LINESTRING(3 5, 4 4, 5 3)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → true crosses( geom_from_wkt( 'POINT(4 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → false

Leitura adicional: overlay_crosses

12.2.13.20. difference

Retorna uma geometria que representa a parte da geometria1 que não faz interseção com geometria2.

Sintaxe	difference(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	geom_to_wkt( difference( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4)' ) ) ) → ‘LINESTRING(4 4, 5 5)’

Leitura adicional: Diferença algorithm

12.2.13.21. disjoint

Testa se as geometrias não se cruzam espacialmente. Retorna verdadeiro se as geometrias não compartilharem nenhum espaço.

Sintaxe	disjoint(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	disjoint( geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0 ))' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → true disjoint( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'POINT(4 4)' )) → false

Leitura adicional: overlay_disjoint

12.2.13.22. distance

Retorna a distância mínima (com base na referência espacial) entre duas geometrias em unidades projetadas.

Sintaxe	distance(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	distance( geom_from_wkt( 'POINT(4 4)' ), geom_from_wkt( 'POINT(4 8)' ) ) → 4

12.2.13.23. distance_to_vertex

Retorna a distância ao longo da geometria para um vértice especificado.

Sintaxe	distance_to_vertex(geometry, vertex)
Argumentos	geometry - Uma geometria de linha vertex - índice do vértice, a partir de 0; se o valor for negativo, o índice do vértice selecionado será sua contagem total menos o valor absoluto
Exemplos	distance_to_vertex(geometry:=geom_from_wkt('LineString(0 0, 10 0, 10 10)'),vertex:=1) → 10.0

12.2.13.24. end_point

Retorna o último nó de uma geometria.

Sintaxe	end_point(geometry)
Argumentos	geometry - objeto geométrico
Exemplos	geom_to_wkt(end_point(geom_from_wkt('LINESTRING(4 0, 4 2, 0 2)'))) → ‘Point (0 2)’

Leitura adicional: Extrair vértices específicos algorithm

12.2.13.25. exif_geotag

Cria uma geometria de pontos a partir da geotag do exif de um arquivo de imagem.

Sintaxe	exif_geotag(path)
Argumentos	path - Um caminho de image.
Exemplos	geom_to_wkt(exif_geotag('/my/photo.jpg')) → ‘Point (2 4)’

12.2.13.26. extend

Estende o início e o fim de uma geometria de linha em um valor especificado. As linhas são estendidas usando o rumo do primeiro e do último segmento da linha. Para uma multi linha, todas as partes são estendidas. As distâncias estão no Sistema de Referência Espacial desta geometria.

Sintaxe	extend(geometry, start_distance, end_distance)
Argumentos	geometry - uma geometria (multi) linha start_distance - distancia para extender o inicio da linha end_distance - distancia para extender o final da linha
Exemplos	geom_to_wkt(extend(geom_from_wkt('LineString(0 0, 1 0, 1 1)'),1,2)) → ‘LineString (-1 0, 1 0, 1 3)’ geom_to_wkt(extend(geom_from_wkt('MultiLineString((0 0, 1 0, 1 1), (2 2, 0 2, 0 5))'),1,2)) → ‘MultiLineString ((-1 0, 1 0, 1 3),(3 2, 0 2, 0 7))’

Leitura adicional: Linhas estendidas. algorithm

12.2.13.27. exterior_ring

Retorna uma linha representando o anél exterior de uma geometria do tipo polígono. Se a geometria não for um polígono o resultado será NULL.

Sintaxe	exterior_ring(geometry)
Argumentos	geometry - uma geometria de polígono
Exemplos	geom_to_wkt(exterior_ring(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1),( 0.1 0.1, 0.1 0.2, 0.2 0.2, 0.2, 0.1, 0.1 0.1))'))) → ‘LineString (-1 -1, 4 0, 4 2, 0 2, -1 -1)’

12.2.13.28. extrude

Retorna uma versão extrudada da geometria de entrada (Multi-)Curve ou (Multi-)Linha com uma extensão especificada por x e y.

Sintaxe	extrude(geometry, x, y)
Argumentos	geometry - uma geometria curva ou linha x - extensão x, valor numérico y - extensão y, valor numérico
Exemplos	geom_to_wkt(extrude(geom_from_wkt('LineString(1 2, 3 2, 4 3)'), 1, 2)) → ‘Polygon ((1 2, 3 2, 4 3, 5 5, 4 4, 2 4, 1 2))’ geom_to_wkt(extrude(geom_from_wkt('MultiLineString((1 2, 3 2), (4 3, 8 3))'), 1, 2)) → ‘MultiPolygon (((1 2, 3 2, 4 4, 2 4, 1 2)),((4 3, 8 3, 9 5, 5 5, 4 3)))’

12.2.13.29. flip_coordinates

Retorna uma cópia da geometria com as coordenadas x e y trocadas. Útil para reparar geometrias que tiveram seus valores de latitude e longitude invertidos.

Sintaxe	flip_coordinates(geometry)
Argumentos	geometry - uma geometria
Exemplos	geom_to_wkt(flip_coordinates(make_point(1, 2))) → ‘Point (2 1)’

Leitura adicional: Trocar as coordenadas X e Y algorithm

12.2.13.30. force_rhr

Força uma geometria a respeitar a Regra da Mão Direita, na qual a área limitada por um polígono está à direita do limite. Em particular, o anel externo é orientado no sentido horário e os anéis internos no sentido anti-horário.

Sintaxe	force_rhr(geometry)
Argumentos	geometry - Uma geometria. Qualquer geometria que não for polígono são retornadas sem modificações.
Exemplos	geom_to_wkt(force_rhr(geometry:=geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1))'))) → ‘Polygon ((-1 -1, 0 2, 4 2, 4 0, -1 -1))’

Leitura adicional: Regra de força da mão direita. algorithm

12.2.13.31. geom_from_gml

Retorna uma geometria a partir de uma representação GML de geometria.

Sintaxe	geom_from_gml(gml)
Argumentos	gml - string representando a geometira em GML
Exemplos	geom_from_gml('<gml:LineString srsName="EPSG:4326"><gml:coordinates>4,4 5,5 6,6</gml:coordinates></gml:LineString>') → um objeto de geometria de linha

12.2.13.32. geom_from_wkb

Retorna uma geometria criada a apartir de um uma representação Well-Known Binary (WKB).

Sintaxe	geom_from_wkb(binary)
Argumentos	binary - Representação Well-Known Binary (WKB) de uma geometria (como um binário blob)
Exemplos	geom_from_wkb( geom_to_wkb( make_point(4,5) ) ) → um objeto de geomeria ponto

12.2.13.33. geom_from_wkt

Retorna uma geometria criada a partir de uma representação Well-Known Text (WKT - Texto Bem Conhecido)

Sintaxe	geom_from_wkt(text)
Argumentos	text - Representação de uma geometria em Well-Known Text (WKT)
Exemplos	geom_from_wkt( 'POINT(4 5)' ) → um objeto de geometria

12.2.13.34. geom_to_wkb

Retorna uma representação Well-known Binarye(WKB - Binário Bem Conhecido) da geometria

Sintaxe	geom_to_wkb(geometry)
Argumentos	geometry - uma geometria
Exemplos	geom_to_wkb( $geometry ) → binário blob contendo o objeto da geometria

12.2.13.35. geom_to_wkt

Retorna a representação Well-Know Text (WKT - Texto Bem Conhecido) da geometria sem o metadado do SRID.

Sintaxe	geom_to_wkt(geometry, [precision=8]) [] indica argumentos opcionais
Argumentos	geometry - uma geometria precision - precisão numérica
Exemplos	geom_to_wkt( make_point(6, 50) ) → ‘POINT(6 50)’ geom_to_wkt(centroid(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))'))) → ‘POINT(0 0.66666667)’ geom_to_wkt(centroid(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))')), 2) → ‘POINT(0 0.67)’

12.2.13.36. $geometry

Retorna a geometria da feição atual. Pode ser usado para processamento com outras funções.

Sintaxe	$geometry
Exemplos	geom_to_wkt( $geometry ) → ‘POINT(6 50)’

12.2.13.37. geometry

Retorna a geometria de uma feição.

Sintaxe	geometry(feature)
Argumentos	feature - um objeto feição
Exemplos	`` geometry( $currentfeature )`` → geometria da feição atual. Prefira usar $geometry. geom_to_wkt( geometry( get_feature_by_id( 'streets', 1 ) ) ) → a geometria em WKT ta feição de id 1 da camada “streets”, ex. ‘POINT(6 50)’ intersects( $geometry, geometry( get_feature( 'streets', 'name', 'Main St.' ) ) ) → verdadeiro se a feição atual possui intersessão espacialmente a feição de nome ‘Main St.’ na camada “streets”

12.2.13.38. geometry_n

Retorna uma geometria específica de uma coleção de geometrias ou NULO se a geometria de entrada não for uma coleção.

Sintaxe	geometry_n(geometry, index)
Argumentos	geometry - coleção de geometria index - indice da geometria a ser retornada, onde 1 é a primeira geometria na coleção
Exemplos	geom_to_wkt(geometry_n(geom_from_wkt('GEOMETRYCOLLECTION(POINT(0 1), POINT(0 0), POINT(1 0), POINT(1 1))'),3)) → ‘Point (1 0)’

12.2.13.39. geometry_type

Retorna uma valor em texto descrevendo o tipo de uma geometria (Point, Line ou Polygon)

Sintaxe	geometry_type(geometry)
Argumentos	geometry - uma geometria
Exemplos	geometry_type( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → ‘Line’ geometry_type( geom_from_wkt( 'MULTILINESTRING((2 5, 3 6, 4 8), (1 1, 0 0))') ) → ‘Line’ geometry_type( geom_from_wkt( 'POINT(2 5)') ) → ‘Point’ geometry_type( geom_from_wkt( 'POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1))') ) → ‘Polygon’

12.2.13.40. hausdorff_distance

Retorna a distância de Hausdorff entre duas geometrias. Este é básicamente a medição de quão similar ou diferentes duas geometrias são, quanto menor a distancia mais similares são as geometrias.

A função pode ser executada com um argumento opcional de fração densificar. Se não for especificado, é usada uma aproximação da distância padrão de Hausdorff. Essa aproximação é exata ou próxima o suficiente para um grande subconjunto de casos úteis. Exemplos destes são:

• distância computada entre Linestrings que são aproximadamente paralelas umas às outras e aproximadamente iguais em comprimento. Isso ocorre em redes lineares correspondentes.

• Teste de similaridade de geometrias.

Se a aproximação padrão fornecida por este método for insuficiente, especifique o argumento opcional de densificar fração. Especificar este argumento realiza uma densificação do segmento antes de calcular a distância discreta de Hausdorff. O parâmetro define a fração para densificar cada segmento. Cada segmento será dividido em vários subsegmentos de igual comprimento, cuja fração do comprimento total é a mais próxima da fração dada. Diminuir o parâmetro fração densificar fará com que a distância retornada se aproxime da verdadeira distância de Hausdorff para as geometrias.

Sintaxe	hausdorff_distance(geometry1, geometry2, [densify_fraction]) [] indica argumentos opcionais
Argumentos	geometry1 - uma geometria geometry2 - uma geometria densify_fraction - densificar quantidade de fração
Exemplos	hausdorff_distance( geometry1:= geom_from_wkt('LINESTRING (0 0, 2 1)'),geometry2:=geom_from_wkt('LINESTRING (0 0, 2 0)')) → 2 hausdorff_distance( geom_from_wkt('LINESTRING (130 0, 0 0, 0 150)'),geom_from_wkt('LINESTRING (10 10, 10 150, 130 10)')) → 14.142135623 hausdorff_distance( geom_from_wkt('LINESTRING (130 0, 0 0, 0 150)'),geom_from_wkt('LINESTRING (10 10, 10 150, 130 10)'),0.5) → 70.0

12.2.13.41. inclination

Retorna a inclinação medida do zênite (0) ao nadir (180) no point_a ao point_b.

Sintaxe	inclinação(ponto_a, ponto_b)
Argumentos	point_a - geometria de ponto point_b - geometria de ponto
Exemplos	inclination( make_point( 5, 10, 0 ), make_point( 5, 10, 5 ) ) → 0.0 inclination( make_point( 5, 10, 0 ), make_point( 5, 10, 0 ) ) → 90.0 inclination( make_point( 5, 10, 0 ), make_point( 50, 100, 0 ) ) → 90.0 inclination( make_point( 5, 10, 0 ), make_point( 5, 10, -5 ) ) → 180.0

12.2.13.42. interior_ring_n

Retorna um anél interior específico de uma geometria polígono, ou NULL se a geometria não for polígono.

Sintaxe	interior_ring_n(geometry, index)
Argumentos	geometry - geometria do polígono index - índice do interior a ser retornado, onde 1 é o primeiro anél interior
Exemplos	geom_to_wkt(interior_ring_n(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1),(-0.1 -0.1, 0.4 0, 0.4 0.2, 0 0.2, -0.1 -0.1),(-1 -1, 4 0, 4 2, 0 2, -1 -1))'),1)) → ‘LineString (-0.1 -0.1, 0.4 0, 0.4 0.2, 0 0.2, -0.1 -0.1))’

12.2.13.43. intersection

Retorna uma geometria que representa a porção compartilhada de duas geometrias.

Sintaxe	intersection(geometria1, geometria2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	geom_to_wkt( intersection( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4)' ) ) ) → ‘LINESTRING(3 3, 4 4)’ geom_to_wkt( intersection( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'MULTIPOINT(3.5 3.5, 4 5)' ) ) ) → ‘POINT(3.5 3.5)’

Leitura adicional: Interseção algorithm

12.2.13.44. intersects

Testa quando a geometria interseciona outra. Retorna verdadeiro se as geometrias espacialmente intercessionam (compartilham alguma porção do espaço) e falso quando não compartilham.

Sintaxe	intersects(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	intersects( geom_from_wkt( 'POINT(4 4)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → true intersects( geom_from_wkt( 'POINT(4 5)' ), geom_from_wkt( 'POINT(5 5)' ) ) → false

Leitura adicional: overlay_intersects

12.2.13.45. intersects_bbox

Testa quando o retangulo envolvente de uma geometria sobrepõe outro retângulo envolvente. Retorna verdadeiro se as geometrias intercessionam espacialmente o retângulo envolvente definido, ou falso se eles não.

Sintaxe	intersects_bbox(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	intersects_bbox( geom_from_wkt( 'POINT(4 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → true intersects_bbox( geom_from_wkt( 'POINT(6 5)' ), geom_from_wkt( 'POLYGON((3 3, 4 4, 5 5, 3 3))' ) ) → false

12.2.13.46. is_closed

Retorna verdadeiro se uma linha está fechada (pontos inicial e final são coincidentes), ou falso se a linha não está fechada. Se a geometria não for uma linha o resultado será NULL.

Sintaxe	is_closed(geometry)
Argumentos	geometry - uma geometria de linha
Exemplos	is_closed(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)')) → false is_closed(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2, 0 0)')) → true

12.2.13.47. is_empty

Retorna verdadeiro se uma geometria estiver vazia (sem coordenadas), falso se a geometria não estiver vazia e NULO se não houver geometria. Consulte também está_vazio_ou_nulo.

Sintaxe	is_empty(geometry)
Argumentos	geometry - uma geometria
Exemplos	is_empty(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)')) → false is_empty(geom_from_wkt('LINESTRING EMPTY')) → true is_empty(geom_from_wkt('POINT(7 4)')) → false is_empty(geom_from_wkt('POINT EMPTY')) → true

12.2.13.48. is_empty_or_null

Retorna verdadeiro se uma geometria é NULL ou vazia ( sem coordenadas) ou falso em outro caso. Esta função é como a expressão ‘$geometry IS NULL ou is_enpty($geometry)’

Sintaxe	is_empty_or_null(geometry)
Argumentos	geometry - uma geometria
Exemplos	is_empty_or_null(NULL) → true is_empty_or_null(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)')) → false is_empty_or_null(geom_from_wkt('LINESTRING EMPTY')) → true is_empty_or_null(geom_from_wkt('POINT(7 4)')) → false is_empty_or_null(geom_from_wkt('POINT EMPTY')) → true

12.2.13.49. is_multipart

Retorna verdadeiro se a geometria for do tipo Multi.

Sintaxe	is_multipart(geometry)
Argumentos	geometry - uma geometria
Exemplos	is_multipart(geom_from_wkt('MULTIPOINT ((0 0),(1 1),(2 2))')) → true is_multipart(geom_from_wkt('POINT (0 0)')) → false

12.2.13.50. is_valid

Retorna verdadeiro se uma geometria for válida; se for bem formado em 2D de acordo com as regras da OGC.

Sintaxe	is_valid(geometry)
Argumentos	geometry - uma geometria
Exemplos	is_valid(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2, 0 0)')) → true is_valid(geom_from_wkt('LINESTRING(0 0)')) → false

12.2.13.51. $length

Retorna o comprimento de uma linha. Se você precisar do comprimento da borda de um polígono, use $perimeter. O comprimento calculado por esta função respeita tanto a configuração do elipsóide do projeto atual quanto as configurações da unidade de distância. Por exemplo, se um elipsóide foi definido para o projeto, o comprimento calculado será elipsoidal, e se nenhum elipsóide for definido, o comprimento calculado será planimétrico.

Sintaxe	$length
Exemplos	$comprimento → 42.4711

12.2.13.52. length

Retorna o número de caracteres em uma string ou o tamanho de uma geometria linha.

Variante string

Retorna o número de caracteres em uma string.

Sintaxe	length(string)
Argumentos	string - string para contar o comprimento de
Exemplos	length('hello') → 5

Variante geometria

Calcule o comprimento de um objeto de geometria linha. Os cálculos são sempre planimétricos no Sistema de Referência Espacial (SRS) dessa geometria, e as unidades do comprimento retornado corresponderão às unidades do SRS. Isso difere dos cálculos realizados pela função $length, que realizará cálculos elipsoidais com base nas configurações de elipsóide e unidade de distância do projeto.

Sintaxe	length(geometry)
Argumentos	geometry - objeto de geometria linha
Exemplos	length(geom_from_wkt('LINESTRING(0 0, 4 0)')) → 4.0

Leitura adicional: straight_distance_2d

12.2.13.53. length3D

Calcule o comprimento de um objeto de linha geométrica. Os cálculos são sempre planimétricos no Sistema de Referência Espacial (SRS) dessa geometria, e as unidades do comprimento retornado corresponderão às unidades do SRS. Isso difere dos cálculos realizados pela função $length, que realizará cálculos elipsoidais com base nas configurações de elipsóide e unidade de distância do projeto.

Sintaxe	length3D(geometry)
Argumentos	geometry - objeto de geometria linha
Exemplos	length3D(geom_from_wkt('LINESTRINGZ(0 0 0, 3 0 4)')) → 5.0

12.2.13.54. line_interpolate_angle

Retorna o ângulo paralelo à geometria a uma distância especificada ao longo de uma geometria de linhas. Os ângulos estão em graus no sentido horário do norte.

Sintaxe	line_interpolate_angle(geometry, distance)
Argumentos	geometry - Uma geometria de linha distance - distância ao longo da linha para interpolar
Exemplos	line_interpolate_angle(geometry:=geom_from_wkt('LineString(0 0, 10 0)'),distance:=5) → 90.0

12.2.13.55. line_interpolate_point

Retorna o ponto interpolado por uma distância específica ao longo de uma geometria de linha.

Sintaxe	line_interpolate_point(geometry, distance)
Argumentos	geometry - Uma geometria de linha distance - distância ao longo da linha para interpolar
Exemplos	geom_to_wkt(line_interpolate_point(geometry:=geom_from_wkt('LineString(0 0, 10 0)'),distance:=5)) → ‘Point (5 0)’

Leitura adicional: Interpolar ponto na linha algorithm

12.2.13.56. line_locate_point

Retorna a distância ao longo de uma linha correspondente à posição mais próxima da linha a uma geometria de ponto especificada.

Sintaxe	line_locate_point(geometry, point)
Argumentos	geometry - Uma geometria de linha point - geometria do ponto para localizar a posição mais próxima na cadeia de linhas para
Exemplos	line_locate_point(geometry:=geom_from_wkt('LineString(0 0, 10 0)'),point:=geom_from_wkt('Point(5 0)')) → 5.0

12.2.13.57. line_merge

Retorna uma geometria LineString ou MultiLineString, em que quaisquer LineStrings conectadas da geometria de entrada foram mescladas em uma única cadeia de linhas. Esta função retornará NULL se passar uma geometria que não seja uma LineString/MultiLineString.

Sintaxe	line_merge(geometry)
Argumentos	geometry - uma geometria LineString/MultiLineString
Exemplos	geom_to_wkt(line_merge(geom_from_wkt('MULTILINESTRING((0 0, 1 1),(1 1, 2 2))'))) → ‘LineString(0 0,1 1,2 2)’ geom_to_wkt(line_merge(geom_from_wkt('MULTILINESTRING((0 0, 1 1),(11 1, 21 2))'))) → ‘MultiLineString((0 0, 1 1),(11 1, 21 2)’

12.2.13.58. line_substring

Retorna a parte de uma geometria de linha (ou curva) que fica entre as distâncias inicial e final especificadas (medidas a partir do início da linha). Os valores Z e M são interpolados linearmente a partir dos valores existentes.

Sintaxe	line_substring(geometry, start_distance, end_distance)
Argumentos	geometry - uma geometria de linha ou curva start_distance - distância de inicio da sub linha end_distance - distância para o fim da sub linha
Exemplos	geom_to_wkt(line_substring(geometry:=geom_from_wkt('LineString(0 0, 10 0)'),start_distance:=2,end_distance:=6)) → ‘LineString (2 0,6 0)’

Leitura adicional: Linha de substring. algorithm

12.2.13.59. m

Retorna o valor m de uma geometria de ponto.

Sintaxe	m(geometry)
Argumentos	geometry - uma geometria de ponto
Exemplos	m( geom_from_wkt( 'POINTM(2 5 4)' ) ) → 4

12.2.13.60. m_max

Retorna o valor máximo de m (medida) de uma geometria.

Sintaxe	m_max(geometry)
Argumentos	geometry - uma geometria contendo valores m
Exemplos	m_max( make_point_m( 0,0,1 ) ) → 1 m_max(make_line( make_point_m( 0,0,1 ), make_point_m( -1,-1,2 ), make_point_m( -2,-2,0 ) ) ) → 2

12.2.13.61. m_min

Retorna o valor mínimo de m (medida) de uma geometria.

Sintaxe	m_min(geometry)
Argumentos	geometry - uma geometria contendo valores m
Exemplos	m_min( make_point_m( 0,0,1 ) ) → 1 m_min(make_line( make_point_m( 0,0,1 ), make_point_m( -1,-1,2 ), make_point_m( -2,-2,0 ) ) ) → 0

12.2.13.62. main_angle

Retorna o ângulo do eixo longo (no sentido horário, em graus a partir do Norte) do retângulo envolvente mínimo orientado, que cobre completamente a geometria.

Sintaxe	main_angle(geometry)
Argumentos	geometry - uma geometria
Exemplos	main_angle(geom_from_wkt('Polygon ((321577 129614, 321581 129618, 321585 129615, 321581 129610, 321577 129614))')) → 38.66

12.2.13.63. make_circle

Cria um polígono circular.

Sintaxe	make_circle(center, radius, [segments=36]) [] indica argumentos opcionais
Argumentos	center - ponto central do círculo radius - raio do círculo segments - argumento opcional para segmentação de polígonos. Por padrão esse valor é 36
Exemplos	geom_to_wkt(make_circle(make_point(10,10), 5, 4)) → ‘Polygon ((10 15, 15 10, 10 5, 5 10, 10 15))’ geom_to_wkt(make_circle(make_point(10,10,5), 5, 4)) → ‘PolygonZ ((10 15 5, 15 10 5, 10 5 5, 5 10 5, 10 15 5))’ geom_to_wkt(make_circle(make_point(10,10,5,30), 5, 4)) → ‘PolygonZM ((10 15 5 30, 15 10 5 30, 10 5 5 30, 5 10 5 30, 10 15 5 30))’

12.2.13.64. make_ellipse

Cria um polígono elíptico.

Sintaxe	make_ellipse(center, semi_major_axis, semi_minor_axis, azimuth, [segments=36]) [] indica argumentos opcionais
Argumentos	center - ponto central da elipse semi_major_axis - eixo semi maior da elipse semi_minor_axis - eixo semi menor da elipse azimuth - orientação da elipse segments - argumento opcional para segmentação de polígonos. Por padrão esse valor é 36
Exemplos	geom_to_wkt(make_ellipse(make_point(10,10), 5, 2, 90, 4)) → ‘Polygon ((15 10, 10 8, 5 10, 10 12, 15 10))’ geom_to_wkt(make_ellipse(make_point(10,10,5), 5, 2, 90, 4)) → ‘PolygonZ ((15 10 5, 10 8 5, 5 10 5, 10 12 5, 15 10 5))’ geom_to_wkt(make_ellipse(make_point(10,10,5,30), 5, 2, 90, 4)) → ‘PolygonZM ((15 10 5 30, 10 8 5 30, 5 10 5 30, 10 12 5 30, 15 10 5 30))’

12.2.13.65. make_line

Cria uma geometria de linha a partir de uma série de geometrias de ponto.

Lista de variantes de argumentos

Os vértices de linha são especificados como argumentos separados para a função.

Sintaxe	make_line(point1, point2, …)
Argumentos	point - uma geometria de ponto (ou array de pontos)
Exemplos	geom_to_wkt(make_line(make_point(2,4),make_point(3,5))) → ‘LineString (2 4, 3 5)’ geom_to_wkt(make_line(make_point(2,4),make_point(3,5),make_point(9,7))) → ‘LineString (2 4, 3 5, 9 7)’

Variante array

Os vértices de linha são especificados como um array de pontos.

Sintaxe	make_line(array)
Argumentos	array - array de pontos
Exemplos	geom_to_wkt(make_line(array(make_point(2,4),make_point(3,5),make_point(9,7)))) → ‘LineString (2 4, 3 5, 9 7)’

12.2.13.66. make_point

Cria uma geometria de ponto a partir de x e y (e valores z e m opcionais).

Sintaxe	make_point(x, y, [z], [m]) [] indica argumentos opcionais
Argumentos	x - coordenada x do ponto y - coordenada y do ponto z - coordenada z opcional do ponto m - valor m opcional do ponto
Exemplos	geom_to_wkt(make_point(2,4)) → ‘Point (2 4)’ geom_to_wkt(make_point(2,4,6)) → ‘PointZ (2 4 6)’ geom_to_wkt(make_point(2,4,6,8)) → ‘PointZM (2 4 6 8)’

12.2.13.67. make_point_m

Cria uma geometria de ponto a partir de uma coordenada x, y e um valor m.

Sintaxe	criar_ponto_m(x, y, m)
Argumentos	x - coordenada x do ponto y - coordenada y do ponto m - valor m do ponto
Exemplos	geom_to_wkt(make_point_m(2,4,6)) → ‘PointM (2 4 6)’

12.2.13.68. make_polygon

Cria uma geometria de polígono a partir de um anel externo e uma série opcional de geometrias de anel interno.

Sintaxe	make_polygon(outerRing, [innerRing1], [innerRing2], …) [] indica argumentos opcionais
Argumentos	outerRing - geometria linha fechada para o anel externo do polígono innerRing - linha fechada opcional para o anel interior
Exemplos	geom_to_wkt(make_polygon(geom_from_wkt('LINESTRING( 0 0, 0 1, 1 1, 1 0, 0 0 )'))) → ‘Polygon ((0 0, 0 1, 1 1, 1 0, 0 0))’ geom_to_wkt(make_polygon(geom_from_wkt('LINESTRING( 0 0, 0 1, 1 1, 1 0, 0 0 )'),geom_from_wkt('LINESTRING( 0.1 0.1, 0.1 0.2, 0.2 0.2, 0.2 0.1, 0.1 0.1 )'),geom_from_wkt('LINESTRING( 0.8 0.8, 0.8 0.9, 0.9 0.9, 0.9 0.8, 0.8 0.8 )'))) → ‘Polygon ((0 0, 0 1, 1 1, 1 0, 0 0),(0.1 0.1, 0.1 0.2, 0.2 0.2, 0.2 0.1, 0.1 0.1),(0.8 0.8, 0.8 0.9, 0.9 0.9, 0.9 0.8, 0.8 0.8))’

12.2.13.69. make_rectangle_3points

Cria um retângulo a partir de 3 pontos.

Sintaxe	make_rectangle_3points(point1, point2, point3, [option=0]) [] indica argumentos opcionais
Argumentos	point1 - Primeiro ponto. point2 - Segundo ponto. point3 - Terceiro ponto. option - Um argumento opcional para construir o retângulo. Por padrão este valor é 0. O valor pode ser 0 (distância) ou 1 (projetado). Opção distância: A segunda distância é igual à distância entre o 2º e o 3º ponto. Opção projetada: A segunda distância é igual à distância da projeção perpendicular do 3º ponto sobre o segmento ou sua extensão.
Exemplos	geom_to_wkt(make_rectangle_3points(make_point(0, 0), make_point(0,5), make_point(5, 5), 0)) → ‘Polygon ((0 0, 0 5, 5 5, 5 0, 0 0))’ geom_to_wkt(make_rectangle_3points(make_point(0, 0), make_point(0,5), make_point(5, 3), 1)) → ‘Polygon ((0 0, 0 5, 5 5, 5 0, 0 0))’

12.2.13.70. make_regular_polygon

Cria um polígono regular.

Sintaxe	make_regular_polygon(center, radius, number_sides, [circle=0]) [] indica argumentos opcionais
Argumentos	center - centro do polígono regular radius - segundo ponto. A primeira se o polígono regular estiver inscrito. O ponto médio do primeiro lado se o polígono regular for circunscrito. numero_lados - Número de lados/bordas do polígono regular circle - Argumento opcional para a construção do poligono regular. Por padrão o valor é 0. Valor pode ser 0 (inscrito) ou 1 (circunscrito)
Exemplos	geom_to_wkt(make_regular_polygon(make_point(0,0), make_point(0,5), 5)) → ‘Polygon ((0 5, 4.76 1.55, 2.94 -4.05, -2.94 -4.05, -4.76 1.55, 0 5))’ geom_to_wkt(make_regular_polygon(make_point(0,0), project(make_point(0,0), 4.0451, radians(36)), 5)) → ‘Polygon ((0 5, 4.76 1.55, 2.94 -4.05, -2.94 -4.05, -4.76 1.55, 0 5))’

12.2.13.71. make_square

Cria um quadrado a partir da diagonal.

Sintaxe	make_square(point1, point2)
Argumentos	point1 - Primeiro ponto da diagonal point2 - Último ponto da diagonal
Exemplos	geom_to_wkt(make_square( make_point(0,0), make_point(5,5))) → ‘Polygon ((0 0, -0 5, 5 5, 5 0, 0 0))’ geom_to_wkt(make_square( make_point(5,0), make_point(5,5))) → ‘Polygon ((5 0, 2.5 2.5, 5 5, 7.5 2.5, 5 0))’

12.2.13.72. make_triangle

Cria um polígono triangular.

Sintaxe	make_triangle(point1, point2, point3)
Argumentos	point1 - primeiro ponto do triângulo point2 - segundo ponto do triângulo point3 - terceiro ponto do triângulo
Exemplos	geom_to_wkt(make_triangle(make_point(0,0), make_point(5,5), make_point(0,10))) → ‘Triangle ((0 0, 5 5, 0 10, 0 0))’ geom_to_wkt(boundary(make_triangle(make_point(0,0), make_point(5,5), make_point(0,10)))) → ‘LineString (0 0, 5 5, 0 10, 0 0)’

12.2.13.73. minimal_circle

Retorna o círculo mínimo de uma geometria. Ele representa o círculo mínimo que envolve todas as geometrias dentro do conjunto.

Sintaxe	minimal_circle(geometry, [segments=36]) [] indica argumentos opcionais
Argumentos	geometry - uma geometria segments - argumento opcional para segmentação de polígonos. Por padrão esse valor é 36
Exemplos	geom_to_wkt( minimal_circle( geom_from_wkt( 'LINESTRING(0 5, 0 -5, 2 1)' ), 4 ) ) → ‘Polygon ((0 5, 5 -0, -0 -5, -5 0, 0 5))’ geom_to_wkt( minimal_circle( geom_from_wkt( 'MULTIPOINT(1 2, 3 4, 3 2)' ), 4 ) ) → ‘Polygon ((3 4, 3 2, 1 2, 1 4, 3 4))’

Leitura adicional: Círculos mínimos fechados. algorithm

12.2.13.74. nodes_to_points

Retorna uma geometria multiponto que consiste em cada nó na geometria de entrada.

Sintaxe	nodes_to_points(geometry, [ignore_closing_nodes=false]) [] indica argumentos opcionais
Argumentos	geometry - objeto geométrico ignore_closing_nodes - argumento opcional que especifica se deve incluir nós duplicados que fecham linhas ou anéis de polígonos. O padrão é false, definido como true para evitar incluir esses nós duplicados na coleção de saída.
Exemplos	geom_to_wkt(nodes_to_points(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)'))) → ‘MultiPoint ((0 0),(1 1),(2 2))’ geom_to_wkt(nodes_to_points(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1))'),true)) → ‘MultiPoint ((-1 -1),(4 0),(4 2),(0 2))’

Leitura adicional: Extrair vértices algorithm

12.2.13.75. num_geometries

Retonra o número de geometrias em uma coleção de geometrias, ou NULL se a geometria de entrada não for uma coleção.

Sintaxe	num_geometrias(geometria)
Argumentos	geometry - coleção de geometria
Exemplos	num_geometries(geom_from_wkt('GEOMETRYCOLLECTION(POINT(0 1), POINT(0 0), POINT(1 0), POINT(1 1))')) → 4

12.2.13.76. num_interior_rings

Retorna o número de anéis interiores em um polígono ou coleção de geometrias, ou NULL se a geometria de entrada não for polígono ou coleção.

Sintaxe	num_interior_rings(geometry)
Argumentos	geometry - geometria de entrada
Exemplos	num_interior_rings(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1),(-0.1 -0.1, 0.4 0, 0.4 0.2, 0 0.2, -0.1 -0.1))')) → 1

12.2.13.77. num_points

Retorna o número de vértices em uma geometria.

Sintaxe	num_points(geometry)
Argumentos	geometry - uma geometria
Exemplos	num_points($geometry) → number of vertices in the current feature’s geometry

12.2.13.78. num_rings

Retorna o número de anéis (incluindo anéis externos) em um polígono ou coleção de geometrias ou NULO se a geometria de entrada não for um polígono ou coleção.

Sintaxe	num_rings(geometry)
Argumentos	geometry - geometria de entrada
Exemplos	num_rings(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1),(-0.1 -0.1, 0.4 0, 0.4 0.2, 0 0.2, -0.1 -0.1))')) → 2

12.2.13.79. offset_curve

Retorna uma geometria formada pelo deslocamento de uma geometria linha para o lado. As distâncias estão no Sistema de Referência Espacial desta geometria.

Sintaxe	offset_curve(geometry, distance, [segments=8], [join=1], [miter_limit=2.0]) [] indica argumentos opcionais
Argumentos	geometry - uma geometria (multi) linha distance - distância de deslocamento. Valores positivos serão gerados a esquerda das linhas, valores negativos para a direita segments - número de segmentos a ser usado para representar um quarto de círculo quando um estilo de união arredondado é utilizado. Valores maiores resultam em linhas mais suaves com mais nós. join - estilo de junção dos cantos, onde 1 = round, 2 = miter e 3 = bevel miter_limit - limite na proporção de esquadria usada para cantos muito afiados (ao usar apenas junções de esquadria)
Exemplos	offset_curve($geometry, 10.5) → linha deslocada para a esquerda em 10.5 unidades offset_curve($geometry, -10.5) → linha deslocada para a direita em 10.5 unidades offset_curve($geometry, 10.5, segments:=16, join:=1) → linha deslocada para a esquerda em 10.5 unidades, usando mais segmentos resultando em uma curva mais suave offset_curve($geometry, 10.5, join:=3) → linha deslocada para a esquerda em 10.5 unidades, usando uma união chanfrada

Leitura adicional: Linhas de desvio. algorithm

12.2.13.80. order_parts

Ordena as partes de um MultiGeometry por um determinado critério

Sintaxe	order_parts(geometry, orderby, [ascending=true]) [] indica argumentos opcionais
Argumentos	geometry - uma geometria de vários tipos orderby - uma expressão que define os critérios de ordenação ascending - booleano, verdadeiro para ascendente, falso para descendente
Exemplos	geom_to_wkt(order_parts(geom_from_wkt('MultiPolygon (((1 1, 5 1, 5 5, 1 5, 1 1)),((1 1, 9 1, 9 9, 1 9, 1 1)))'), 'area($geometry)', False)) → ‘MultiPolygon (((1 1, 9 1, 9 9, 1 9, 1 1)),((1 1, 5 1, 5 5, 1 5, 1 1)))’ geom_to_wkt(order_parts(geom_from_wkt('LineString(1 2, 3 2, 4 3)'), '1', True)) → ‘LineString(1 2, 3 2, 4 3)’

12.2.13.81. oriented_bbox

Retorna uma geometria que representa o menor retângulo envolvente orientado de uma geometria de entrada.

Sintaxe	oriented_bbox(geometry)
Argumentos	geometry - uma geometria
Exemplos	geom_to_wkt( oriented_bbox( geom_from_wkt( 'MULTIPOINT(1 2, 3 4, 3 2)' ) ) ) → ‘Polygon ((3 2, 3 4, 1 4, 1 2, 3 2))’

Leitura adicional: Orientação mínima da caixa limitante. algorithm

12.2.13.82. overlaps

Testa quando a geometria sobrepõe outra. Retonra verdadeiro se as geometrias compartilham espaço, possuem a mesma dimensão, mas não estão completamentes contidas uma pela outra.

Sintaxe	overlaps(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	overlaps( geom_from_wkt( 'LINESTRING(3 5, 4 4, 5 5, 5 3)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → true overlaps( geom_from_wkt( 'LINESTRING(0 0, 1 1)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → false

12.2.13.83. overlay_contains

Retorna quando a feição atual contém espacialmente no mínimo uma feição de uma camada alvo, ou um lista baseada em expressão de resultados de feições na camada alvo contidas pela feição atual.

Leia mais sobre o predicado GEOS “Contains” , como descrito na função do PostGIS `ST_Contains<https://postgis.net/docs/ST_Contains.html>`_.

Sintaxe	overlay_contains(layer, [expression], [filter], [limit], [cache=false]) [] indica argumentos opcionais
Argumentos	layer* - a camada cuja sobreposição é verificada expression - uma expressão opcional para avaliar as feições da camada alvo. Se não fornecida, a função irá retornar um booleano indicando que possui ao menos uma combinação. filter - uma expressão opcional para filtrar as feições alvo a serem verificadas. Se não fornecida, todas as feições serão verificadas. limit - um inteiro opcional para limitar o número de feições combinadas. Se não fornecido, todas as combinações serão retornadas. cache - configure como verdadeiro para construir um índice espacial local (na maioria das vezes, isso é indesejado, a menos que esteja trabalhando em um provedor de dados particularmente lento)
Exemplos	overlay_contains('regions') → verdadeiro se a feição atual contém espacialmente uma ‘region’ overlay_contains('regions', filter:= population > 10000) → verdadeiro se a feição atual contém espacialmente uma ‘region’ com ‘population’ maior que 10000 overlay_contains('regions', name) → uma lista de ‘name’, para regiões contidas pela feição atual array_to_string(overlay_contains('regions', name)) → uma lista de nomes em uma string separada por vírgula, para as regiões contidas na feição atual. array_sort(overlay_contains(layer:='regions', expression:="name", filter:= population > 10000)) → uma lista ordenada de ‘name’, para as regiões contidas pela feição atual e com ‘population’ maior que 10000 overlay_contains(layer:='regions', expression:= geom_to_wkt($geometry), limit:=2) → uma lista de geometrias (em WKT), para até duas ‘regions’ contidas pela feição atual

Leitura adicional: contains, manipulação de arrays, algorítimo Selecionar pela localização

12.2.13.84. overlay_crosses

Retorna quando a feição atual espacialmente cruza uma feição de uma camada alvo, ou uma lista de resultados baseados em expressão para as feições na camada alvo cruzadas pela feição atual.

Leia mais sobre o predicado GEOS “Crosses”, conforme descrito na função PostGIS ST_Crosses.

Sintaxe	overlay_crosses(layer, [expression], [filter], [limit], [cache=false]) [] indica argumentos opcionais
Argumentos	layer* - a camada cuja sobreposição é verificada expression - uma expressão opcional para avaliar as feições da camada alvo. Se não fornecida, a função irá retornar um booleano indicando que possui ao menos uma combinação. filter - uma expressão opcional para filtrar as feições alvo a serem verificadas. Se não fornecida, todas as feições serão verificadas. limit - um inteiro opcional para limitar o número de feições combinadas. Se não fornecido, todas as combinações serão retornadas. cache - configure como verdadeiro para construir um índice espacial local (na maioria das vezes, isso é indesejado, a menos que esteja trabalhando em um provedor de dados particularmente lento)
Exemplos	overlay_crosses('regions') → verdadeiro se a feição atual espacialmente cruza uma região overlay_crosses('regions', filter:= population > 10000) → verdadeiro se a feição atual espacialmente cruza uma região com ‘population’ maior que 10000 overlay_crosses('regions', name) → uma lista de nomes, para as ‘regions’ cruzadas pela feição atual array_to_string(overlay_crosses('regions', name)) → uma string separada por vírgulas da lista de ‘name’, para ‘regions’ cruzadas pela feição atual array_sort(overlay_crosses(layer:='regions', expression:="name", filter:= population > 10000)) → uma lista ordenada de ‘name’, para cada ‘region’ cruzada pela feição atual e com ‘population’ maior que 10000 overlay_crosses(layer:='regions', expression:= geom_to_wkt($geometry), limit:=2) → uma lista de geometrias (em WKT), para até duas ‘regions’ cruzadas pela feição atual

Leitura adicional: crosses, manipulação de array, algorítimo Selecionar pela localização

12.2.13.85. overlay_disjoint

Retorna se a feição atual está separada espacialmente de todos as feições de uma camada de destino ou de uma lista de resultados baseados em expressão para as feições na camada de destino que estão separados da feição atual.

Leia mais sobre o predicado GEOS “Disjoint”, conforme descrito na função PostGIS ST_Disjoint.

Sintaxe	overlay_disjoint(layer, [expression], [filter], [limit], [cache=false]) [] indica argumentos opcionais
Argumentos	layer* - a camada cuja sobreposição é verificada expression - uma expressão opcional para avaliar as feições da camada alvo. Se não fornecida, a função irá retornar um booleano indicando que possui ao menos uma combinação. filter - uma expressão opcional para filtrar as feições alvo a serem verificadas. Se não fornecida, todas as feições serão verificadas. limit - um inteiro opcional para limitar o número de feições combinadas. Se não fornecido, todas as combinações serão retornadas. cache - configure como verdadeiro para construir um índice espacial local (na maioria das vezes, isso é indesejado, a menos que esteja trabalhando em um provedor de dados particularmente lento)
Exemplos	overlay_disjoint('regions') → verdadeiro se a feição atual é espacialemente separada de todas as ‘region’) overlay_disjoint('regions', filter:= population > 10000) → verdadeiro se a feição atual é espacialmente separada de todas as ‘regions’ com ‘population’ maior que 10000 overlay_disjoint('regions', name) → uma lista de ‘name’, para ‘regions’ que estão espacialmente separadas da feição atual array_to_string(overlay_disjoint('regions', name)) → uma string de valores separados por vírgula da lista de ‘name’, com cada ‘regions’ separadas espacialmente da feição atual array_sort(overlay_disjoint(layer:='regions', expression:="name", filter:= population > 10000)) → uma lista ordenada de ‘name’, de cada ‘region’ espacialmente separada da feição atual e com população maior que 10000 overlay_disjoint(layer:='regions', expression:= geom_to_wkt($geometry), limit:=2) → uma lista de geometrias ( em WKT), com até dois ‘regions’ espaciamente separadas da feição atual.

Leitura adicional: disjoint, manipulação de array, algoritimo Selecionar pela localização

12.2.13.86. overlay_equals

Retorna quando a feição atual é espacialmente igual a pelo menos uma feição da camada alvo, ou uma lista baseada em expressão de resultados das feições na camada alvo que são espacialmente iguais à feição atual.

Leia mais sobre o predicado GEOS “Equals” acima, conforme descrito na função PostGIS ST_Equals function.

Sintaxe	overlay_equals(layer, [expression], [filter], [limit], [cache=false]) [] indica argumentos opcionais
Argumentos	layer* - a camada cuja sobreposição é verificada expression - uma expressão opcional para avaliar as feições da camada alvo. Se não fornecida, a função irá retornar um booleano indicando que possui ao menos uma combinação. filter - uma expressão opcional para filtrar as feições alvo a serem verificadas. Se não fornecida, todas as feições serão verificadas. limit - um inteiro opcional para limitar o número de feições combinadas. Se não fornecido, todas as combinações serão retornadas. cache - configure como verdadeiro para construir um índice espacial local (na maioria das vezes, isso é indesejado, a menos que esteja trabalhando em um provedor de dados particularmente lento)
Exemplos	overlay_equals('regions') → verdadeiro se a feição atual é espacialmente igual à região overlay_equals('regions', filter:= population > 10000) → true if the current feature is spatially equal to a region with a population greater than 10000 overlay_equals('regions', name) → uma lista de nomes, para as regiões espacialmente igual à feição atual array_to_string(overlay_equals('regions', name)) → uma lista de nomes separados por vírgula para as regiões espacialmente iguais à feição atual array_sort(overlay_equals(layer:='regions', expression:="name", filter:= population > 10000)) → uma lista de nomes ordenada das regiões espacialmente iguais à feição atual e com “population” maior que 10000 overlay_equals(layer:='regions', expression:= geom_to_wkt($geometry), limit:=2) → um array de geometrias (em WKT), de até duas “regions” espacialmente iguais à feição atual

Leitura adicional: manipulação de array, algorítmo Selecionar pela localização

12.2.13.87. overlay_intersects

Retorna se feição atual intercepta espacialmente pelo menos uma feição de uma camada de destino ou uma matriz de resultados baseados em expressão para as feições na camada de destino interceptados pela feição atual.

Leia mais sobre o predicado GEOS “Intersects”, como descrito na função PostGIS ST_Intersects.

Sintaxe	overlay_intersects(layer, [expression], [filter], [limit], [cache=false]) [] indica argumentos opcionais
Argumentos	layer* - a camada cuja sobreposição é verificada expression - uma expressão opcional para avaliar as feições da camada alvo. Se não fornecida, a função irá retornar um booleano indicando que possui ao menos uma combinação. filter - uma expressão opcional para filtrar as feições alvo a serem verificadas. Se não fornecida, todas as feições serão verificadas. limit - um inteiro opcional para limitar o número de feições combinadas. Se não fornecido, todas as combinações serão retornadas. cache - configure como verdadeiro para construir um índice espacial local (na maioria das vezes, isso é indesejado, a menos que esteja trabalhando em um provedor de dados particularmente lento)
Exemplos	overlay_intersects('regions') → verdadeiro se a feição atual espacialmente intercepta “region” overlay_intersects('regions', filter:= population > 10000) → verdadeiro se a feição atual espacialmente intercepta “region” com “population” maior que 10000 overlay_intersects('regions', name) → um arrau de nomes, para as regiões interceptadas pela feição atual array_to_string(overlay_intersects('regions', name)) → uma lista separada por vírgula em string de nomes, para “regions” enterceptadas pela feição atual array_sort(overlay_intersects(layer:='regions', expression:="name", filter:= population > 10000)) → um array ordenada de “name” para “region” interceptadas pela feição atual e com “population” maior que 10000 overlay_intersects(layer:='regions', expression:= geom_to_wkt($geometry), limit:=2) → um array de geometrias (em WKT), de até duas “regions” interceptadas pela feição atual

Leitura adicional: intersects, manipulação de array, algorítmo Selecionar pela localização

12.2.13.88. overlay_nearest

Retorna se a feição atual tem feições de uma camada de destino dentro de uma determinada distância ou uma matriz de resultados baseados em expressões para as feições na camada de destino dentro de uma distância da feição atual.

Nota: Esta função pode ser lenta e consumir muita memória para camadas grandes.

Sintaxe	overlay_nearest(layer, [expression], [filter], [limit=1], [max_distance], [cache=false]) [] indica argumentos opcionais
Argumentos	layer - a camada alvo expression - uma expressão opcional para avaliar as feições da camada alvo. Se não fornecida, a função irá retornar um booleano indicando que possui ao menos uma combinação. filtro - uma expressão opcional para filtrar as feições alvo a serem verificadas. Se não estiver definido, todas as feições da camada alvo serão usadas. limit - um inteiro opcional para limitar o número de recursos correspondentes. Se não for definido, apenas o recurso mais próximo será retornado. Se definido como -1, retorna todos os recursos correspondentes. max_distance - uma distãncia opcional para limitar a busca de feições correspondentes. se não for preenchida, todas as feições na camada alvo serão utilizadas. cache - configure como verdadeiro para construir um índice espacial local (na maioria das vezes, isso é indesejado, a menos que esteja trabalhando em um provedor de dados particularmente lento)
Exemplos	overlay_nearest('airports') → verdadeiro se a camada “airports” possui pelo menos uma feição overlay_nearest('airports', max_distance:= 5000) → verdadeiro se há um “airport” dentro de uma distancia de 5000 unidades do mapa da feição atual overlay_nearest('airports', name) → “nome” do “airport” mais próximo à feição atual, como uma lista array_to_string(overlay_nearest('airports', name)) → nome do airport mais próximo à feição atual, como um texto. overlay_nearest(layer:='airports', expression:= name, max_distance:= 5000) → nome do airport mais próximo dentro de uma distância de 5.000 unidades do mapa da feição atual, como uma lista overlay_nearest(layer:='airports', expression:="name", filter:= "Use"='Civilian', limit:=3) → uma lista de nomes, para até três aeroportos civís próximos ordenados pela distância overlay_nearest(layer:='airports', expression:="name", limit:= -1, max_distance:= 5000) → um a lista de nomes, de todos os aeroportos dentro de uma distância de 5000 unidades do mapa a partir da feição atual, ordenado pela distância

Leitura adicional: manipulação de array, algorítmo Unir atributos por mais próximo

12.2.13.89. overlay_touches

Retorna se a feição atual toca espacialmente pelo menos uma feição de uma camada de destino ou uma matriz de resultados baseados em expressão para as feições na camada de destino tocadas pela feição atual.

Leia mais sobre o predicado subjacente “Touches” do GEOS, conforme descrito na função ST_Touches do PostGIS.

Sintaxe	overlay_touches(layer, [expression], [filter], [limit], [cache=false]) [] indica argumentos opcionais
Argumentos	layer* - a camada cuja sobreposição é verificada expression - uma expressão opcional para avaliar as feições da camada alvo. Se não fornecida, a função irá retornar um booleano indicando que possui ao menos uma combinação. filter - uma expressão opcional para filtrar as feições alvo a serem verificadas. Se não fornecida, todas as feições serão verificadas. limit - um inteiro opcional para limitar o número de feições combinadas. Se não fornecido, todas as combinações serão retornadas. cache - configure como verdadeiro para construir um índice espacial local (na maioria das vezes, isso é indesejado, a menos que esteja trabalhando em um provedor de dados particularmente lento)
Exemplos	overlay_touches('regiões') → verdadeiro se a feição atual toca espacialmente uma região overlay_touches('regions', filter:= population > 10000) → verdadeiro se a feição atual espacialmente tocar uma região com popupação maior que 10000 overlay_touches('regions', name) → uma lista de nomes, das regiões tocadas pela feição atual. string_to_array(overlay_touches('regions', name)) → texto separado por virgula de uma lista de nomes, das regiões tocadas pela feição atual array_sort(overlay_touches(layer:='regions', expression:="name", filter:= population > 10000)) → uma lista de nomes ordenados, das regiões tocadas pela feição atual e com população maior que 10000 overlay_touches(layer:='regions', expression:= geom_to_wkt($geometry), limit:=2) → uma lista de geometrias (em WKT), de até duas regiões tocadas pela feição atual

Leitura adicional: touches, manipulação de array, algorítmo Selecionar pela localização

12.2.13.90. overlay_within

Retorna se a feição atual está espacialmente dentro de pelo menos uma feição da camada de destino ou uma matriz de resultados baseados em expressão para as feições na camada de destino que contém a feição atual.

Leia mais sobre o predicado GEOS “dentro” subjacente, conforme descrito na função ST_Within do PostGIS.

Sintaxe	overlay_within(layer, [expression], [filter], [limit], [cache=false]) [] indica argumentos opcionais
Argumentos	layer* - a camada cuja sobreposição é verificada expression - uma expressão opcional para avaliar as feições da camada alvo. Se não fornecida, a função irá retornar um booleano indicando que possui ao menos uma combinação. filter - uma expressão opcional para filtrar as feições alvo a serem verificadas. Se não fornecida, todas as feições serão verificadas. limit - um inteiro opcional para limitar o número de feições combinadas. Se não fornecido, todas as combinações serão retornadas. cache - configure como verdadeiro para construir um índice espacial local (na maioria das vezes, isso é indesejado, a menos que esteja trabalhando em um provedor de dados particularmente lento)
Exemplos	overlay_within('regions') → verdadeiro se a feição atual for espacialmente contida por uma região overlay_within('regions', filter:= population > 10000) → verdadeiro se a feição atual for espacialmente contida por uma região com população maior que 10000 overlay_within('regions', name) → uma lista de nomes, das regiões que contém a feição atual array_to_string(overlay_within('regions', name)) → uma lista em texto separado por vírgula dos nomes das regiões que contém a feição atual array_sort(overlay_within(layer:='regions', expression:="name", filter:= population > 10000)) → uma lista ordenada de nomes das regiões que contém a feição atual e que possuem uma população maior que 10000 overlay_within(layer:='regions', expression:= geom_to_wkt($geometry), limit:=2) → uma lista de geometrias (em WKT), com até duas regiões que contém a feição atual

Leitura adicional: within, manipulação de array, algorítmo Selecionar pela localização

12.2.13.91. $perimeter

Retorna o comprimento do perímetro da feição atual. O perímetro calculado por esta função respeita a configuração do elipsóide do projeto atual e as configurações da unidade de distância. Por exemplo, se um elipsóide foi definido para o projeto, o perímetro calculado será elipsoidal e, se nenhum elipsóide for definido, o perímetro calculado será planimétrico.

Sintaxe	$perimeter
Exemplos	$perimeter → 42

12.2.13.92. perimeter

Retorna o perímetro de um objeto de polígono geométrico. Os cálculos são sempre planimétricos no Spatial Reference System (SRS) dessa geometria, e as unidades do perímetro retornado corresponderão às unidades do SRS. Isso difere dos cálculos executados pela função $perimeter, que realizará cálculos elipsoidais com base nas configurações do elipsóide e da unidade de distância do projeto.

Sintaxe	perimeter(geometry)
Argumentos	geometry - objeto de geometria de polígono
Exemplos	perimeter(geom_from_wkt('POLYGON((0 0, 4 0, 4 2, 0 2, 0 0))')) → 12.0

12.2.13.93. point_n

Retorna um nó específico de uma geometria.

Sintaxe	point_n(geometry, index)
Argumentos	geometry - objeto geométrico index - índice do nó a ser retornado, onde 1 é o primeiro nó; se o valor for negativo, o índice do vértice selecionado será sua contagem total menos o valor absoluto
Exemplos	geom_to_wkt(point_n(geom_from_wkt('POLYGON((0 0, 4 0, 4 2, 0 2, 0 0))'),2)) → ‘Point (4 0)’

Leitura adicional: Extrair vértices específicos algorithm

12.2.13.94. point_on_surface

Retorna um ponto garantido estar na superfície de uma geometria.

Sintaxe	point_on_surface(geometry)
Argumentos	geometry - uma geometria
Exemplos	point_on_surface($geometry) → a point geometry

Leitura adicional: algorítmo Ponto na Superfície

12.2.13.95. pole_of_inaccessibility

Calcula o pólo aproximado de inacessibilidade para uma superfície, que é o ponto interno mais distante do limite da superfície. Essa função usa o algoritmo ‘polylabel’ (Vladimir Agafonkin, 2016), que é uma abordagem iterativa garantida para encontrar o verdadeiro pólo de inacessibilidade dentro de uma tolerância especificada. Tolerâncias mais precisas requerem mais iterações e demoram mais para serem calculadas.

Sintaxe	pole_of_inaccessibility(geometry, tolerance)
Argumentos	geometry - uma geometria tolerance - distância máxima entre o ponto retornado e a localização do pólo verdadeiro
Exemplos	geom_to_wkt(pole_of_inaccessibility( geom_from_wkt('POLYGON((0 1, 0 9, 3 10, 3 3, 10 3, 10 1, 0 1))'), 0.1))' → ‘Point(1.546875 2.546875)’

Leitura adicional: algorítmo Pólo de inacessibilidade

12.2.13.96. project

Retorna um ponto projetado de um ponto inicial usando uma distância, um rumo (azimute) e uma elevação em radianos.

Sintaxe	project(point, distance, azimuth, [elevation]) [] indica argumentos opcionais
Argumentos	point - ponto inicial distance - distância a projetar azimuth - azimute em radianos no sentido horário, onde 0 corresponde ao norte elevation - ângulo de inclinação em radianos
Exemplos	geom_to_wkt(project(make_point(1, 2), 3, radians(270))) → ‘Point(-2, 2)’

Leitura adicional: algorítmo Projetar pontos (Cartesiano)

12.2.13.97. relate

Testa a representação do modelo de interseção 9 estendido dimensional (DE-9IM) da relação entre duas geometrias.

Variante de relação

Retorna a representação Dimensional Extended 9 Intersection Model (DE-9IM) da relação entre duas geometrias.

Sintaxe	relate(geometry, geometry)
Argumentos	geometry - uma geometria geometry - uma geometria
Exemplos	relate( geom_from_wkt( 'LINESTRING(40 40,120 120)' ), geom_from_wkt( 'LINESTRING(40 40,60 120)' ) ) → ‘FF1F00102’

Variante de correspondência de padrão

Testa se a relação DE-9IM entre duas geometrias corresponde a um padrão especificado.

Sintaxe	relate(geometry, geometry, pattern)
Argumentos	geometry - uma geometria geometry - uma geometria pattern - DE-9IM padrão a combinar
Exemplos	relate( geom_from_wkt( 'LINESTRING(40 40,120 120)' ), geom_from_wkt( 'LINESTRING(40 40,60 120)' ), '**1F001**' ) → Verdadeiro

12.2.13.98. reverse

Inverte a direção de uma cadeia de linha invertendo a ordem de seus vértices.

Sintaxe	reverse(geometry)
Argumentos	geometry - uma geometria
Exemplos	geom_to_wkt(reverse(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)'))) → ‘LINESTRING(2 2, 1 1, 0 0)’

Leitura adicional: Direção reversa da linha algorithm

12.2.13.99. rotate

Retorna uma versão rotacionada de uma geometria. Os cálculos estão no Sistema de Referência Espacial desta geometria.

Sintaxe	rotate(geometry, rotation, [center]) [] indica argumentos opcionais
Argumentos	geometry - uma geometria rotation - rotação no sentido horário em graus center - ponto central de rotação. Se não for especificado, o centro da caixa delimitadora da geometria será usado.
Exemplos	geometria``rotate($geometry, 45, make_point(4, 5))`` → geometria rotacionada 45 graus no sentido horário em torno do ponto (4, 5) rotate($geometry, 45) → geometria rotacionada 45 graus no sentido horário em torno do centro de seu retângulo envolvente

Fig. 12.7 Rotação de feições

12.2.13.100. segments_to_lines

Retorna uma geometria de várias linhas que consiste em uma linha para cada segmento na geometria de entrada.

Sintaxe	segments_to_lines(geometry)
Argumentos	geometry - objeto geométrico
Exemplos	geom_to_wkt(segments_to_lines(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)'))) → ‘MultiLineString ((0 0, 1 1),(1 1, 2 2))’

Leitura adicional: algorítmo Explodir linhas

12.2.13.101. shortest_line

Retorna a linha mais curta que une geometria1 a geometria2. A linha resultante começará em geometria1 e terminará em geometria2.

Sintaxe	shortest_line(geometry1, geometry2)
Argumentos	geometry1 - geometria para encontrar a linha mais curta de geometry2 - geometria para encontrar a linha mais curta para
Exemplos	geom_to_wkt(shortest_line(geom_from_wkt('LINESTRING (20 80, 98 190, 110 180, 50 75 )'),geom_from_wkt('POINT(100 100)'))) → ‘LineString(73.0769 115.384, 100 100)’

12.2.13.102. simplify

Simplifica uma geometria removendo nós usando um limite baseado em distância (ou seja, o algoritmo de Douglas Peucker). O algoritmo preserva grandes desvios nas geometrias e reduz o número de vértices em segmentos quase retos.

Sintaxe	simplify(geometry, tolerance)
Argumentos	geometry - uma geometria tolerance - desvio máximo de segmentos retos para pontos a serem removidos
Exemplos	geom_to_wkt(simplify(geometry:=geom_from_wkt('LineString(0 0, 5 0.1, 10 0)'),tolerance:=5)) → ‘LineString(0 0, 10 0)’

Leitura adicional: algorítmo Simplificar

12.2.13.103. simplify_vw

Simplifica uma geometria removendo nós usando um limite baseado em área (ou seja, o algoritmo de Visvalingam-Whyatt). O algoritmo remove vértices que criam pequenas áreas em geometrias, por exemplo, picos estreitos ou segmentos quase retos.

Sintaxe	simplify_vw(geometry, tolerance)
Argumentos	geometry - uma geometria tolerance - uma medida da área máxima criada por um nó para que o nó seja removido
Exemplos	geom_to_wkt(simplify_vw(geometry:=geom_from_wkt('LineString(0 0, 5 0, 5.01 10, 5.02 0, 10 0)'),tolerance:=5)) → ‘LineString(0 0, 10 0)’

Leitura adicional: algorítmo Simplificar

12.2.13.104. single_sided_buffer

Retorna uma geometria formada pelo buffer de apenas um lado de uma geometria linestring. As distâncias estão no Sistema de Referência Espacial desta geometria.

Sintaxe	single_sided_buffer(geometry, distance, [segments=8], [join=1], [miter_limit=2.0]) [] indica argumentos opcionais
Argumentos	geometry - uma geometria (multi) linha distance - distância do buffer. Os valores positivos serão armazenados à esquerda das linhas, os valores negativos à direita segments - número de segmentos a serem usados para representar um quarto de círculo quando um estilo de junção arredondada é usado. Um número maior resulta em um buffer mais suave com mais nós. join - estilo de junção dos cantos, onde 1 = round, 2 = miter e 3 = bevel miter_limit - limite na proporção de esquadria usada para cantos muito afiados (ao usar apenas junções de esquadria)
Exemplos	single_sided_buffer($geometry, 10.5) → linha com buffer à esquerda de 10.5 unidades single_sided_buffer($geometry, -10.5) → linha com buffer à direita de 10.5 unidades single_sided_buffer($geometry, 10.5, segments:=16, join:=1) → linha com buffer à esquerda em 10.5 unidade, usando mais segmentos para resultar em um buffer mais suave single_sided_buffer($geometry, 10.5, join:=3) → linha com buffer à esquerda em 10,5 unidades, usando mais segmentos para resultar em um buffer mais suave

Leitura adicional: algorítmo Buffer de lado único

12.2.13.105. sinuosity

Retorna a sinuosidade de uma curva, que é a razão entre o comprimento da curva e a distância reta (2D) entre suas extremidades.

Sintaxe	sinuosity(geometry)
Argumentos	geometry - curva de entrada (circularstring, linestring)
Exemplos	round(sinuosity(geom_from_wkt('LINESTRING(2 0, 2 2, 3 2, 3 3)')), 3) → 1.265 sinuosity(geom_from_wkt('LINESTRING( 3 1, 5 1)')) → 1.0

12.2.13.106. smooth

Suaviza uma geometria adicionando nós extras que arredondam os cantos na geometria. Se as geometrias de entrada contiverem valores Z ou M, eles também serão suavizados e a geometria de saída manterá a mesma dimensionalidade da geometria de entrada.

Sintaxe	smooth(geometry, [iterations=1], [offset=0.25], [min_length=-1], [max_angle=180]) [] indica argumentos opcionais
Argumentos	geometry - uma geometria iterations - número de iterações de suavização a serem aplicadas. Números maiores resultam em geometrias mais suaves, porém mais complexas. offset - valor entre 0 e 0,5, que controla o quanto a geometria suavizada segue a geometria original. Valores menores resultam em uma suavização mais apertada, valores maiores resultam em uma suavização mais frouxa. min_length - comprimento mínimo de segmentos para aplicar a suavização. Este parâmetro pode ser usado para evitar colocar nós adicionais em excesso em segmentos mais curtos da geometria. max_angle - ângulo máximo no nó para suavização a ser aplicada (0-180). Ao diminuir o ângulo máximo, cantos agudos intencionalmente na geometria podem ser preservados. Por exemplo, um valor de 80 graus manterá os ângulos retos na geometria.
Exemplos	geom_to_wkt(smooth(geometry:=geom_from_wkt('LineString(0 0, 5 0, 5 5)'),iterations:=1,offset:=0.2,min_length:=-1,max_angle:=180)) → ‘LineString (0 0, 4 0, 5 1, 5 5)’

Leitura adicional: algorítmo Suave

12.2.13.107. start_point

Retorna o primeiro nó de uma geometria.

Sintaxe	start_point(geometry)
Argumentos	geometry - objeto geométrico
Exemplos	geom_to_wkt(start_point(geom_from_wkt('LINESTRING(4 0, 4 2, 0 2)'))) → ‘Point (4 0)’

Leitura adicional: Extrair vértices específicos algorithm

12.2.13.108. straight_distance_2d

Retorna a distância direta/euclidiana entre o primeiro e o último vértice de uma geometria. A geometria deve ser uma curva (sequência circular, sequência de linhas).

Sintaxe	straight_distance_2d(geometry)
Argumentos	geometry - A geometria.
Exemplos	straight_distance_2d(geom_from_wkt('LINESTRING(1 0, 1 1)')) → 1 round(straight_distance_2d(geom_from_wkt('LINESTRING(1 4, 3 5, 5 0)')), 3) → 5.657

Leitura adicional: length

12.2.13.109. sym_difference

Retorna uma geometria que representa as partes de duas geometrias que não se intersectam.

Sintaxe	sym_difference(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	geom_to_wkt( sym_difference( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'LINESTRING(3 3, 8 8)' ) ) ) → ‘LINESTRING(5 5, 8 8)’

Leitura adicional: Diferença simétrica algorithm

12.2.13.110. tapered_buffer

Cria um buffer ao longo de uma geometria de linha onde o diâmetro do buffer varia uniformemente ao longo do comprimento da linha.

Sintaxe	tapered_buffer(geometry, start_width, end_width, [segments=8]) [] indica argumentos opcionais
Argumentos	geometry - geometria de entrada. Deve ser uma geometria de (multi)linha. start_width - largura do buffer no início da linha, end_width - largura do buffer no final da linha. segments - número de segmentos para aproximar as curvas de um quarto de círculo no buffer.
Exemplos	tapered_buffer(geometry:=geom_from_wkt('LINESTRING(1 2, 4 2)'),start_width:=1,end_width:=2,segments:=8) → Um buffer cônico começando com um diâmetro de 1 e terminando com um diâmetro de 2 ao longo da geometria linestring.

Fig. 12.8 Buffer cônico em feições de linha

Leitura adicional: algorítmo Buffers cônicos.

12.2.13.111. touches

Testa se uma geometria toca outra. Retorna verdadeiro se as geometrias tiverem pelo menos um ponto em comum, mas seus interiores não se cruzarem.

Sintaxe	touches(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	touches( geom_from_wkt( 'LINESTRING(5 3, 4 4)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → verdadeiro touches( geom_from_wkt( 'POINT(4 4)' ), geom_from_wkt( 'POINT(5 5)' ) ) → falso

Leitura adicional: overlay_touches

12.2.13.112. transform

Retorna a geometria transformada de um CRS de origem para um CRS de destino.

Sintaxe	transform(geometry, source_auth_id, dest_auth_id)
Argumentos	geometry - uma geometria source_auth_id - Id da autoridade SRC de origem dest_auth_id - Id da autoridade SRC de destino
Exemplos	geom_to_wkt( transform( make_point(488995.53240249, 7104473.38600835), 'EPSG:2154', 'EPSG:4326' ) ) → ‘POINT(0 51)’

Leitura adicional: algorítmo Reprojetar camada

12.2.13.113. translate

Retorna uma versão traduzida de uma geometria. Os cálculos estão no Sistema de Referência Espacial desta geometria.

Sintaxe	translate(geometry, dx, dy)
Argumentos	geometry - uma geometria dx - delta x dy - delta y
Exemplos	translate($geometry, 5, 10) → uma geometria do mesmo tipo que a original

Fig. 12.9 Tradução de Feições

Leitura adicional: algorítmo Traduzir

12.2.13.114. union

Retorna uma geometria que representa a união do conjunto de pontos das geometrias.

Sintaxe	union(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	geom_to_wkt( union( make_point(4, 4), make_point(5, 5) ) ) → ‘MULTIPOINT(4 4, 5 5)’

12.2.13.115. wedge_buffer

Retorna um buffer em forma de cunha originário de uma geometria de ponto.

Sintaxe	wedge_buffer(center, azimuth, width, outer_radius, [inner_radius=0.0]) [] indica argumentos opcionais
Argumentos	center - ponto central (origem) do buffer. Deve ser uma geometria de ponto. azimuth - ângulo (em graus) para o meio da cunha apontar. width - largura do buffer (em graus). Observe que a cunha se estenderá até a metade da largura angular de cada lado da direção do azimute. outer_radius - raio externo para buffers inner_radius - raio interno opcional para buffers
Exemplos	wedge_buffer(center:=geom_from_wkt('POINT(1 2)'),azimuth:=90,width:=180,outer_radius:=1) → Um buffer em forma de cunha centrado no ponto (1,2), voltado para o leste, com largura de 180 graus e raio externo de 1.

Leitura adicional: algorítmo Crie buffers de cunha (wedge buffer).

12.2.13.116. within

Testa se uma geometria está dentro de outra. Retorna verdadeiro se a geometria1 estiver completamente dentro da geometria2.

Sintaxe	within(geometry1, geometry2)
Argumentos	geometry1 - uma geometria geometry2 - uma geometria
Exemplos	within( geom_from_wkt( 'POINT( 0.5 0.5)' ), geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))' ) ) → verdadeiro within( geom_from_wkt( 'POINT( 5 5 )' ), geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0 ))' ) ) → falso

Leitura adicional: overlay_within

12.2.13.117. $x

Retorna a coordenada x da feição de ponto atual. Se a feição for multiponto, a coordenada x do primeiro ponto será retornada.

Sintaxe	$x
Exemplos	$x → 42

12.2.13.118. x

Retorna a coordenada x de uma geometria de ponto ou a coordenada x do centroide para uma geometria sem ponto.

Sintaxe	x(geometry)
Argumentos	geometry - uma geometria
Exemplos	x( geom_from_wkt( 'POINT(2 5)' ) ) → 2 x( $geometry ) → coordenada x do centroide da feição atual

12.2.13.119. $x_at

Recupera uma coordenada x da geometria da feição atual.

Sintaxe	$x_at(i)
Argumentos	i - indice de um ponto em uma linha (indices inciam em 0; valores negativos se aplicam a partir do último indice, começando em -1)
Exemplos	$x_at(1) → 5

12.2.13.120. x_max

Retorna a coordenada x máxima de uma geometria. Os cálculos estão no sistema de referência espacial desta geometria.

Sintaxe	x_max(geometria)
Argumentos	geometry - uma geometria
Exemplos	x_max( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → 4

12.2.13.121. x_min

Retorna a coordenada x mínima de uma geometria. Os cálculos estão no sistema de referência espacial desta geometria.

Sintaxe	x_min(geometria)
Argumentos	geometry - uma geometria
Exemplos	x_min( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → 2

12.2.13.122. $y

Retorna a coordenada y da feição de ponto atual. Se a feição for multiponto, a coordenada y do primeiro ponto será retornada.

Sintaxe	$y
Exemplos	$y → 42

12.2.13.123. y

Retorna a coordenada y de uma geometria de ponto ou a coordenada y do centroide para uma geometria sem ponto.

Sintaxe	y(geometry)
Argumentos	geometry - uma geometria
Exemplos	y( geom_from_wkt( 'POINT(2 5)' ) ) → 5 y( $geometry ) → coordenada y do centroide da feição atual

12.2.13.124. $y_at

Recupera uma coordenada y da geometria da feição atual.

Sintaxe	$y_at(i)
Argumentos	i - indice de um ponto em uma linha (indices inciam em 0; valores negativos se aplicam a partir do último indice, começando em -1)
Exemplos	$y_at(1) → 2

12.2.13.125. y_max

Retorna a coordenada y máxima de uma geometria. Os cálculos estão no sistema de referência espacial desta geometria.

Sintaxe	y_max(geometry)
Argumentos	geometry - uma geometria
Exemplos	y_max( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → 8

12.2.13.126. y_min

Retorna a coordenada y mínima de uma geometria. Os cálculos estão no sistema de referência espacial desta geometria.

Sintaxe	y_min(geometry)
Argumentos	geometry - uma geometria
Exemplos	y_min( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → 5

12.2.13.127. $z

Retorna o valor z da feição de ponto atual se for 3D. Se a feição for multiponto, o valor z do primeiro ponto será retornado.

Sintaxe	$z
Exemplos	$z → 123

12.2.13.128. z

Retorna a coordenada z de uma geometria de ponto, ou NULO se a geometria não tiver valor z.

Sintaxe	z(geometry)
Argumentos	geometry - uma geometria de ponto
Exemplos	z( geom_from_wkt( 'POINTZ(2 5 7)' ) ) → 7

12.2.13.129. z_max

Retorna a coordenada z máxima de uma geometria, ou NULO se a geometria não tiver valor z.

Sintaxe	z_max(geometry)
Argumentos	geometry - uma geometria com coordenada z
Exemplos	z_max( geom_from_wkt( 'POINT ( 0 0 1 )' ) ) → 1 z_max( geom_from_wkt( 'MULTIPOINT ( 0 0 1 , 1 1 3 )' ) ) → 3 z_max( make_line( make_point( 0,0,0 ), make_point( -1,-1,-2 ) ) ) → 0 z_max( geom_from_wkt( 'LINESTRING( 0 0 0, 1 0 2, 1 1 -1 )' ) ) → 2 z_max( geom_from_wkt( 'POINT ( 0 0 )' ) ) → NULL

12.2.13.130. z_min

Retorna a coordenada z mínima de uma geometria, ou NULO se a geometria não tiver valor z.

Sintaxe	z_min(geometry)
Argumentos	geometry - uma geometria com coordenada z
Exemplos	z_min( geom_from_wkt( 'POINT ( 0 0 1 )' ) ) → 1 z_min( geom_from_wkt( 'MULTIPOINT ( 0 0 1 , 1 1 3 )' ) ) → 1 z_min( make_line( make_point( 0,0,0 ), make_point( -1,-1,-2 ) ) ) → -2 z_min( geom_from_wkt( 'LINESTRING( 0 0 0, 1 0 2, 1 1 -1 )' ) ) → -1 z_min( geom_from_wkt( 'POINT ( 0 0 )' ) ) → NULL

12.2.14. Funções de Layout

Este grupo contém funções para manipular as propriedades dos itens de layout de impressão.

12.2.14.1. item_variables

Retorna um mapa de variáveis de um item de layout dentro deste layout de impressão.

Sintaxe	item_variables(id)
Argumentos	id - ID do item do layout
Exemplos	map_get( item_variables('Map 0'), 'map_scale') → escala do item ‘Map 0’ no layout de impressão atual

Leitura adicional: Lista de variáveis padrão

12.2.14.2. map_credits

Retorna uma lista de strings de crédito (direitos de uso) para as camadas mostradas em um item de mapa de layout.

Sintaxe	map_credits(id, [include_layer_names=false], [layer_name_separator=’: ‘]) [] indica argumentos opcionais
Argumentos	id - ID do item do mapa include_layer_names - Defina como verdadeiro para incluir os nomes das camadas antes de suas cadeias de crédito layer_name_separator - String a ser inserida entre os nomes de camadas e seus créditos, se include_layer_names for verdadeiro
Exemplos	array_to_string( map_credits( 'Main Map' ) ) → lista de créditos das camadas separada por vírgula das camadas exibidas no item do layout “Main Map”, E.x.: ‘CC-BY-NC, CC-BY-SA’ array_to_string( map_credits( 'Main Map', include_layer_names := true, layer_name_separator := ': ' ) ) → lista separada por vírgulas de nomes de camadas e seus créditos para camadas mostradas no item de layout ‘Main Map’, por exemplo ‘Linhas ferroviárias: CC-BY-NC, Basemap: CC-BY-SA’

Esta função precisa que Propriedades de metadados de acesso das camadas tenham sido preenchidos.

12.2.15. Camadas do mapa

Este grupo contém uma lista das camadas disponíveis no projeto atual. Isso oferece uma maneira conveniente de escrever expressões referentes a várias camadas, como quando se fazem consultas usando aggregates, attribute ou spatial.

Também fornece algumas funções convenientes para manipular camadas.

12.2.15.1. decode_uri

Pega uma camada e decodifica o uri do provedor de dados subjacente. Depende do provedor de dados, quais dados estão disponíveis.

Sintaxe	decode_uri(layer, [part]) [] indica argumentos opcionais
Argumentos	layer - Camada a qual a uri deve ser decodificada. part - Parte da uri a ser retornada. Se não for especificada, um mapa com todas as parts da url será retornado.
Exemplos	decode_uri(@layer) → {‘layerId’: ‘0’, ‘layerName’: ‘’, ‘path’: ‘/home/qgis/shapefile.shp’} decode_uri(@layer) → {‘layerId’: NULL, ‘layerName’: ‘layer’, ‘path’: ‘/home/qgis/geopackage.gpkg’} decode_uri(@layer, 'path') → ‘C:\my_data\qgis\shape.shp’

12.2.15.2. layer_property

Retorna uma propriedade de camada correspondente ou valor de metadados.

Sintaxe	layer_property(layer, property)
Argumentos	layer - uma string, representando um nome de camada ou um ID de camada property - uma string correspondente à propriedade a ser retornada. As opções válidas são: name: nome da camada ID: ID da camada title: string titulo do metadado abstract: string do metadado resumo keywords: metadado palavas-chave data_url: metadado URL attribution: string do metadado atribuição attribution_url: metadado URL atribuição source: camada origem min_scale: escala de exibição mínima para camada max_scale: escala de exibição máxima para camada is_editable: se a camada estiver no modo de edição crs: camada SRC crs_definition: definição completa do SRC da camada crs_description: descrição do SRC da camada extent: extensão da camada (como um objeto de geometria) ditance_units: unidades de distância da camada type: tipo de camada, ex., Vetorial ou Raster storage_type: formato de armazenamento (apenas camadas vetoriais) geometry_type: tipo da geometria, e.x.:, Point (apenas camadas vetoriais) feature_count: contagem aproximada de feição da camada (apenas camadas vetoriais) path: caminho para o arquivo fonte da camada. Disponível apenas para camadas baseadas em arquivos.
Exemplos	layer_property('streets','title') → ‘Basemap Streets’ layer_property('airports','feature_count') → 120 layer_property('landsat','crs') → ‘EPSG:4326’

Leitura adicional: propriedades de camada vector, raster e mesh

12.2.16. Funções de mapeamento

Este grupo contém funções para criar ou manipular chaves e valores de estruturas de dados de mapas (também conhecidos como objetos de dicionário, pares de chave-valor ou arrays associativos). Ao contrário de estrutura de dados lista em que a ordem dos valores importa, a ordem dos pares de chave-valor no objeto de mapa não é relevante e os valores são identificados por suas chaves.

12.2.16.1. from_json

Carrega um texto formatado como JSON

Sintaxe	from_json(string)
Argumentos	string - string JSON
Exemplos	from_json('{"qgis":"rocks"}') → { ‘qgis’: ‘rocks’ } from_json('[1,2,3]') → [1,2,3]

12.2.16.2. hstore_to_map

Cria um mapa a parir de uma string formatada como hstore

Sintaxe	hstore_to_map(string)
Argumentos	string - string de entrada
Exemplos	hstore_to_map('qgis=>rocks') → { ‘qgis’: ‘rocks’ }

12.2.16.3. map

Retorna um mapa contendo todas as chaves e valores passados como par de parâmetros.

Sintaxe	map(key1, value1, key2, value2, …)
Argumentos	key - uma chave (string) valor - um valor
Exemplos	map('1','one','2', 'two') → { ‘1’: ‘one’, ‘2’: ‘two’ } map('1','one','2', 'two')['1'] → ‘one’

12.2.16.4. map_akeys

Retorna um array contendo todas as chaves de um mapa

Sintaxe	map_akeys(map)
Argumentos	map - um mapa
Exemplos	map_akeys(map('1','one','2','two')) → [ ‘1’, ‘2’ ]

12.2.16.5. map_avals

Retorna todos os valores de um map como um array.

Sintaxe	map_avals(map)
Argumentos	map - um mapa
Exemplos	map_avals(map('1','one','2','two')) → [ ‘one’, ‘two’ ]

12.2.16.6. map_concat

Retorna um mapa contendo todas as entradas dos mapas fornecidos. Se dois mapas contiverem a mesma chave, o valor do segundo mapa será usado.

Sintaxe	map_concat(map1, map2, …)
Argumentos	map - um mapa
Exemplos	map_concat(map('1','one', '2','overridden'),map('2','two', '3','three')) → { ‘1’: ‘one’, ‘2’: ‘two’, ‘3’: ‘three’ }

12.2.16.7. map_delete

Retorna um mapa com a chave fornecida e seu valor correspondente excluído.

Sintaxe	map_delete(map, key)
Argumentos	map - um mapa key - a chave a ser excluída
Exemplos	map_delete(map('1','one','2','two'),'2') → { ‘1’: ‘one’ }

12.2.16.8. map_exist

Retorna verdadeiro se a chave informada exisitr no mapa

Sintaxe	map_exist(map, key)
Argumentos	map - um mapa key - chave a ser pesquisada
Exemplos	map_exist(map('1','one','2','two'),'3') → false

12.2.16.9. map_get

Retorna o valor de um mapa, dada sua chave. Retorna NULO se a chave não existir.

Sintaxe	map_get(map, key)
Argumentos	map - um mapa key - chave a ser pesquisada
Exemplos	map_get(map('1','one','2','two'),'2') → ‘two’ map_get( item_variables('Map 0'), 'map_scale') → escala do item ‘Map 0’ (se existir) no layout de impressão atual

Dica

Você pode utilizar também o operador de índice ([]) para pegar um valor de um mapa.

12.2.16.10. map_insert

Retorna um mapa com uma chave/valor adicionado. Se a chave já existir, seu valor será substituído.

Sintaxe	map_insert(map, key, value)
Argumentos	map - um mapa key - a chave a ser adicionada value - o valor a ser adicionado
Exemplos	map_insert(map('1','one'),'3','three') → { ‘1’: ‘one’, ‘3’: ‘three’ } map_insert(map('1','one','2','overridden'),'2','two') → { ‘1’: ‘one’, ‘2’: ‘two’ }

12.2.16.11. map_to_hstore

Mescla os elementos de um mapa em uma string formatada em hstore.

Sintaxe	map_to_hstore(map)
Argumentos	map - mapa de entrada
Exemplos	map_to_hstore(map('qgis','rocks')) → ‘“qgis”=>”rocks”’

12.2.16.12. to_json

Cria uma string formada em JSON a partir de um mapa, matriz ou outro valor.

Sintaxe	to_json(value)
Argumentos	value - O valor de entrada
Exemplos	to_json(map('qgis','rocks')) → {“qgis”:”rocks”} to_json(array(1,2,3)) → [1,2,3]

12.2.17. Funções Matemáticas

Este grupo contém funções matemáticas (por exemplo, raiz quadrada, sen e cos).

12.2.17.1. abs

Retorna o valor absoluto de um número.

Sintaxe	abs(value)
Argumentos	value - um número
Exemplos	abs(-2) → 2

12.2.17.2. acos

Retorna o cosseno inverso de um valor em radianos.

Sintaxe	acos(valor)
Argumentos	value - cosseno de um ângulo em radianos
Exemplos	acos(0.5) → 1.0471975511966

12.2.17.3. asin

Retorna o seno inverso de um valor em radianos.

Sintaxe	asen(value)
Argumentos	value - seno de um ângulo em radianos
Exemplos	asen(1.0) → 1.5707963267949

12.2.17.4. atan

Retorna a tangente inversa de um valor em radianos.

Sintaxe	atan(value)
Argumentos	value - tangente de um ângulo em radianos
Exemplos	atan(0.5) → 0.463647609000806

12.2.17.5. atan2

Retorna a tangente inversa de dy/dx usando os sinais dos dois argumentos para determinar o quadrante do resultado.

Sintaxe	atan2(dy, dx)
Argumentos	dy - diferença na coordenada y dx - diferença na coordenada x
Exemplos	atan2(1.0, 1.732) → 0.523611477769969

12.2.17.6. ceil

Arredonda um número para cima.

Sintaxe	ceil(value)
Argumentos	value - um número
Exemplos	ceil(4.9) → 5 ceil(-4.9) → -4

12.2.17.7. clamp

Restringe um valor de entrada a um intervalo especificado.

Sintaxe	clamp(minimum, input, maximum)
Argumentos	minimum - o menor valor que input pode assumir input - um valor que será restrito ao intervalo especificado por minimun e maximun maximum - o maior valor que input pode assumir
Exemplos	clamp(1,5,10) → 5 input está entre 1 e 10, então retorna inalterada clamp(1,0,10) → 1 input é menor que o valor mínimo de 1, então a função retorna 1 clamp(1,11,10) → 10 se o valor de input for maior que o valor máximo de 10, então a função retornará 10

12.2.17.8. cos

Retorna o cosseno de um ângulo.

Sintaxe	cos(angle)
Argumentos	angle - ângulo em radianos
Exemplos	cos(1.571) → 0.000796326710733263

12.2.17.9. degrees

Converte de radianos para graus.

Sintaxe	degrees(radians)
Argumentos	radians - valor numérico
Exemplos	degrees(3.14159) → 180 degrees(1) → 57.2958

12.2.17.10. exp

Retorna o exponencial de um valor.

Sintaxe	exp(valor)
Argumentos	value - número para retornar o expoente
Exemplos	exp(1.0) → 2.71828182845905

12.2.17.11. floor

Arredonda um número para baixo.

Sintaxe	floor(value)
Argumentos	value - um número
Exemplos	floor(4.9) → 4 floor(-4.9) → -5

12.2.17.12. ln

Retorna o logaritmo natural de um valor.

Sintaxe	ln(value)
Argumentos	value - valor numérico
Exemplos	ln(1) → 0 ln(2.7182818284590452354) → 1

12.2.17.13. log

Retorna o valor do logaritmo do valor passado e da base.

Sintaxe	log(base, value)
Argumentos	base - qualquer número positivo value - qualquer número positivo
Exemplos	log(2, 32) → 5 log(0.5, 32) → -5

12.2.17.14. log10

Retorna o valor do logaritmo de base 10 da expressão passada.

Sintaxe	log10(value)
Argumentos	value - qualquer número positivo
Exemplos	log10(1) → 0 log10(100) → 2

12.2.17.15. max

Retorna o maior valor em um conjunto de valores.

Sintaxe	max(value1, value2, …)
Argumentos	value - um número
Exemplos	max(2,10.2,5.5) → 10.2 max(20.5,NULL,6.2) → 20.5

12.2.17.16. min

Retorna o menor valor em um conjunto de valores.

Sintaxe	min(value1, value2, …)
Argumentos	value - um número
Exemplos	min(20.5,10,6.2) → 6.2 min(2,-10.3,NULL) → -10.3

12.2.17.17. pi

Retorna o valor de pi para cálculos.

Sintaxe	pi()
Exemplos	pi() → 3.14159265358979

12.2.17.18. radians

Converte de graus para radianos.

Sintaxe	radians(degrees)
Argumentos	degrees - valor numérico
Exemplos	radians(180) → 3.14159 radians(57.2958) → 1

12.2.17.19. rand

Retorna um inteiro aleatório dentro do intervalo especificado pelo argumento mínimo e máximo (inclusive). Se uma seed for fornecida, o retorno será sempre o mesmo, dependendo da seed.

Sintaxe	rand(min, max, [seed=NULL]) [] indica argumentos opcionais
Argumentos	min - um número inteiro que representa o menor número aleatório possível desejado max - um inteiro que representa o maior número aleatório possível desejado seed - qualquer valor usado como seed
Exemplos	rand(1, 10) → 8

12.2.17.20. randf

Retorna um float aleatório dentro do intervalo especificado pelo argumento mínimo e máximo (inclusive). Se uma seed for fornecida, o retorno será sempre o mesmo, dependendo da seed.

Sintaxe	randf([min=0.0], [max=1.0], [seed=NULL]) [] indica argumentos opcionais
Argumentos	min - um float representando o menor número aleatório possível desejado max - um float representando o maior número aleatório possível desejado seed - qualquer valor usado como seed
Exemplos	randf(1, 10) → 4.59258286403147

12.2.17.21. round

Arredonda um número para número de casas decimais.

Sintaxe	round(value, [places=0]) [] indica argumentos opcionais
Argumentos	value - número decimal a ser arredondado places - Número inteiro opcional que representa o número de casas para arredondar os decimais. Pode ser negativo.
Exemplos	round(1234.567, 2) → 1234.57 round(1234.567) → 1235 round(1234.567, -1) → 1230

12.2.17.22. scale_exp

Transforma um determinado valor de um domínio de entrada para um intervalo de saída usando uma curva exponencial. Esta função pode ser usada para atenuar valores dentro ou fora do intervalo de saída especificado.

Sintaxe	scale_exp(value, domain_min, domain_max, range_min, range_max, exponent)
Argumentos	value - Um valor no domínio de entrada. A função retornará um valor escalado correspondente no intervalo de saída. domain_min - Especifica o valor mínimo no domínio de entrada, o menor valor que o valor de entrada deve assumir. domain_max - Especifica o valor maior no domínio de entrada, o maior valor que o valor de entrada deve assumir. range_min - Especifica um valor mínimo no intervalo de saída, o menor valor que a função deve retornar. range_max - Especifica o valor máximo do intervalor de saída, o maior valor que a função deverá retornar. exponent - Um valor positivo (maior que 0), que determina a forma como os valores de entrada são mapeados para o intervalo de saída. Grandes expoentes farão com que os valores de saída ‘acelerem’, iniciando lentamente antes de acelerar à medida que os valores de entrada se aproximam do máximo do domínio. Expoentes menores (menos de 1) farão com que os valores de saída ‘desacelerem’, onde o mapeamento começa rapidamente, mas diminui conforme se aproxima do máximo do domínio.
Exemplos	scale_exp(5,0,10,0,100,2) → 25 facilitando o ln, usando um expoente de 2 scale_exp(3,0,10,0,100,0.5) → 54.772 easing out, usando um expoente de 0.5

12.2.17.23. scale_linear

Transforma um determinado valor de um domínio de entrada em um intervalo de saída usando interpolação linear.

Sintaxe	scale_linear(value, domain_min, domain_max, range_min, range_max)
Argumentos	value - Um valor no domínio de entrada. A função retornará um valor escalado correspondente no intervalo de saída. domain_min - Especifica o valor mínimo no domínio de entrada, o menor valor que o valor de entrada deve assumir. domain_max - Especifica o valor maior no domínio de entrada, o maior valor que o valor de entrada deve assumir. range_min - Especifica um valor mínimo no intervalo de saída, o menor valor que a função deve retornar. range_max - Especifica o valor máximo do intervalor de saída, o maior valor que a função deverá retornar.
Exemplos	scale_linear(5,0,10,0,100) → 50 scale_linear(0.2,0,1,0,360) → 72 dimensionar um valor entre 0 e 1 para um ângulo entre 0 e 360 scale_linear(1500,1000,10000,9,20) → 9.6111111 escalar uma população que varia entre 1000 e 10000 para um tamanho de fonte entre 9 e 20

12.2.17.24. sin

Retorna o seno de um ângulo.

Sintaxe	sin(angle)
Argumentos	angle - ângulo em radianos
Exemplos	sin(1.571) → 0.999999682931835

12.2.17.25. sqrt

Retorna a raiz quadrada de um valor.

Sintaxe	sqrt(value)
Argumentos	value - um número
Exemplos	sqrt(9) → 3

12.2.17.26. tan

Retorna a tangente de um ângulo.

Sintaxe	tan(angle)
Argumentos	angle - ângulo em radianos
Exemplos	tan(1.0) → 1.5574077246549

12.2.18. Funções de Malhas

Este grupo contém funções que calculam ou retornam valores relacionados à mesh.

12.2.18.1. $area_face

Retorna a área da face da malha atual. A área calculada por esta função respeita tanto a configuração do elipsóide do projeto atual quanto as configurações da unidade de área. Por exemplo, se um elipsóide foi definido para o projeto, a área calculada será elipsoidal, e se nenhum elipsóide for definido, a área calculada será planimétrica.

Sintaxe	$area_face
Exemplos	$face_area → 42

12.2.18.2. $face_index

Retorna o índice da face da malha atual.

Sintaxe	$face_index
Exemplos	$face_index → 4581

12.2.18.3. $vertex_as_point

Retorna o vértice atual como uma geometria de ponto.

Sintaxe	$vertex_as_point
Exemplos	geom_to_wkt( $vertex_as_point ) → ‘POINT(800 1500 41)’

12.2.18.4. $vertex_index

Retorna o índice do vértice do mesh atual

Sintaxe	$vertex_index
Exemplos	$vertex_index → 9874

12.2.18.5. $vertex_x

Retorna a coordenada X do vértice da malha atual.

Sintaxe	$vertex_x
Exemplos	$vertex_x → 42.12

12.2.18.6. $vertex_y

Retorna a coordenada Y do vértice da malha atual.

Sintaxe	$vertex_y
Exemplos	$vertex_y → 12.24

12.2.18.7. $vertex_z

Retorna o valor Z do vértice do mesh atual.

Sintaxe	$vertex_z
Exemplos	$vertex_z → 42

12.2.19. Operadores

Este grupo contém operadores (por exemplo, +, -, *). Observe que, para a maioria das funções matemáticas abaixo, se uma das entradas for NULL, o resultado será NULL.

12.2.19.1. %

Restante da divisão

Sintaxe	a % b
Argumentos	a - valor b - valor
Exemplos	5 % 4 → 1 5 % NULO → NULO

12.2.19.2. *

Multiplicação de dois valores

Sintaxe	a * b
Argumentos	a - valor b - valor
Exemplos	5 * 4 → 20 5 * NULO → NULO

12.2.19.3. +

Adição de dois valores. Se um dos valores for NULO, o resultado será NULO.

Sintaxe	a + b
Argumentos	a - valor b - valor
Exemplos	5 + 4 → 9 5 + NULO → NULO 'QGIS ' + 'ROCKS' → ‘QGIS ROCKS’ to_datetime('2020-08-01 12:00:00') + '1 day 2 hours' → 2020-08-02T14:00:00

Leitura adicional: concat, ||

12.2.19.4. -

Subtração de dois valores. Se um dos valores for NULO, o resultado será NULO.

Sintaxe	a - b
Argumentos	a - valor b - valor
Exemplos	5 - 4 → 1 5 - NULO → NULO to_datetime('2012-05-05 12:00:00') - to_interval('1 day 2 hours') → 2012-05-04T10:00:00

12.2.19.5. /

Divisão de dois valores

Sintaxe	a / b
Argumentos	a - valor b - valor
Exemplos	5 / 4 → 1.25 5 / NULO` → NULO

12.2.19.6. <

Compara dois valores e avalia como 1 se o valor da esquerda for menor que o valor da direita.

Sintaxe	a < b
Argumentos	a - valor b - valor
Exemplos	5 < 4 → 0 5 < 5 → 0 4 < 5 → 1

12.2.19.7. <=

Compara dois valores e avalia como 1 se o valor da esquerda for menor ou igual ao valor da direita.

Sintaxe	a <= b
Argumentos	a - valor b - valor
Exemplos	5 <= 4 → 0 5 <= 5 → 1 4 <= 5 → 1

12.2.19.8. <>

Compara dois valores e avalia com 1 se eles não forem iguais.

Sintaxe	a <> b
Argumentos	a - valor b - valor
Exemplos	5 <> 4 → 1 4 <> 4 → 0 5 <> NULO → NULO NULO <> NULO → NULO

12.2.19.9. =

Compara dois valores e avalia com 1 se forem iguais.

Sintaxe	a = b
Argumentos	a - valor b - valor
Exemplos	5 = 4 → 0 4 = 4 → 1 5 = NULO → NULO NULO = NULO → NULO

12.2.19.10. >

Compara dois valores e avalia como 1 se o valor esquerdo for maior que o valor direito.

Sintaxe	a > b
Argumentos	a - valor b - valor
Exemplos	5 > 4 → 1 5 > 5 → 0 4 > 5 → 0

12.2.19.11. >=

Compara dois valores e avalia como 1 se o valor da esquerda for maior ou igual ao valor da direita.

Sintaxe	a >= b
Argumentos	a - valor b - valor
Exemplos	5 >= 4 → 1 5 >= 5 → 1 4 >= 5 → 0

12.2.19.12. AND

Retorna 1 quando as condições a e b são verdadeiras.

Sintaxe	a AND b
Argumentos	a - condição b - condição
Exemplos	TRUE AND TRUE → 1 TRUE AND FALSE → 0 4 = 2+2 E 1 = 1 → 1 4 = 2+2 E 1 = 2 → 0

12.2.19.13. ILIKE

Retorna 1 se o primeiro parâmetro corresponder ao padrão fornecido sem distinção entre maiúsculas e minúsculas. LIKE pode ser usado em vez de ILIKE para fazer a correspondência diferenciar maiúsculas de minúsculas. Trabalha com números também.

Sintaxe	string/número padrão ILIKE
Argumentos	string/number - string para pesquisar pattern - padrão a ser procurado, você pode usar ‘%’ como curinga, ‘_’ como um único caractere e ‘\\’ para escapar caracteres especiais.
Exemplos	'A' ILIKE 'A' → 1 'A' ILIKE 'a' → 1 'A' ILIKE 'B' → 0 'ABC' ILIKE 'b' → 0 'ABC' ILIKE 'B' → 0 'ABC' ILIKE '_b_' → 1 'ABC' ILIKE '_B_' → 1 'ABCD' ILIKE '_b_' → 0 'ABCD' ILIKE '_B_' → 0 'ABCD' ILIKE '_b%' → 1 'ABCD' ILIKE '_B%' → 1 'ABCD' ILIKE '%b%' → 1 'ABCD' ILIKE '%B%' → 1 'ABCD%' ILIKE 'abcd\\%' → 1 'ABCD' ILIKE '%B\\%' → 0

12.2.19.14. IN

Retorna 1 se o valor for encontrado em uma lista de valores.

Sintaxe	a IN b
Argumentos	a - valor b - lista de valores
Exemplos	'A' IN ('A','B') → 1 'A' IN ('C','B') → 0

12.2.19.15. IS

Retorna 1 se a for igual a b.

Sintaxe	a IS b
Argumentos	a - qualquer valor b - qualquer valor
Exemplos	'A' IS 'A' → 1 'A' IS 'a' → 0 4 IS 4 → 1 4 IS 2+2 → 1 4 IS 2 → 0 $geometry IS NULL → 0, if your geometry is not NULL

12.2.19.16. IS NOT

Retorna 1 se a não for igual a b.

Sintaxe	a IS NOT b
Argumentos	a - valor b - valor
Exemplos	'a' IS NOT 'b' → 1 'a' IS NOT 'a' → 0 4 IS NOT 2+2 → 0

12.2.19.17. LIKE

Retorna 1 se o primeiro parâmetro combinar com o padrão informado. Funciona com números também.

Sintaxe	texto/número padrão LIKE
Argumentos	string/number - valor pattern - padrão a ser comparado com o valor, você pode usar ‘%’ como curinga, ‘_’ como caractere único e ‘\\’ para escapar esses caracteres especiais.
Exemplos	'A' LIKE 'A' → 1 'A' LIKE 'a' → 0 'A' LIKE 'B' → 0 'ABC' LIKE 'B' → 0 'ABC' LIKE '_B_' → 1 'ABCD' LIKE '_B_' → 0 'ABCD' LIKE '_B%' → 1 'ABCD' LIKE '%B%' → 1 '1%' LIKE '1\\%' → 1 '1_' LIKE '1\\%' → 0

12.2.19.18. NOT

Nega uma condição.

Sintaxe	NOT a
Argumentos	a - condição
Exemplos	NOT 1 → 0 NOT 0 → 1

12.2.19.19. OR

Retorna 1 quando a condição a ou b é verdadeira.

Sintaxe	a OR b
Argumentos	a - condição b - condição
Exemplos	4 = 2+2 OR 1 = 1 → 1 4 = 2+2 OR 1 = 2 → 1 4 = 2   OR 1 = 2 → 0

12.2.19.20. []

Operador de índice. Retorna um elemento de uma matriz ou valor de mapa.

Sintaxe	[index]
Argumentos	index - índice do array ou chave de um valor num mapa
Exemplos	array(1,2,3)[0] → 1 array(1,2,3)[2] → 3 array(1,2,3)[-1] → 3 map('a',1,'b',2)['a'] → 1 map('a',1,'b',2)['b'] → 2

Leitura adicional: array_get, map_get

12.2.19.21. ^

Potência de dois valores.

Sintaxe	a ^ b
Argumentos	a - valor b - valor
Exemplos	5 ^ 4 → 625 5 ^ NULO → NULO

12.2.19.22. ||

Une dois valores em uma string.

Se um dos valores for NULL o resultado será NULL. Veja a função CONCAT para um comportamento diferente

Sintaxe	a || b
Argumentos	a - valor b - valor
Exemplos	'Aqui' || ' e ' || 'ali' → ‘Aqui e ali’ 'Nothing' || NULL → NULL 'Dia: ' || "Diameter" → ‘Dia: 25’ 1 || 2 → ‘12’

Leitura adicional: concat, +

12.2.19.23. ~

Executa uma correspondência de expressão regular em um valor de string. Os caracteres de barra invertida devem ter escape duplo (por exemplo, “\\s” para corresponder a um caractere de espaço em branco).

Sintaxe	string ~ regex
Argumentos	string - Um valor de string regex - Uma expressão regular. As barras devem ser escapadas, e.x.: \\d.
Exemplos	'hello' ~ 'll' → 1 'hello' ~ '^ll' → 0 'hello' ~ 'llo$' → 1 'abc123' ~ '\\d+' → 1

Leitura adicional: regexp_match

12.2.20. Funções de Processamento

Este grupo contém funções que operam em algoritmos de processamento.

12.2.20.1. parameter

Retorna o valor de um parâmetro de entrada do algoritmo de processamento.

Sintaxe	parameter(name)
Argumentos	name - nome do parâmetro de entrada correspondente
Exemplos	parameter('BUFFER_SIZE') → 5.6

12.2.21. Funções de Rasters

Este grupo contém funções para operar na camada raster.

12.2.21.1. raster_statistic

Retorna as estatísticas de uma camada raster.

Sintaxe	raster_statistic(layer, band, property)
Argumentos	camada - uma string, representando um nome de camada raster ou um ID de camada band - inteiro representando o número da banda da camada raster, começando em 1 property - uma string correspondente à propriedade a ser retornada. As opções válidas são: min: valor mínimo max: valor máximo avg: valor médio (média) stdev: desvio padrão dos valores range: intervalo de valores (max. - min.) sum: soma de todos os valores do raster
Exemplos	raster_statistic('lc',1,'avg') → Valor médio da banda 1 da camada raster ‘lc’ raster_statistic('ac2010',3,'min') → Menor valor da banda 3 da camada raster ‘2010’

12.2.21.2. raster_value

Retorna o valor raster encontrado no ponto fornecido.

Sintaxe	raster_value(layer, band, point)
Argumentos	layer - o nome ou id de uma camada raster banda - o número da banda para amostrar o valor. point - geometria de ponto (para geometrias multipartes com mais de uma parte, um valor NULO será retornado)
Exemplos	raster_value('dem', 1, make_point(1,1)) → 25

12.2.22. Funções de Registro e Atributos

Este grupo contém funções que operam na identificação da registros.

12.2.22.1. attribute

Retorna um atributo de uma feição.

** Variante 1**

Retorna o valor de um atributo da feição atual.

Sintaxe	attribute(attribute_name)
Argumentos	attribute_name - nome do atributo a ser retornado
Exemplos	attribute( 'nome' ) → valor armazenado no atributo ‘nome’ para a feição atual

Variante 2

Permite que a feição de destino e o nome do atributo sejam especificados.

Sintaxe	attribute(feature, attribute_name)
Argumentos	feature - uma feição attribute_name - nome do atributo a ser retornado
Exemplos	attribute( @atlas_feature, 'name' ) → valor armazenado no atributo ‘name’ na feição atual do atlas

12.2.22.2. attributes

Retorna um mapa contendo todos os atributos de uma feição, onde os nomes de campo são as chaves do mapa

** Variante 1**

Retorna um mapa de todos os atributos da feição atual.

Sintaxe	attributes()
Exemplos	attributes()['name'] → valor armazenado no atributo ‘name’ da feição atual

Variante 2

Permite que a feição de destino seja especificada.

Sintaxe	attributes(feature)
Argumentos	feature - uma feição
Exemplos	attributes( @atlas_feature )['name'] → valor armazenado no atributo ‘name’ na feição atual do do atlas

Leitura adicional: Funções de mapeamento

12.2.22.3. $currentfeature

Retorna a feição atual que está sendo avaliada. Isso pode ser usado com a função ‘attribute’ para avaliar os valores de atributo da feição atual.

Sintaxe	$currentfeature
Exemplos	attribute( $currentfeature, 'name' ) → valor armazenado no atributo ‘name’ da feição atual

12.2.22.4. display_expression

Retorna a expressão de exibição para uma determinada feição em uma camada. A expressão é avaliada por padrão. Pode ser usado com zero, um ou mais argumentos, veja abaixo para detalhes.

Sem parâmetros

Se for chamada sem nenhum parâmetro, a função irá avaliar a expressão de exibição da feição atual na camada atual.

Sintaxe	display_expression()
Exemplos	display_expression() → Expressão de exibição da feição atual na camada atual.

Um parâmetro ‘feição’

Se chamada apenas com um parâmetro ‘feição’, a função avaliará a feição especificada da camada atual.

Sintaxe	display_expression(feature)
Argumentos	feature - Feição que deverá ser avaliada.
Exemplos	display_expression(@atlas_feature) → Expressão de exibição da feição atual do atlas.

Parâmetros de camada e feição

Se a função for chamada com uma camada e uma feição, ela avaliará a feição especificada da camada especificada.

Sintaxe	display_expression(layer, feature, [evaluate=true]) [] indica argumentos opcionais
Argumentos	layer - A camada (ou ID ou nome) feature - Feição que deverá ser avaliada. evaluate - Se a expressão deve ser avaliada. Se false, a expressão será retornada apenas como uma string literal (que pode ser avaliada posteriormente usando a função ‘eval’).
Exemplos	display_expression( 'streets', get_feature_by_id('streets', 1)) → Expressão de exibição da feição com o ID 1 na camada ‘streets’. display_expression('a_layer_id', $currentfeature, 'False') → Expressão de exibição de uma feição informada sem avaliação.

12.2.22.5. get_feature

Retorna a primeia feição de uma camada correspondente a um determinado valor de atributo.

Sintaxe	get_feature(layer, attribute, value)
Argumentos	layer - nome ou ID da camada atributte - nome do atributo value - valor do atributo a ser correspondido
Exemplos	get_feature('streets','name','main st') → primeira feição encontrada na camada “streets” com o valor “main st” no campo “name”

12.2.22.6. get_feature_by_id

Retorna a feição com um id em uma camada.

Sintaxe	get_feature_by_id(layer, feature_id)
Argumentos	layer - camada, nome da camada ou ID da camada feature_id - id da feição que será retornada
Exemplos	get_feature_by_id('streets', 1) → feição de id 1 na camada “streets”

Leitura adicional: $id

12.2.22.7. $id

Retorna o ID da feição da linha atual.

Sintaxe	$id
Exemplos	$id → 42

12.2.22.8. is_selected

Retorna Verdadeiro se uma feição for selecionada. Pode ser usado com zero, um ou dois argumentos, veja abaixo para detalhes.

Sem parâmetros

Se chamada sem parâmetros, a função retornará verdadeiro se a feição atual na camada atual for selecionada.

Sintaxe	is_selected()
Exemplos	is_selected() → Verdadeiro se a feição atual na camada atual estiver selecionada.

Um parâmetro ‘feição’

Se invocada apenas com o parâmetro ‘feature’, a função irá retornar verdadeiro se a feição especificada da camada atual estiver selecionada.

Sintaxe	is_selected(feature)
Argumentos	feature - A feição que deve ser verificada para seleção.
Exemplos	is_selected(@atlas_feature) → Verdadeiro se a feição atual do atlas estiver selecionada. is_selected(get_feature('streets', 'name', 'Main St.'))) → Verdadeiro se a feição exclusiva chamada “Main St.” na camada ativa “streets” estiver selecionado. is_selected(get_feature_by_id('streets', 1)) → Verdadeiro se a feição com o id 1 na camada ativa “streets” estiver selecionada.

Dois parâmetros

Se a função for chamada com uma camada e uma feição, ela retornará verdadeiro se a feição especificada da camada especificada for selecionada.

Sintaxe	is_selected(layer, feature)
Argumentos	layer - A camada (seu ID ou nome) na qual a seleção será verificada. feature - A feição que deve ser verificada para seleção.
Exemplos	is_selected( 'streets', get_feature('streets', 'name', "street_name")) → Verdadeiro se a rua do prédio atual for selecionada (supondo que a camada do prédio tenha um campo chamado ‘street_name’ e a camada ‘streets’ tenha um campo chamado ‘name’ com valores exclusivos). is_selected( 'streets', get_feature_by_id('streets', 1)) → Verdadeiro se a feição com o id 1 na camada “streets” estiver selecionada.

12.2.22.9. maptip

Retorna o maptip de uma feição de uma camada. A expressão é avaliada por padrão. Pode ser usada com zero, um ou mais argumentos, veja abaixo para mais detalhes.

Sem parâmetros

Se chamada sem parâmetros, a função avaliará a dica de mapa da feição atual na camada atual.

Sintaxe	maptip()
Exemplos	maptip() → Maptip da feição atual da camada atual.

Um parâmetro ‘feição’

Se chamada apenas com um parâmetro ‘feição’, a função avaliará a feição especificada da camada atual.

Sintaxe	maptip(feature)
Argumentos	feature - Feição que deverá ser avaliada.
Exemplos	maptip(@atlas_feature) → Maptip da feição atual da feição do atlas.

Parâmetros de camada e feição

Se a função for chamada com uma camada e uma feição, ela avaliará a feição especificada da camada especificada.

Sintaxe	maptip(layer, feature, [evaluate=true]) [] indica argumentos opcionais
Argumentos	layer - A camada (ou ID ou nome) feature - Feição que deverá ser avaliada. evaluate - Se a expressão precisa ser avaliada, Se falso, a expressão será retornada como um texto literal (que pode ser potencialmente avaliada futuramente utilizando a função ‘eval_template’)
Exemplos	maptip('streets', get_feature_by_id('streets', 1)) → Maptip da feição de ID 1 na camada ‘streets’. maptip('a_layer_id', $currentfeature, 'False') → Maptip de uma feição informada não avaliada.

12.2.22.10. num_selected

Retorna o número de feições selecionadas em uma determinada camada. Por padrão, funciona na camada na qual a expressão é avaliada.

Sintaxe	num_selected([layer=current layer]) [] indica argumentos opcionais
Argumentos	layer - Camada (ou seu id ou nome) onde a seleção deverá ser verificada.
Exemplos	num_selected() → O número de feições selecionadas na feição atual. num_selected('streets') → Número de feições selecionadas na camada ‘streets’

12.2.22.11. represent_value

Retorna o valor de representação configurado para um valor de campo. Depende do tipo de widget configurado. Frequentemente, isso é útil para widgets de ‘Mapa de valores’.

Sintaxe	represent_value(value, fieldName)
Argumentos	value - O valor que deve ser resolvido. Provavelmente um campo. fieldName - O nome do campo para o qual a configuração do widget deve ser carregada. (Opcional)
Exemplos	represent_value("field_with_value_map") → Descrição do valor represent_value('static value', 'field_name') → Descrição do valor estático

Leitura adicional: tipos de widget

12.2.22.12. sqlite_fetch_and_increment

Gerencia valores auto incrementais em bancos de dados sqlite

Valores SQLIte padrões podem apenas serem aplicados durante a inserção e não pré-buscados.

Isso torna impossível adquirir uma chave primária incrementada via AUTO_INCREMENT antes de criar a linha no banco de dados. Observação: com postgres, isso funciona por meio da opção avaliar valores padrão.

Ao adicionar novas feições com relações, é muito bom poder adicionar filhos para um pai, enquanto o formulário dos pais ainda está aberto e equanto a feição pai não estiver commitada.

Para contornar essa limitação, esta função pode ser usada para gerenciar valores de sequência em uma tabela separada em formatos baseados em sqlite como gpkg.

A tabela de sequência será filtrada para um id de sequência (filter_attribute e filter_value) e o valor atual do id_field será incrementado em 1 e o valor incrementado retornado.

Se colunas adicionais exigirem a especificação de valores, o mapa default_values poderá ser usado para essa finalidade.

Observação

Esta função modifica a tabela sqlite de destino. Destina-se ao uso com configurações de valor padrão para atributos.

Quando o parâmetro do banco de dados for uma camada e a camada estiver no modo de transação, o valor será recuperado apenas uma vez durante o tempo de vida de uma transação e armazenado em cache e incrementado. Isso torna inseguro trabalhar no mesmo banco de dados de vários processos em paralelo.

Sintaxe	sqlite_fetch_and_increment(database, table, id_field, filter_attribute, filter_value, [default_values]) [] indica argumentos opcionais
Argumentos	database - Caminho para o arquivo sqlite ou camada geopackage table - Nome da tabela que gerencia as sequências id_field - Nome do campo que contém o valor atual filter_attribute - Nome do campo que contém o identificador único para essa sequência. Precisa ter o indice UNIQUE. filter_value - Nome da sequencia a ser usada. default_values - Mapa com valores padrão para colunas adicionais na tabela. Os valores precisam ser informados integralmente. Funções são permitidas.
Exemplos	sqlite_fetch_and_increment(@layer, 'sequence_table', 'last_unique_id', 'sequence_id', 'global', map('last_change', 'date(''now'')', 'user', '''' || @user_account_name || '''')) → 0 sqlite_fetch_and_increment(layer_property(@layer, 'path'), 'sequence_table', 'last_unique_id', 'sequence_id', 'global', map('last_change', 'date(''now'')', 'user', '''' || @user_account_name || '''')) → 0

Leitura adicional: Data Sources Properties, Criando uma ou muitas para muitas relações

12.2.22.13. uuid

Gera um Idenrificador Universal Único (UUID) para cada linha utilizando o método Qt QUuid::createUuid.

Sintaxe	uuid([format=’WithBraces’]) [] indica argumentos opcionais
Argumentos	format - Formato, que irá formatar o UUID. ‘WithBraces’, ‘WithoutBraces’ ou ‘Id128’.
Exemplos	uuid() → ‘{0bd2f60f-f157-4a6d-96af-d4ba4cb366a1}’ uuid('WithoutBraces') → ‘0bd2f60f-f157-4a6d-96af-d4ba4cb366a1’ uuid('Id128') → ‘0bd2f60ff1574a6d96afd4ba4cb366a1’

12.2.23. Relações

Este grupo contém a liste de relações disponíveis no projeto atual, junto com suas descrições. Ele permite acesso rápido ao ID da relação para a escrita de uma expressção (como por exemplo a função relation_aggregate) ou customização de um formulário.

12.2.24. Funções de String

Este grupo contém funções que operam em textos (por exemplo, quer substituir, converter para maiúsculas).

12.2.24.1. ascii

Retorna o código unicode associado ao primeiro caractere de uma string.

Sintaxe	ascii(string)
Argumentos	string - string a ser convertida para código unicode
Exemplos	ascii('Q') → 81

12.2.24.2. char

Retorna um caractere associal a um código unicode.

Sintaxe	char(code)
Argumentos	code - número de um código unicode
Exemplos	char(81) → ‘Q’

12.2.24.3. concat

Concatena várias strings em uma. Valores nulos são convertidos em strings vazias. Outros valores (como números) são convertidos para string).

Sintaxe	concat(string1, string2, …)
Argumentos	string - um valor string
Exemplos	concat('sun', 'set') → ‘sunset’ concat('a','b','c','d','e') → ‘abcde’ concat('Anno ', 1984) → ‘Anno 1984’ concat('The Wall', NULL) → ‘The Wall’

Sobre a concatenação de campos

Você pode também concatenar strings ou valores de campos utilizando também os operadores || ou +, com algumas características:

• O operador + também significa somar expressão; portanto, se você tiver um operando inteiro (valor numérico ou de campo), isso pode ser propenso a erros e é melhor usar os outros:

  'My feature id is: ' + "gid" => triggers an error as gid returns an integer
  

• Quando qualquer um dos argumentos for um valor NULL, || ou + retornará um valor NULL. Para retornar os outros argumentos independentemente do valor NULL, convém usar a função concat:

  'My feature id is: ' + NULL ==> NULL
  'My feature id is: ' || NULL => NULL
  concat('My feature id is: ', NULL) => 'My feature id is: '
  

further reading: ||, +

12.2.24.4. format

Formate uma string usando os argumentos fornecidos.

Sintaxe	format(string, arg1, arg2, …)
Argumentos	string - Uma string com espaços reservados %1, %2, etc., para os argumentos. Os espaços reservados podem ser repetidos. O espaço reservado de menor número é substituído por arg1, o próximo por arg2, etc. arg - qualquer tipo. Qualquer número de argumentos.
Exemplos	format('Isso %1 um %2','é', 'teste') → ‘Isso é um teste’ format('Isso é %2',' um pouco inesperado mas o 2 é o menor número na string','normal') → ‘Isso é um pouco inesperado mas o 2 é o menor número na string’

12.2.24.5. format_date

Fomata o tipo date ou string em uma string formadata customizada. Usa o formato de string do Qt date/time . Veja QDateTime::toString.

Sintaxe	format_date(datetime, format, [language]) [] indica argumentos opcionais
Argumentos	datetime - valor data, hora ou datetime format - String do modelo usado para formatar a string. Expressão Output d o dia como número sem zero à esquerda (1 a 31) dd o dia como número com um zero à esquerda (01 a 31) ddd localização abreveada do nome do dia (ex. ‘Seg’ a ‘Dom’) dddd o nome longo do dia localizado (ex., ‘Segunda-feira’ a ‘Domingo’) M o mês como número sem zero à esquerda (1-12) MM o mês como número com um zero à esquerda (01-12) MMM o nome abreviado do mês localizado (ex., ‘Jan’ a ‘Dez’) MMMM o nome longo do mês localizado (ex., ‘janeiro’ a ‘dezembro’) yy o ano como número de dois dígitos (00-99) yyyy o ano como número de quatro dígitos Estas expressões podem ser usadas para a parte da hora da string de formatação: Expressão Output h a hora sem zero à esquerda (0 a 23 ou 1 a 12 se for exibido AM/PM) hh a hora com um zero à esquerda (00 a 23 ou 01 a 12 se for exibido AM/PM) H a hora sem zero à esquerda (0 a 23, mesmo com exibição AM/PM) HH a hora com um zero à esquerda (00 a 23, mesmo com exibição AM/PM) m o minuto sem zero à esquerda (0 a 59) mm o minuto com um zero à esquerda (00 a 59) s o segundo sem zero à esquerda (0 a 59) ss o segundo com um zero à esquerda (00 a 59) z os milissegundos sem zeros à direita (0 a 999) zzz os milissegundos com zeros à direita (000 a 999) AP or A Iinterprete como uma hora AM/PM. AP precisa ser ambos ‘AM’ ou ‘PM’. ap or a Interprete como uma hora AM/PM. ap precisa ser ambos ‘am’ ou ‘pm’. language - lingua (caixa baixa, duas ou três letras, código de linguagem ISO 639) usada para formatar a data em uma string customizada. Por padrão a localização do usuário atual do QGIS é utilizada.
Exemplos	format_date('2012-05-15','dd.MM.yyyy') → ‘15.05.2012’ format_date('2012-05-15','d MMMM yyyy','fr') → ‘15 mai 2012’ format_date('2012-05-15','dddd') → ‘Terça-feira’, se a localização é uma variante do Português. format_date('2012-05-15 13:54:20','dd.MM.yy') → ‘15.05.12’ format_date('13:54:20','hh:mm AP') → ‘01:54 PM’

12.2.24.6. format_number

Retonra um número formatado com o separador de milhar de acordo com a localização, Por padrão a localização atual do QGIS é utilizada. Também permite truncar as casas decimais para a quantidade de casas fornecidas.

Sintaxe	format_number(number, [places=0], [language]) [] indica argumentos opcionais
Argumentos	number - número a ser formatado places - número inteiro que representa o número de casas decimais para truncar a cadeia. language - lingua (minúscula, duas- ou três letras, ISO 639 código de lingua) Utilizado para formatar o número em uma string. Por padrão a localização atual do usuário no QGIS é utilizada.
Exemplos	format_number(10000000.332,2) → ‘10,000,000.33’ se, por exemplo, a localização atual for uma variante do Inglês format_number(10000000.332,2,'fr') → ‘10 000 000,33’

12.2.24.7. left

Retorna uma parte de uma string que contém os enésimos caractere mais a esquerda de uma string.

Sintaxe	left(string, length)
Argumentos	string - a string length - inteiro. O número de caracteres à esquerda da cadeia a ser retornada.
Exemplos	left('Hello World',5) → ‘Hello’

12.2.24.8. length

Retorna o número de caracteres em uma string ou o tamanho de uma geometria linha.

Variante string

Retorna o número de caracteres em uma string.

Sintaxe	length(string)
Argumentos	string - string para contar o comprimento de
Exemplos	length('hello') → 5

Variante geometria

Calcule o comprimento de um objeto de geometria linha. Os cálculos são sempre planimétricos no Sistema de Referência Espacial (SRS) dessa geometria, e as unidades do comprimento retornado corresponderão às unidades do SRS. Isso difere dos cálculos realizados pela função $length, que realizará cálculos elipsoidais com base nas configurações de elipsóide e unidade de distância do projeto.

Sintaxe	length(geometry)
Argumentos	geometry - objeto de geometria linha
Exemplos	length(geom_from_wkt('LINESTRING(0 0, 4 0)')) → 4.0

12.2.24.9. lower

Converte uma cadeia em letras minúsculas.

Sintaxe	lower(string)
Argumentos	string - a string a ser convertida para letras minúsculas
Exemplos	lower('HELLO World') → ‘hello world’

12.2.24.10. lpad

Retorna uma cadeia preenchida à esquerda até a largura especificada, usando um caractere de preenchimento. Se a largura de destino for menor que o comprimento da cadeia, a cadeia, será truncada.

Sintaxe	lpad(string, width, fill)
Argumentos	string - string para preencher width - comprimento da nova cadeia fill - caractere que irá preencher o espaço restante
Exemplos	lpad('Hello', 10, 'x') → ‘xxxxxHello’ lpad('Hello', 3, 'x') → ‘Hel’

12.2.24.11. regexp_match

Retorna a primeira posição que corresponda com a expressão regular em uma string unicode, ou 0 se a sub string não for encontrada.

Sintaxe	regexp_match(input_string, regex)
Argumentos	input_string - a string a ser usada contra a expressão regular regex - A expressão regular a ser testada contra a string, os caracteres de barra invertida precisam ser escapados (Ex., “\\s” para combinar com espaço em branco ou “\\b” para corresponder a um limite de palavra).
Exemplos	regexp_match('QGIS ROCKS','\\sROCKS') → 5 regexp_match('Budač','udač\\b') → 2

12.2.24.12. regexp_replace

Retorna uma string com Retorna uma string com a expressão regular fornecida substituída.

Sintaxe	regexp_replace(input_string, regex, replacement)
Argumentos	input_string - a string para substituir as correspondências regex - Expressão regular para substituir. caracteres com barra invertida devem ser escapados (e.x.: “\\s” para corresponder a um caractere de espaço em branco). replacement - String que irá subistituir quaisquer ocorrências da expressão regular fornecida. captura de grupos pode ser inserida na string de substituição utilizando \\1, \\2, etc.
Exemplos	regexp_replace('QGIS SHOULD ROCK','\\sSHOULD\\s',' DOES ') → ‘QGIS DOES ROCK’ regexp_replace('ABC123','\\d+','') → ‘ABC’ regexp_replace('my name is John','(.*) is (.*)','\\2 is \\1') → ‘John is my name’

12.2.24.13. regexp_substr

Retorna a parte de uma cadeia que corresponde a uma expressão regular fornecida.

Sintaxe	regexp_substr(input_string, regex)
Argumentos	input_string - string onde irá procurar ocorrências regex - A expressão regular a ser comparada. Os caracteres de barra invertida devem ter escape duplo (e.x.:, “\\s” para corresponder a um caractere de espaço em branco).
Exemplos	regexp_substr('abc123','(\\d+)') → ‘123’

12.2.24.14. replace

Retorna uma string com a string, array ou mapa de strings fornecido substituído.

Variante String & array

Retorna uma string com a string ou matriz de strings fornecida substituída por uma string ou uma matriz de strings.

Sintaxe	replace(string, before, after)
Argumentos	string - string de entrada before - string ou matriz de strings para substituir after - string ou matriz de strings a ser utilizadas como substitutas
Exemplos	replace('QGIS SHOULD ROCK','SHOULD','DOES') → ‘QGIS DOES ROCK’ replace('QGIS ABC',array('A','B','C'),array('X','Y','Z')) → ‘QGIS XYZ’ replace('QGIS',array('Q','S'),'') → ‘GI’

Variação por mapeamento

Retorna a string com as chaves de mapas substituidas pelos valores pareados. As chaves mais longas são avaliadas primeiro.

Sintaxe	replace(string, map)
Argumentos	string - string de entrada map - map que contém chaves e valores
Exemplos	replace('APP SHOULD ROCK',map('APP','QGIS','SHOULD','DOES')) → ‘QGIS DOES ROCK’ replace('forty two',map('for','4','two','2','forty two','42')) → ‘42’

12.2.24.15. right

Retorna uma sub string que contém os caracteres n mais à direita da string.

Sintaxe	right(string, length)
Argumentos	string - a string length - inteiro. O número de caracteres à direita da string a ser retornado.
Exemplos	right('Hello World',5) → ‘World’

12.2.24.16. rpad

Retorna uma string preenchida à direita na largura especificada, usando um caractere de preenchimento. Se a largura de destino for menor que o comprimento da string, a string será truncada.

Sintaxe	rpad(string, width, fill)
Argumentos	string - string para preencher width - comprimento da nova cadeia fill - caractere que irá preencher o espaço restante
Exemplos	rpad('Hello', 10, 'x') → ‘Helloxxxxx’ rpad('Hello', 3, 'x') → ‘Hel’

12.2.24.17. strpos

Retorna a primeira posição encontrada de uma substring em outra string, ou 0 se a substring não for encontrada.

Sintaxe	strpos(haystack, needle)
Argumentos	haystack - string that is to be searched needle - string to search for
Exemplos	strpos('HELLO WORLD','WORLD') → 7 strpos('HELLO WORLD','GOODBYE') → 0

12.2.24.18. substr

Retorna uma parte de uma string.

Sintaxe	substr(string, start, [length]) [] indica argumentos opcionais
Argumentos	string - string de entrada inteira start - inteiro representando a posição inicial para extrair começando com 1; se start for negativo, a string de retorno começará no final da string menos o valor inicial length - inteiro representando o tamanho da string a ser extraída; se length for negativo, a string retornada irá omitir a quantidade de caracteres do final da string
Exemplos	substr('HELLO WORLD',3,5) → ‘LLO W’ substr('HELLO WORLD',6) → ‘ WORLD’ substr('HELLO WORLD',-5) → ‘WORLD’ substr('HELLO',3,-1) → ‘LL’ substr('HELLO WORLD',-5,2) → ‘WO’ substr('HELLO WORLD',-5,-1) → ‘WORL’

12.2.24.19. title

Converte todas as palavras de uma string de título (todas as palavras com a primeira letra maiúscula).

Sintaxe	title(string)
Argumentos	string - string a ser convertida
Exemplos	title('hello WOrld') → ‘Hello World’

12.2.24.20. to_string

Converte um número em string.

Sintaxe	to_string(number)
Argumentos	number - Interio ou valor real. Número a ser convertido para string.
Exemplos	to_string(123) → ‘123’

12.2.24.21. trim

Remove todos os espaços em branco do início e do final (espaços vazios, tabulações, etc) de uma string.

Sintaxe	trim(string)
Argumentos	string - string para aparar
Exemplos	trim('   hello world    ') → ‘hello world’

12.2.24.22. upper

Converte uma string em letras maiúsculas.

Sintaxe	upper(string)
Argumentos	string - string a ser convertida para maiúscula
Exemplos	upper('hello WOrld') → ‘HELLO WORLD’

12.2.24.23. wordwrap

Retorna uma string agrupada em um número máximo/mínimo de caracteres.

Sintaxe	wordwrap(string, wrap_length, [delimiter_string]) [] indica argumentos opcionais
Argumentos	string - string a ser agrupada wrap_length - um inteiro. Se wrap_length for positivo, o número representará o número máximo ideal de caracteres a serem agrupados; se negativo, o número representa o número mínimo de caracteres a serem agrupados. delimiter_string - String elimitadora opcional para agrupar em uma nova linha.
Exemplos	wordwrap('UNIVERSITY OF QGIS',13) → ‘UNIVERSITY OF<br>QGIS’ wordwrap('UNIVERSITY OF QGIS',-3) → ‘UNIVERSITY<br>OF QGIS’

12.2.25. Expressões do usuário

Este grupo contém as expressões salvas como expressões do usuário.

12.2.26. Variáveis

Este grupo contém variáveis ​​dinâmicas relacionadas a aplicação, ao arquivo do projeto e outras configurações. A disponibilidade das variáveis ​​depende do contexto:

• da caixa de diálogo ^{Selecionar por expressão}

• a partir da caixa de diálogo ^{Calculadora de campo}

• na caixa de diálogo de propriedades da camada

• do layout de impressão

Para usar essas variáveis ​​em uma expressão, elas devem ser precedidas pelo caractere @ (por exemplo, @row_number).

Variável	Descrição
algorithm_id	O ID exclusivo de um algoritmo
animation_end_time	Fim do intervalo de tempo geral da animação (como um valor de data e hora)
animation_interval	Duração do intervalo temporal geral da animação (como um valor de intervalo)
animation_start_time	Início do intervalo temporal geral da animação (como um valor de data e hora)
atlas_feature	A feição atual do atlas (como objeto de feição)
atlas_featureid	O ID da feição do atlas atual
atlas_featurenumber	O número atual da feição do atlas no layout
atlas_filename	O nome do arquivo do atlas atual
atlas_geometry	A geometria da feição do atlas atual
atlas_layerid	O ID da camada de cobertura do atlas atual
atlas_layername	O nome atual da camada de cobertura do atlas
atlas_pagename	O nome da página atual do atlas
atlas_totalfeatures	O número total de feições no atlas
canvas_cursor_point	A última posição do cursor na tela nas coordenadas geográficas do projeto
cluster_color	A cor dos símbolos em um cluster ou NULL se os símbolos tiverem cores misturadas
cluster_size	O número de símbolos contidos em um cluster
current_feature	A feição atualmente sendo editada no formulário de atributo ou na linha da tabela
current_geometry	A geometria da feição atualmente sendo editada no formulário ou na linha da tabela
current_parent_feature	representa a feição que está sendo editada no formulário pai. Apenas utilizável em um formulário incorporado pelo contexto.
geometria_parent_atual	representa a geometria da feição que está sendo editada no formulário pai. Apenas utilizável em formulário incorporado pelo contexto.
form_mode	Para que o formulário é usado, como AddFeatureMode, SingleEditMode, MultiEditMode, SearchMode, AggregateSearchMode ou IdentifyMode como string.
frame_duration	Duração temporal de cada quadro de animação (como um valor de intervalo)
frame_number	Número do quadro atual durante a reprodução da animação
frame_rate	Número de quadros por segundo durante a reprodução da animação
fullextent_maxx	Valor máximo de x da extensão completa da tela (incluindo todas as camadas)
fullextent_maxy	Valor y máximo da extensão total da tela (incluindo todas as camadas)
fullextent_minx	Valor mínimo de x da extensão completa da tela (incluindo todas as camadas)
fullextent_miny	Valor y mínimo da extensão completa da tela (incluindo todas as camadas)
geometry_part_count	O número de partes na geometria da feição renderizada
geometry_part_num	O número da parte da geometria atual para a feiição que está sendo renderizada
geometry_point_count	O número de pontos na parte da geometria renderizada
geometry_point_num	O número do ponto atual na parte da geometria renderizada
geometry_ring_num	Número do anel da geometria atual da feição sendo renderizado (para feições do tipo polígonos apenas). O anel exterior tem um valor de 0;
grid_axis	O eixo de anotação da grade atual (por exemplo, ‘x’ para longitude, ‘y’ para latitude)
grid_number	O valor atual da anotação da grade
item_id	O ID do usuário do item de layout (não necessariamente exclusivo)
item_uuid	O ID exclusivo do item de layout
layer	A camada atual
layer_crs NEW in 3.18	Autoridade do Sistema de Referência de Coordenadas da camada atual
layer_id	O ID da camada atual
layer_ids	Uma lista com os ID de todas as camadas de mapas no projeto atual
layer_name	O nome da camada atual
layers	Lista com todas as camadas no projeto atual
layout_dpi	A resolução da composição (DPI)
layout_name	O nome do layout
layout_numpages	O número de páginas no layout
layout_page	O número da página do item atual no layout
layout_pageheight	Altura da página atual no layout (em mm para tamanhos de papéis padrão, ou qualquer outra unidade sendo usada pelo tamanho de papel customizado)
layout_pageoffsets	Array de coordenadas do eixo Y de cada página. Permite posicionar itens dinamicamente nas páginas em um contexto em que os tamanhos das páginas podem mudar
layout_pagewidth	Largura da página atual no layout (em mm para tamanhos de papel padrão, ou outra unidade utilizada em tamanhos de papel customizado)
legend_column_count	O número de colunas na legenda
legend_filter_by_map	Indica se o conteúdo da legenda é filtrado pelo mapa
legend_filter_out_atlas	Indica se o atlas é filtrado para fora da legenda
legend_split_layers	Indica se as camadas podem ser divididas na legenda
legend_title	O título da lenda
legend_wrap_string	O(s) caractere(s) usados ​​para quebrar o texto da legenda
map_crs	O Sistema de referência de coordenadas do mapa atual
map_crs_acronym	A sigla do Sistema de referência de coordenadas do mapa atual
map_crs_definition	A definição completa do Sistema de referência de coordenadas do mapa atual
map_crs_description	O nome do Sistema de referência de coordenadas do mapa atual
map_crs_ellipsoid	A sigla do elipsóide do Sistema de referência de coordenadas do mapa atual
map_crs_proj4	A definição Proj4 do Sistema de referência de coordenadas do mapa atual
map_crs_projection NEW in 3.20	O nome descritivo do método de projeção usado pelo sistema de referência de coordenadas do mapa (por exemplo, ‘Albers Área Igual’)
map_crs_wkt	A definição WKT do Sistema de referência de coordenadas do mapa atual
map_end_time	O fim do intervalo de tempo temporal do mapa (como um valor de data e hora)
map_extent	A geometria que representa a extensão atual do mapa
map_extent_center	A feição de ponto no centro do mapa
map_extent_height	A altura atual do mapa
map_extent_width	A largura atual do mapa
map_id	O ID do destino atual do mapa. Será ‘canvas’ para renderizações de tela, e o ID do item para renderizações de mapa de layout
intervalo do mapa	A duração do intervalo de tempo temporal do mapa (como um valor de intervalo)
map_layer_ids	A lista de IDs da camada do mapa visíveis no mapa
map_layers	A lista de camadas do mapa visíveis no mapa
map_rotation	A rotação atual do mapa
map_scale	A escala atual do mapa
map_start_time	O início do intervalo de tempo temporal do mapa (como um valor de data e hora)
map_units	As unidades de medidas do mapa
model_path	Caminho completo (incluindo o nome do arquivo) do modelo atual (ou caminho do projeto se o modelo estiver incorporado em um projeto).
model_folder	Pasta que contém o modelo atual (ou pasta do projeto se o modelo estiver incorporado em um projeto).
model_name	Nome do modelo atual
model_group	Grupo para o modelo atual
notification_message	Conteúdo da mensagem de notificação enviada pelo provedor (disponível apenas para ações acionadas por notificações do provedor).
parent	Refere-se a feição atual na camada pai, fornecendo acesso aos seus atributos e geometria ao filtrar uma função aggregate
project_abstract	O resumo do projeto, extraído dos metadados do projeto
project_area_units	A unidade de área do projeto atual, usada no cálculo de áreas de geometrias
project_author	O autor do projeto, extraído dos metadados do projeto
project_basename	O nome base do nome do arquivo do projeto atual (sem caminho e extensão)
project_creation_date	A data de criação do projeto, extraída dos metadados do projeto
project_crs	O Sistema de referência de coordenadas do projeto
project_crs_arconym	A sigla do Sistema de referência de coordenadas do projeto
project_crs_definition	A definição completa do Sistema de referência de coordenadas do projeto
project_crs_description	A descrição do Sistema de referência de coordenadas do projeto
project_crs_ellipsoid	O elipsóide do Sistema de referência de coordenadas do projeto
project_crs_proj4	A representação do Proj4 do Sistema de referência de coordenadas do projeto
project_crs_wkt	A representação WKT (well known text) do Sistema de referência de coordenadas do projeto
project_distance_units	A unidade de distância para o projeto atual, usada no cálculo de comprimentos de geometrias e distâncias
project_ellipsoid	O nome do elipsóide do projeto atual, usado no cálculo de áreas geodésicas ou comprimentos de geometrias
project_filename	O nome do arquivo do projeto atual
project_folder	A pasta do projeto atual
project_home	O caminho inicial do projeto atual
project_identifier	O identificador do projeto, obtido dos metadados do projeto
project_keywords	As palavras-chave do projeto, extraídas dos metadados do projeto
project_last_saved	Data/hora em que o projeto foi salvo pela última vez.
project_path	O caminho completo (incluindo o nome do arquivo) do projeto atual
project_title	O título do projeto atual
project_units	As unidades do SRC do projeto
qgis_locale	O idioma atual do QGIS
qgis_os_name	O nome atual do sistema operacional, por exemplo, ‘windows’, ‘linux’ ou ‘osx’
qgis_platform	A plataforma QGIS, por exemplo, ‘desktop’ ou ‘servidor’
qgis_release_name	O nome da versão atual do QGIS
qgis_short_version	A string curta da versão atual do QGIS
qgis_version	A string de versão atual do QGIS
qgis_version_no	O número da versão atual do QGIS
row_number	Armazena o número da linha atual
snapping_results	Dá acesso aos resultados de encaixe ao digitalizar uma feição (disponível apenas no adicionar feição)
scale_value	O valor atual da distância da barra de escala
selected_file_path	Caminho de arquivo selecionado do seletor de widget de arquivo ao carregar um arquivo com um sistema de armazenamento externo
symbol_angle	O ângulo do símbolo usado para renderizar a feição (válido apenas para símbolos de marcador)
symbol_color	A cor do símbolo usado para renderizar a feição
symbol_count	O número de feições representadas pelo símbolo (na legenda do layout)
symbol_id	O ID interno do símbolo (na legenda do layout)
symbol_label	O rótulo do símbolo (um rótulo definido pelo usuário ou o rótulo gerado automaticamente por padrão - na legenda do layout)
symbol_layer_count	Número total de camadas de símbolo no símbolo
symbol_layer_index	Current symbol layer index
symbol_marker_column	Número da coluna para marcador (válido apenas para preenchimentos de padrão de ponto).
symbol_marker_row	Número da linha do marcador (válido apenas para preenchimentos de padrão de ponto).
user_account_name	O nome da conta do sistema operacional do usuário atual
user_full_name	O nome do usuário do sistema operacional do usuário atual
value	O valor atual
vector_tile_zoom	Nível exato de zoom do bloco vetorial do mapa que está sendo renderizado (derivado da escala do mapa atual). Normalmente no intervalo [0, 20]. Ao contrário de @zoom_nível, esta variável é um valor de ponto flutuante que pode ser usado para interpolar valores entre dois níveis de zoom inteiros.
with_variable	Permite definir uma variável para uso em uma expressão e evitar recalcular o mesmo valor repetidamente
@zoom_nível	Nivel de zoom do tile do vetor no mapa que está sendo renderizado (derivado da escala do mapa atual). Normalmente um intervalo [0,20].

Alguns exemplos:

• Retorna a coordenada X de um centro de item de mapa no layout:

  x( map_get( item_variables( 'map1'), 'map_extent_center' ) )
  

• Retorne, para cada feição na camada atual, o número de feições de aeroporto sobrepostas:

  aggregate( layer:='airport', aggregate:='count', expression:="code",
                 filter:=intersects( $geometry, geometry( @parent ) ) )
  

• Obtém o object_id do primeiro ponto ajustado de uma linha:

  with_variable(
    'first_snapped_point',
    array_first( @snapping_results ),
    attribute(
      get_feature_by_id(
        map_get( @first_snapped_point, 'layer' ),
        map_get( @first_snapped_point, 'feature_id' )
      ),
      'object_id'
    )
  )
  

12.2.27. Funções Recentes

Este grupo contém funções usadas recentemente. Dependendo do contexto de seu uso (seleção de feição, calculadora de campo, genérico), as expressões aplicadas recentemente são adicionadas à lista correspondente (até dez expressões), ordenadas de mais para menos recente. Isso facilita a rápida recuperação e reaplicação de expressões usadas anteriormente.