Sumário

Search

  1. Prefácio
  2. A Linguagem de Transformação
  3. Constantes
  4. Operadores
  5. Variáveis
  6. Datas
  7. Funções
  8. Criação de funções personalizadas
  9. Referência de API da Função Personalizada

Referência de Linguagem de Transformação

Referência de Linguagem de Transformação

Operador de subscrito

Operador de subscrito

Use um operador de subscrito para acessar elementos em um array ou map. Você pode acessar um elemento específico ou um intervalo de elementos em um array. Também é possível acessar o valor correspondente a uma determinada chave em um par de chave-valor de um map.

Sintaxe

Para acessar um elemento específico em um array, use a seguinte sintaxe:
array[ index ]
Para acessar um intervalo de elementos em um array, use a seguinte sintaxe:
array[ start_index , end_index ]
Para acessar o valor correspondente a uma determinada chave em um map, use a seguinte sintaxe:
map[ key ]
A seguinte tabela descreve os argumentos na sintaxe:
Argumento
Descrição
array
Array. O array do qual você deseja acessar um ou mais elementos.
É possível inserir qualquer expressão de transformação válida que seja avaliada como um array.
index
Número inteiro. A posição do elemento que você deseja acessar. Por exemplo, um índice de 0 indica o primeiro elemento em um array.
start_index
Número inteiro. O índice inicial em um intervalo de elementos que você deseja acessar. O operador de subscrito inclui o elemento que o índice inicial representa.
end_index
Número inteiro. O índice final em um intervalo de elementos que você deseja acessar. O operador de subscrito exclui o elemento que o índice final representa.
map
Map. O map do qual você deseja recuperar o valor correspondente a uma chave.
chave
Tipo de dados da chave. O elemento da chave para o qual você deseja recuperar o valor.
Você pode inserir qualquer expressão de transformação válida que seja avaliada como um valor de chave dos dados do map.
Você pode usar uma expressão para o índice que retorna um valor de número inteiro . Se a expressão retornar um valor negativo, o índice será considerado 0.
Se o índice especificado for maior que o tamanho do array menos 1, o índice acessará o elemento final no array.

Valor de retorno

Se você especificar um índice, a expressão retornará o elemento no array. O tipo de retorno é o mesmo que o tipo de dados do elemento do array especificado.
Se você especificar dois índices separados por uma vírgula, como
[i,j]
, a expressão retornará um array dos elementos de
i
para
j-1
. Se
i
for maior que
j
ou o tamanho do array, a expressão retornará um array vazio. A configuração de tipo do subarray que a expressão retorna é a mesma que a configuração de tipo do array especificado.
Se você especificar uma chave, a expressão retornará o valor associado à chave no map. O tipo de retorno é o mesmo que o tipo de dados do valor do map especificado.

Nulos

Se o índice no subscrito for maior que o tamanho do array, o operador de subscrito retornará um valor NULL.
Se o índice for NULL, o operador de subscrito retornará um valor NULL. Se você especificar vários índices, como
[i,j]
e ou
i
ou
j
for NULL, a expressão retornará NULL.
Se o arrr for NULL, o operador de subscrito retornará um valor NULL.
Se a chave não existir no map, o operador de subscrito retornará um valor NULL.

Exemplos

Você tem o seguinte array com elementos de string:
drinks = [‘milk’, ‘coffee’, ‘tea’, ‘chai’]
As expressões a seguir usam um operador de subscrito para acessar elementos de string do array:
Input Value
RETURN VALUE
drinks[0]
'milk'
drinks[2]
'tea'
drinks[NULL]
NULL
drinks[1,3]
['coffee','tea']
drinks[2,NULL]
NULL
drinks[3,1]
[ ]
Você tem o seguinte map com elementos de chave-valor do tipo cadeia-cadeia:
country_currency = [‘England’ -> ‘Pound’, ‘France’ -> ‘Euro’, ‘Japan’ -> ‘Yen’>, ‘USA’ -> ‘Dollar’]
Input Value
RETURN VALUE
country_currency [‘Japan’]
‘Yen’
country_currency [‘India’]
NULL
country_currency [‘England’]
‘Pound’