Polska dokumentacja programu Game Maker
Ostatnie uaktualnienie: 19.03.2007 00:00,
Tymon
Lists (czyli listy) są zbiorem wartości ustawionych w odpowiedniej kolejności. Możesz dodać wartość na końcu, albo gdzieś na jej środku. Możesz też adresować do poszczególnych elementów używając ich indeksów. Można sortować wszystkie elementy listy malejąco (DESC), albo rosnąco (ASC). Listy są zwykłymi tablicami jednowymiarowymi, ale działania na nich są znacznie szybsze od działań na tablicach. Obsługa list odbywa się za pomocą poniższych funkcji:
ds_list_create() Tworzy nową listę. Funkcja zwraca liczbę całkowitą, która jest identyfikatorem nowo stworzonej listy, pozwala on na dostęp do poszczególnych kolejek.
ds_list_destroy(id) Niszczy listę o podanym identyfikatorze, zwalniając też używaną przez nią pamięć. Pamiętaj o wykonaniu tej funkcji, gdy lista nie będzie już potrzebna.
ds_list_clear(id) Usuwa wszystkie wartości znajdujące się w liście, nie niszcząc jej.
ds_list_size(id) Zwraca ilość elementów znajdujących się w liście.
ds_list_empty(id) Sprawdza czy kolejka jest pusta - czyli gdy ilość znajdujących się w niej elementów jest równa 0.
ds_list_add(id, wartość) Dodaje wartości do listy.
ds_list_insert(id, pozycja, wartość) Dodaje wartości do listy w określonej pozycji. Pierwszą pozycją jest 0, a ostatnią wielkość listy minus 1.
ds_list_replace(id, pozycja, wartość) Nadpisuje wartość w określonej pozycji.
ds_list_delete(id, pozycja) Kasuje wartość z określonej pozycji.
ds_list_find_index(id, wartość) Szuka i zwraca pozycję określonej wartości w liście. W przypadku gdy dana wartość nie znajduje się w liście zwracane jest -1.
ds_list_find_value(id, pozycja) Zwraca wartość znajdującą się na określonej pozycji.
ds_list_sort(id, sortowanie) Sortuje wartości znajdujące się w liście. Jeśli sortowanie przyjmuje wartość true, lista będzie sortowana rosnąco (ASC), w przeciwnym wypadku malejąco (DESC).