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

Open

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.

Open

Nesta página