Lijsten (Lists)

Een lijst slaat een verzameling van waarden in een bepaalde volgorde op. Je kunt waarden aan het eind of ergens in het midden van de lijst toevoegen. Je kunt de waarden met behulp van een index opzoeken. Ook kun je de elementen in een oplopende of aflopende volgorde sorteren. De lijsten kunnen in veel opzichten worden gebruikt, bijvoorbeeld om veranderende verzamelingen van waarden op te slaan. Zij worden uitgevoerd door eenvoudige series maar als dit in een samengestelde code wordt gedaan gaat het sneller dan wanner jezelf een serie maakt. De volgende functies zijn beschikbaar:

ds_list_create() Creëert een nieuwe lijst. De functie geeft een geheel als een id terug die in alle andere functies moet worden gebruikt om tot deze lijst toegang te hebben.
ds_list_destroy(id) Vernietigt de lijst met bepaalde id, waardoor het gebruikte geheugen weer vrij komt. Vergeet niet om deze functie te gebruiken wanneer je met de structuur klaar bent.
ds_list_clear(id) Ontruimt de lijst met bepaalde id, die alle gegevens verwijdert uit de lijst maar deze niet vernietigt.
ds_list_size(id) Geeft het aantal waarden terug die in de lijst zijn opgeslagen.
ds_list_empty(id) Geeft terug of de lijst leeg is. Dit is hetzelfde als testen of het aantal waarden in de lijst 0 is.
ds_list_add(id, val) Voegt een waarde aan het eind van de lijst toe.
ds_list_insert(id, pos, val) Voegt een waarde bij positie pos aan de lijst toe. De eerste positie is positie 0, laatste is de grootte minus 1.
ds_list_replace(id, pos, val) Vervangt de waarde bij positie pos in de lijst met de nieuwe waarde.
ds_list_delete(id, pos) Schrapt de waarde bij positie pos in de lijst. (Positie 0 is het eerste element.)
ds_list_find_index(id, val) Vind de positie waar de vermelde waarde is opgeslagen. Als de waarde niet in lijst staat, word -1 teruggegeven.
ds_list_find_value(id, pos) Geeft de waarde die bij de vermelde positie in de lijst staat terug.
ds_list_sort(id, ascend) Sorteert de waarden in de lijst. Wanneer ascend is true, worden de waarden gerangschikt in oplopende volgorde, anders in aflopende volgorde.