Percorre uma lista a fim de obter e/ou remover um de seus itens. 

Figura 1 - Bloco Na lista

Compatibilidade

• Bloco cliente e servidor: lists_getIndex()

Retorno

Retorna o valor do item que foi obtido e/ou removido da lista. Caso o item seja apenas removido, o bloco não retorna nenhum valor.

Parâmetros

Na lista

Lista a ser percorrida.

• Posição: 1
• Inglês: In list
• Tipo: Texto / String
• Exemplo: retorno do bloco criar lista

Obter

Define se um item da lista será obtido e/ou removido. 

• Posição: 2
• Inglês: Get
• Tipo: Objeto / Object
• Exemplo: "obter"
• Opções:
  • obter: obtém um um item da lista.
  • obter e remover: obtém um item da lista e, em seguida, o remove.
  • remover: remove um item da lista.

Nº

Define qual item da lista será obtido e/ou removido.

• Posição: 3
• Inglês: #
• Tipo: Objeto / Object
• Exemplo: "nº"
• Opções:
  • nº: define que o item da lista será obtido e/ou removido a partir do valor do índice informado. Exige que um valor inteiro seja passado como parâmetro.
  • nº a partir do final: funciona de forma semelhante à versão anterior, porém percorre a lista considerando a ordem inversa dos elementos. Exige que um valor inteiro seja passado como parâmetro.
  • primeiro: define que o primeiro item da lista será obtido e/ou removido.
  • último: define que o último item da lista será obtido e/ou removido.
  • aleatório: define que um item aleatório da lista será obtido e/ou removido.

Exemplo

Na função abaixo, a variável "lista" recebe o bloco criar lista, que criará um lista com três elementos. Em seguida, o bloco Na lista obterá e removerá o item da posição 2 da lista definida na variável "lista". Por fim, a lista resultante também será exibida por meio do bloco imprime. O resultado de execução pode ser visualizado no console do depurador.

Figura 2 - Exemplo de uso do bloco Na lista