Listas são estruturas de dados organizadas através da enumeração de dados. Em oposição aos vetores que são estruturas de dados estáticas, as listas são estruturas de dados dinâmicas podendo variar de tamanho desde apenas um byte até encher uma memória RAM inteira. As listas são muito usadas para evitar desperdício de memória. O BlitzMax possui comandos específicos que tratam exclusivamente de listas.
Criando uma lista
Usa-se o comando CreateList para se criar uma lista, o nome da variável tipo lista será minhaLista.
minhaLista=CreateList()
Adicionando itens
Com a lista criada, agora precisamos fazer uso dela, para isso inicialmente vamos adicionar alguns itens na lista, podemos adicionar itens no início ou no final da lista. Claro, se a lista estiver vazia adicionar no início ou no fim não fará a menor diferença.
Adicionando no início
Para adicionarmos um valor no início da lista usamos o comando ListAddFirst, no primeiro parâmetro temos a lista a qual queremos adicionar o item, no segundo campo temos o item em si. No BlitzMax utilizamos também o comando EachIn para percorrer cada membro da lista dentro do For.
minhaLista=CreateList()
ListAddFirst(minhaLista, "um")
ListAddFirst(minhaLista, "dois")
ListAddFirst(minhaLista, "tres")
For minhaString$=EachIn minhaLista
Print(minhaString$)
Next
Os elementos foram exibidos na seguinte ordem: três (último a ser colocado), dois (segundo a ser colocado), um (primeiro a ser colocado). A ordem de inserção dos elementos foi trocada porque eles foram adicionados sempre ao início da lista.
Adicionando no final
Para adicionarmos um valor no final da lista usamos o comando ListAddLast, no primeiro parâmetro temos a lista a qual queremos adicionar o item, no segundo campo temos o item em si.
minhaLista=CreateList()
ListAddLast(minhaLista, "um")
ListAddLast(minhaLista, "dois")
ListAddLast(minhaLista, "tres")
For minhaString$=EachIn minhaLista
Print(minhaString$)
Next
Os elementos foram exibidos na seguinte ordem: um (primeiro a ser colocado), dois (segundo a ser colocado), três (terceiro a ser colocado). Apesar da inserção dos códigos estar na mesma ordem do código anterior, os elementos foram exibidos na ordem contrária, já que foram adicionados ao final da lista.
Ordenando uma lista
A ordenação é a forma de organizar a lista, ela pode ser com inteiros, strings ou floats em ordem crescente ou decrescente. No BlitzMax utiliza-se o comando SortList para ordenar as listas, o primeiro parâmetro é o nome da lista a ser ordenada, o segundo parâmetro é o tipo da ordenação True (se for crescente) ou False (se for decrescente)
minhaLista=CreateList()
ListAddLast(minhaLista, "B")
ListAddLast(minhaLista, "A")
ListAddLast(minhaLista, "C")
SortList(minhaLista, True)
For minhaString$=EachIn minhaLista
Print(minhaString$)
Next
Após a ordenação os elementos foram exibidos na seguinte ordem: A, B, C.
Contando elementos de uma lista
Você pode saber quantos elementos tem em uma lista através da função CountList que irá retornar um inteiro, use a própria lista como parâmetro.
minhaLista=CreateList()
ListAddLast(minhaLista, "B")
ListAddLast(minhaLista, "A")
ListAddLast(minhaLista, "C")
For minhaString$=EachIn minhaLista
Print(CountList(minhaLista)
Next