Akcesory - listy, mapy, gridy, structy, tablice

Wtorek, 08 Listopada 2022, 15:24
Czas czytania 4 minuty, 36 sekund
Zgodne z GM: gms2
Sposób na znacznie łatwiejszy - a także bezpieczniejszy - odczyt danych z list, map, gridów, struktur i tablic.
GameMaker posiada kilka nietypowych elementów składniowych umożliwiających dostęp do list, map, gridów, struktur i tablic, które nie tylko ułatwiają ich odczyt dzięki krótszemu zapisowi, ale też pozwalają na uniknięcie wyświetlenia ekranu błędu.

Wskazówka:
Przed wydaniem 2.3 GameMaker Studio, wiele funkcji ds_ powodowało błąd krytyczny, jeśli dany wpis nie istniał w strukturze. Obecnie jednak zwracają one typ undefined gdy wartości brak, co mocno ułatwia pracę

Mapy - [# key]ds_map to nic innego jak tablica haszy, gdzie kluczami mogą być nie tylko liczby, ale też tekst.
Odpowiedniki składni za pomocą akcesorów to:

ds_map_set(map, key, value) zapisujemy jako map[? key] = value

ds_map_find_value(map, key) zapisujemy jako map[? key]


key może być "tekstem" lub liczbą całkowitą.

Listy - [| index]Listy są bardzo podobne do tablic, ale posiadają opcję znajdywania pozycji na której jest dana wartość, czy pomieszania elementów.
Odpowiedniki składni za pomocą akcesorów to:

ds_map_set(map, key, value) zapisujemy jako map[? key] = value

ds_map_find_value(map, key) zapisujemy jako map[? key]


index jest zawsze liczbą całkowitą.

Wskazówka:
Od wersji 2022.11 GameMakera, tablice posiadają nowe funkcje (znajdywanie elementu, sortowanie) które pozwalają zbliżyć je do list, jeśli nie potrzebujemy losowania warto korzystać z tablic, ponieważ są zbierane przez garbage collector

Gridy - [# x, y]Gridy są bardzo podobne do tablic 2D, ale posiadają opcję ustawiania/zbierania danych z obszarów (prostokąt, koło).
Odpowiedniki składni za pomocą akcesorów to:
ds_grid_add(index, x, y, val) zapisujemy jako grid[# x,y] = value

ds_grid_get(index, x, y) zapisujemy jako grid[# x,y]

x, y są zawsze liczbami całkowitymi.

Wskazówka:
Jeśli wyjdziemy poza rozmiar grida, w konsoli "Ouput" GMa zobaczymy komunikat Grid 0, index out of bounds writing [1,1] - size is [1,1]

Struct - [$ property]Struktury są "lekkimi obiektami", konterem pozwalającym przetrzymywać dane. Poza notacją struct.property, możemy też odczytywać dane za pomocą akcesorów:

struct.property = value oraz variable_struct_set(struct, "property", value) zapisujemy jako struct[$ "property"] = value

Pobieranie struct.property oraz variable_struct_get(struct, "property") zapisujemy jako struct[$ property]



Jak już wspomniałem, struktury są lekkimi obiektami - dlatego też, powyższa składnia działa także dla instancji obiektów:

instance.property = value oraz variable_instance_set(instance, property, value) zapisujemy jako instance[$ property] = value

Pobieranie instance.property oraz variable_instance_get(instance, property) zapisujemy jako instance[$ property]


property powinno być albo "tekstem", albo zmienną która przetrzymuje tekst.

Wskazówka:
Dzięki temu, że [$ ] pozwala na ustawienie dowolnego tekstu, możliwe jest tworzenie zmiennych ze spacjami możliwych do odczytania tylko przez akcesory i funkcje "variable_".

Tablice - [@ index]Wskazówka:
Dotyczy wszystkich wersji GameMakera przed 2022.1, a nowszych jedynie, jeśli w opcjach projektu zaznaczymy checkbox "Copy on write"
Grafika: /upload/ajax/20221108_73f27b239fdf5dc04803fa3674f96df9.png

W przypadku mechanizmu "copy on write" GameMaker nie modyfikuje tablic przekazanych do funkcji, a tworzy ich kopie i zmienia dane w nich, np.

kodfunction change_array(array) {
array[0] = 1; // tworzy kopię tablicy array jako ukrytą "tymczasową" zmienną i to jej ustawia wartość 1
return array;
}

var b = change_array([0]);

show_debug_message(a); // zwraca [0]
show_debug_message(b); // zwraca [1]

Aby w tym przypadku zmodyfikować oryginalną tabloicę, należałoby napisać:

kodarray[@ 0] = 1;
Warto zaznaczyć, że jeśli nie zmieniamy tablicy w funkcji, to return zwróci nam oryginalną tablicę. Trzeba więc uważać, bo kod taki jak:

kodfunction change_array(array) {
if (irandom(1) == 0) {
array[0] = array[0];
}
return array;
}
Losowo zwróci nam raz referencję do tej samej tablicy, a raz jej kopię. Stąd też w nowszych wersjach zrezygnowano z tego mechanizmu, gdyż stawia on pułapki dla nieświadomych początkujących programistów, a wprowadzono funkcję array_copy().

Łańcuchowe kojarzenie akcesorów (GM 2.3+)Nic nie stoi na przeszkodzie, aby jeden typ danych wstawiać w inny, a potem odczytywać go "łańcuchowo":

koda[? "key"][| 5][# 10, 12][$ "prop"][? "level"]
---

Jak łatwo zapamiętać akcesory?
Jest na to prosty sposób - należy wykorzystać wyobraźnię.

Listy powinny się kojarzyć z czymś wypisanym z góry na dół, z numeracją w jednej linii, stąd znak pionowej lini - |
Mapy powinny się skojarzyć z mapą skarbu, gdzie znakiem zapytania oznaczono poszukiwaną skrzynię - ?
Gridy powinny się skojarzyć z tablicą w której szukamy konkretnej komórki - stąd krzyżyk - #
Structy powinny się kojarzyć z pierwszą literą - "s", którą jednak zapisujemy jako podobny znak specjalny - $
Tablice tak samo jak structy, skojarzmy z pierwszą literą słowa "array" i też zapiszmy jako znak specjalny podobny do "a" - @

[ALIGN=center]Grafika: /upload/ajax/akcesory.png[/ALIGN]

Komentarze (łącznie 0):
Nie ma jeszcze żadnego komentarza. Czas to zmienić

Najnowsze wersje GameMakera:

Stabilna
2024.11.0.179 • 2024.11.0.227
wydana 34 dni temu
LTS
2022.0.3.85 • 2022.0.3.99
wydana 50 dni temu
Beta
2024.1300.0.720 •
2024.1300.0.733
 0.14.0

wydana  6 dni temu
= IDE, = Runtime, = GMRT
Użytkownicy online
1 użytkownik aktywny:
gości: 1,
(~ostatnie 15 minut)
Discord
Shoutbox
Wojo (10:25, 27.12.24)
Jak tworzyłeś* ah ta niecną autokorekta (kiedyś też stworzyłem apki na androida w sumie)
Wojo (10:23, 27.12.24)
O siemka baca, czasami myślę o tobie w kontekście tego jak tworzyłem apki na androida. Swoją drogą czasami zapominam, że forum istnieje bo cały ruch teraz utrzymuje się na discordzie, ale pora to zmienić!
Uzjel (20:17, 10.12.24)
Cały ruch przeniósł się na Discorda.
MagnusArias (17:43, 01.12.24)
O matko... a ja tutaj jestem od ponad 15 lat i czasami zaglądam... biernie bo biernie, ale czasem wpadnę
gnysek (11:46, 17.11.24)
Witamy, witamy!
baca (12:22, 16.11.24)
To już 25 lat.. Witam po paru latach nieobecności.
gnysek (11:05, 15.11.24)
Natomiast obecne forum istnieje od 2004, jak z iglu.cz na gmclan.org przeszliśmy i od tego czasu nie było resetów danych.
gnysek (12:35, 13.11.24)
Ogólnie GMCLAN istnieje 22 lata, ale na to trofeum nie zrobiłem (jeszcze xD)
Chell (20:41, 08.11.24)
wow, ta emotka w ogóle nie wygląda jak : O xD
Chell (20:40, 08.11.24)
tylko? :O 4tk ma 15
Starsze wpisy znajdziesz w Archiwum.
Ankieta
Ile zarobiłeś do tej pory na grach stworzonych w GM?