JSONGetElement
Consulta em dados JSON um elemento especificado por um nome de objeto, um índice de matriz ou um caminho.
Formato
JSONGetElement ( json ; ChaveOuÍndiceOuCaminho )
Parâmetros
json - qualquer expressão de texto ou campo que contém um objeto ou matriz JSON.
chaveOuÍndiceOuCaminho - qualquer expressão de texto ou campo que especifica um nome de objeto (chave), um índice de matriz ou caminho JSON. Consulte Utilização das funções JSON.
Tipo de dados retornado
texto, número
Originada na versão
16.0
Descrição
Se o valor JSON em ChaveOuÍndiceOuCaminho for um número ou um booleano, a função retornará um número; caso contrário, retornará texto.
Exemplo 1
JSONGetElement ( "{ \"a\" : 11, \"b\" : 22, \"c\" : 33 }" ; "b" ) retorna 22 como um número.
Exemplo 2
JSONGetElement ( "[ true, false, true ]" ; 1 ) retorna 0 (falso) como um número.
Exemplo 3
JSONGetElement ( "[ 1, 2, 3, 5 ]" ; "[:]" ) retorna 5 usando "[:]" para se referir ao último elemento da matriz.
Exemplo 4
A partir dos Exemplo de dados JSON armazenados na variável $$JSON, obtém o valor do objeto "nome" do segundo objeto "produto" na matriz.
JSONGetElement ( $$JSON ; "padaria.produto[1]name" ) retorna Bolo de chocolate como texto.
Exemplo 5
Se a variável $$JSON estiver definida como
{
"padaria" :
{
"produto" :
[
{
"product.id" : "FB1",
"product.name" : "Rosquinhas",
"preço": 1.99,
"estoque" : 43,
"product.category" : "Pães",
"desconto" : true
}
]
}
}então, JSONGetElement ( $$JSON ; "['padaria']['produto'][0]['product.name']" ) retornará Rosquinhas como texto, que é o valor da chave "product.name" do primeiro objeto de "produto" na matriz. Como o nome da chave inclui um ponto, o parâmetro chaveOuÍndiceOuCaminho será escrito com a notação de colchetes.