Converte texto ou arquivo que contenha uma estrutura em formado de lista JSON para uma lista.
![](/download/attachments/234662511/blocoMapaParaLista.png?version=1&modificationDate=1683033874000&api=v2)
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.
![](/download/attachments/234662511/blocoMapaParaListaExemplo.png?version=1&modificationDate=1683033874000&api=v2)
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.
![](/download/attachments/234662511/blocoMapaParaListaResultado.png?version=1&modificationDate=1683033874000&api=v2)
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.