Redcode - samouczek

Dużą pomocą przy pisaniu programu są komentarze i etykiety. Etykietą jest ciąg znaków alfanumerycznych zaczynający się literą. Etykiety mogą też zawierać znak podkreślenia (_) i służą do oznaczania nimi konkretnych komórek, co ułatwia orientację w programie, a także wprowadzanie poprawek w kodzie. Komentarzem jest każdy tekst po znaku średnika (;) aż do znaku końca linii. Są jednak wyjątki związane z pMARSem. Oto one:
- ;redcode - linia z tym komentarzem rozpoczyna kompilację przez pMARSa. Najlepiej, gdy jest pierwszą linią w całym pliku.
- ;name Wojownik - ustala nazwę programu wojownika.
- ;author Imię Nazwisko - ustala autora programu.
- ;strategy cośtam - miejsce na komentarz, używany na terenie KOTHa. Pierwotnym przeznaczeniem było określenie strategii programu.
- ;assert wyrażenie - ta linia ustala warunki, przy jakich będzie wykonana kompilacja (wyrażenie musi być prawdą logiczną). Pozwala to na uruchamianie wojownika tylko w takich walkach, gdy spełnione będą warunki określone w wyrażeniu. Przykładowo, ;assert CORESIZE>=8000 uruchomi wojownika tylko, gdy wielkość areny będzie większa lub równa 8000 komórek. Jeśli chcemy być niezależni od warunków walki, najlepiej napisać ;assert 1, wtedy kompilacja następuje zawsze.
Są jeszcze ;trace, ;break i ;debug, ale nie przytoczę ich (bo... ich nie używam ;).

Ważnym rozszerzeniem Redcode są tzw. pseudoinstrukcje, czyli instrukcje nie stanowiące "ciała" wojownika, ale sterujące kompilacją. Oto one (wyrażenia w nawiasach kwadratowych nie są wymagane):
- pseudoinstrukcja END [etykieta] - kończy kompilację programu-wojownika. Etykieta podana po pseudoinstrukcji określa instrukcję, która będzie pierwszą wykonywaną instrukcją wojownika. Częstym błędem początkujących rycerzy może być pomijanie tej pseudoinstrukcji (nie jest ona wymagana) podczas gdy pierwszą instrukcją wojownika jest DAT. Wtedy program-wojownik wykonuje na samym początku tę instrukcję, w skutek czego ginie.
- pseudoinstrukcja EQU - definiuje etykietę, która (napotkana w tekście programu-wojownika) jest zamieniana na zdefiniowany tekst podczas kompilacji. Możliwe jest "podstawienie" nawet kilku linijek tekstu pod jedną etykietę (może to być np. często używany kawałek kodu). Użycie:
[etykieta] EQU cośtam
[EQU cośtaminnego]
- pseudoinstrukcja FOR - pętla kompilatora. Użycie:
[zmienna] FOR wyrażenie
...
ROF
Kawałek kodu pomiędzy instrukcją otwierającą FOR a zamykającą pętlę ROF jest powtarzany tyle razy, jaka jest wartość wyrażenia. Może to być zwykła liczba, może też być skomplikowane wyrażenie matematyczne lub logiczne. Opcjonalna zmienna zawiera numer kolejnego przebiegu, czyli właściwie jest licznikiem tej pętli. Może kilka przykładów:
N FOR 5 ; pięć instrukcji DAT pod rząd
kom&N DAT $0, $0 ; dobre do robienia większych
ROF ; przerw w kodzie programu-wojownika
; dodatkowo kom&N spowoduje, ze kolejne komórki
; będą miały etykiety: kom01, kom02 itd.
FOR (CORESIZE==8000)
MOV $-1, <-1 ; ten kawałek jest kompilowany dla
JMP $-1, <-2 ; rdzenia o wielkości 8000 komórek
ROF
FOR (CORESIZE!=8000)
MOV $-1, <-1 ; a ten dla rdzenia
MOV $-2, <-2 ; o innej wielkości
JMP $-2
ROF
lic FOR 4*4+70/3-1 ; pętla z użyciem licznika
CMP 5*lic, 5*lic+3 ; coś podobnego używane jest
JMP -(2*lic)-3 ; w tzw. szybkich skanerach
ROF
FOR 0
a tu ciekawostka: komentarz w pustej pętli
(ta pętla nie kompiluje się wcale!)
ROF
- pseudoinstrukcja ORG etykieta - wyznacza pierwszą instrukcję programu-wojownika. Jest w tym sensie podobna do END, z tym, że powinna być raczej na początku kodu, nie na końcu. Poza tym nie powinno być sprzeczności między ustaleniami ORG i END. Osobiście nie używam ORG, ale zalecam opuścić etykietę w instrukcji END, jeśli używa się ORG.
- pseudoinstrukcja PIN liczba - ustala numer identyfikacyjny P-przestrzeni. Pozwala to na współdzielenie tej samej P-przestrzeni przez różnych wojowników.

pMARS ma ustalony zestaw operacji matematycznych i stałych używanych podczas kompilacji. Zawarte one są w pliku redcode.ref, podobnie jak spis rozkazów, modyfikatorów i trybów adresowania, a także pMARSowska gramatyka. Oto stałe:
- CORESIZE - liczba komórek w rdzeniu
- MAXPROCESSES - maksymalna liczba procesów w jednym programie
- MAXCYCLES - czas trwania rundy (walki) w cyklach zegara, po którym ogłaszany jest remis
- MAXLENGTH - maksymalna długość programu wojownika
- MINDISTANCE - minimalna odległość między walczącymi programami na początku walki
- ROUNDS - ilość rund (walk)
- PSPACESIZE - rozmiar P-przestrzeni
- CURLINE - obecnie kompilowana linia licząc od zera
- VERSION - wersja pMARSa (np. "60" oznacza wersję 0.6.0)
- WARRIORS - liczba wojowników biorących udział w walkach
A oto operacje matematyczne (w kolejności priorytetowej od najważniejszych):
- ! negacja logiczna, + liczba dodatnia, - liczba ujemna
- * iloczyn (mnożenie), / iloraz (dzielenie), % dzielenie modulo (reszta z dzielenia)
- + suma (dodawanie), - różnica (odejmowanie)
- == równość, != nierówność, < mniejsze, > większe, <= mniejsze równe, >= większe równe
- && "i" logiczne
- || "lub" logiczne
- = przypisanie wartości zmiennym
Dozwolone jest używanie nawiasów okrągłych w wyrażeniach matematyczno-logicznych.


Poprzedni