Funções em expressões JPath

Algumas funções básicas podem ser usadas em expressões JPath, como usar uma função como parte de uma consulta.

A tabela a seguir mostra as funções básicas que podem ser usadas em expressões JPath.
Tabela 1. Funções
Funções Descrição
contagem (caminho) Retorna o número de itens em uma expressão de caminho específica.
  • Para um objeto, retorna o número de membros.
  • Para uma matriz, retorna o número de elementos de matriz.
  • Para uma sequência, retorna o comprimento da sequência.
base64_encode(expr) Retorna o valor codificado com base64 de uma expressão específica.
base64_decode(expr) Retorna o valor decodificado com base64 de uma expressão específica.
url_encode (expr) Retorna o valor codificado por URL de uma expressão específica.
url_decode (expr) Retorna o valor decodificado de URL de uma expressão específica.
min (caminho) Retorna o valor mínimo de uma matriz em uma expressão de caminho específica.
max (caminho) Retorna o valor máximo de uma matriz em uma expressão de caminho específica.
time() Retorna o tempo em milissegundos desde a época.
Novo em V2 trunc (expr) Retorna o valor truncado de uma expressão numérica específica.
Novo em V2 round (expr) Retorna o valor arredondado de uma expressão numérica específica.
Novo em V2 piso (expr) Retorna o piso de uma expressão numérica específica.
Novo em V2 ceil (expr) Retorna o teto de uma expressão numérica específica.
Novo em V2 random_number () Retorna um número de ponto flutuante aleatório entre 0,0 e 1,0.
Novo em V2 substring (expr, começar, terminar) Retorna a subsequência de uma expressão específica.
Novo em V2 esquerda (expr, comprimento) Retorna a parte esquerda de uma expressão específica.
Novo em V2 direita (expr, comprimento) Retorna a parte direita de uma expressão específica.
Novo em V2 superior (expr) Retorna o valor maiúsculo de uma expressão específica.
Novo em V2 inferior (expr) Retorna o valor minúsculo de uma expressão específica.
Novo em V2 random_string (comprimento) Retorna uma sequência aleatória de caracteres alfabéticos latinos (a-z, A-Z).
Novo em V2 vazio (caminho) Retorna true se o valor em uma expressão de caminho específica estiver vazio.
Novo em V2 pad_left (expr, length, padValue) Retorna o valor preenchido à esquerda de uma expressão específica.
Novo em V2 pad_right (expr, length, padValue) Retorna o valor preenchido à direita de uma expressão específica.
Novo em V2 range (begin, end) Retorna um intervalo de números como uma matriz.
Novo em V2 chaves (caminho) Retorna as chaves do objeto em uma expressão de caminho específica.
Novo em V2 valores (caminho) Retorna os valores do objeto em uma expressão de caminho específica.
Novo em V2 entradas (caminho) Retorna as entradas do objeto em uma expressão de caminho específica.

A tabela a seguir mostra exemplos de funções básicas que podem ser usadas em expressões JPath.

Tabela 2. Exemplos de função
Exemplo Descrição Estado Expressão Resultado
Função na consulta Usa uma função como parte de uma consulta. { "array": [ { "id": 1, "timestamp": 1186978597 }, { "id": 2, "timestamp": 1286978597 }, { "id": 3, "timestamp": 17586978597 } ] } /array[@timestamp > time()] [ { "id": 3, "timestamp": 17586978597 } ]
Localize um evento com o maior registro de data e hora Usa a função max() em combinação com uma matriz gerada de números. { "array": [ { "id": 1, "timestamp": 1186978597 }, { "id": 2, "timestamp": 1286978597 }, { "id": 3, "timestamp": 17586978597 } ] } max(/array/timestamp) 17586978597