Converte texto ou arquivo que contenha uma estrutura em formado de lista JSON para uma lista.

Figura 1 - Bloco Mapa para lista

Compatibilidade

• Bloco servidor: cronapi.map.Operations.toList()

Retorno

Retorna uma lista.

Parâmetros

Valor a ser lido

String ou arquivo (retorno do bloco Abrir arquivo para leitura) a ser convertido para o formato lista.

• Posição: 1
• Inglês: Value to be read
• Tipo: Texto ou Arquivo / String or File
• Exemplo: "[["João",15],["Maria",19]]"

Exemplo 

Na função abaixo, a variável "item" recebe uma string contendo uma lista em formato de texto com duas sublistas. O primeiro bloco de repetição para cada item na lista percorre a variável "item" e imprime no console do depurador o resultado obtido. No segundo bloco de repetição, inserimos o bloco Mapa para lista, que converte a variável "item" para um objeto lista e em seguida imprime no console do depurador cada item obtido. Na Figura 2.1 vemos a diferença dos resultados obtidos.

Figura 2 - Exemplo de uso do bloco Mapa para lista

Na figura a seguir, os valores acima da linha tracejada correspondem ao resultado obtido pelo primeiro bloco de repetição da função da Figura 2. Neste caso, o bloco não identificou a variável "item" como um objeto lista e, por isso, não foi possível obter como resultado as sublistas que a compõem. Já no segundo resultado, abaixo da linha tracejada, foi utilizado o bloco Mapa para lista. Este bloco converte uma string em lista, permitindo que as sublistas sejam acessadas e iteradas corretamente pelo bloco de repetição. Dessa forma, conseguimos obter como resultado as duas sublistas da lista principal.

Figura 2.1 - Resultado exibido a partir das configurações da Figura 2

Saiba mais

Uma lista é uma coleção que permite elementos duplicados e mantém uma ordenação específica desses elementos. Por essa característica, quando percorre-se uma lista, sabe-se que os elementos serão encontrados em uma ordem pré-determinada, definida na hora da inserção dos mesmos. Uma lista é uma alternativa a um array comum.