public static class Skript.PremennéSkriptu extends Object
Táto trieda uchováva a pracuje s mapami premenných skriptov. Jedna inštancia reprezentuje unikátny priestor premenných, v ktorom môžu byť uchované premenné, ktoré sú lokálne, globálne, obzorové, prípadne iné. Vždy je definovaný jeden hlavný (globálny) priestor premenných, s ktorým sa pracuje napríklad vtedy, keď prehľadávanie v ostatných aktívnych priesoroch zlyhá (pri čítaní premenných; pričom nie je zaručené, že premenná je definovaná v hlavnom priestore – ide len o stanovenie hierarchie prehľadávania).
Modifikátor a typ | Metóda a opis |
---|---|
Object |
citaj(String názov,
Class<?> typ)
Alias pre
čítaj . |
Object |
čítaj(String názov,
Class<?> typ)
Zistí hodnotu premennej zadaného údajového typu, ktorá
by mala byť definovaná v tomto priestore premenných
skriptu.
|
static Skript.PremenneSkriptu |
dajObzor(String názovObzoru)
Vráti pomenovaný priestor premenných skriptov, ktorý je
v tomto programovacom rámci označovaný termínom „obzor.“ Ak
priestor nejestvuje, tak je automaticky vytvorený.
|
boolean |
existuje(String názov,
Class<?> typ)
Alias pre
jestvuje . |
boolean |
jestvuje(String názov,
Class<?> typ)
Zistí, či je premenná so zadaným názvom a typom
definovaná v tomto priestore premenných skriptu.
|
static Skript.PremenneSkriptu |
novyPriestor()
Alias pre
novýPriestor . |
static Skript.PremenneSkriptu |
novýPriestor()
Vytvorí nový priestor premenných skriptov.
|
static boolean |
obzorExistuje(String názovObzoru)
Alias pre
obzorJestvuje . |
static boolean |
obzorJestvuje(String názovObzoru)
Zistí, či je definovaný pomenovaný priestor skriptov zvaný
„obzor“ (pozri aj
dajObzor ). |
void |
vymaz()
Alias pre
vymaž . |
void |
vymaz(String názov,
Class<?> typ)
Alias pre
vymaž . |
void |
vymaž()
Odstráni všetky premenné v tomto priestore premenných skriptov.
|
void |
vymaž(String názov,
Class<?> typ)
Vymaže definíciu premennej zadaného údajového typu, ak
je definovaná v tomto priestore premenných skriptu.
|
void |
zapis(String názov,
Object hodnota)
Alias pre
zapíš . |
boolean |
zapíš(String názov,
Object hodnota)
Nastaví novú hodnotu premennej v tomto priestore
premenných skriptu.
|
Zoznam<String> |
zoznam(Class<?> typ)
Vytvorí zoznam premenných, ktoré sú definované v tomto
priestore premenných skriptu so zadaným údajovým typom.
|
public Zoznam<String> zoznam(Class<?> typ)
Vytvorí zoznam premenných, ktoré sú definované v tomto
priestore premenných skriptu so zadaným údajovým typom. Ak
je zadaný údajový typ neplatný (nepovolený, resp.
nepodporovaný), tak je namiesto zoznamu vrátená hodnota
null
. Ak je vrátený prázdny zoznam reťazcov,
tak to znamená, že v tomto priestore premenných nie je
definovaná žiadna premenná so zadaným údajovým typom.
Poznámka: Názvy premenných nie sú
citlivé na veľkosť písmen. Ich zoznamy sú konštruované
pomocou parametra String
.
String.CASE_INSENSITIVE_ORDER
.
typ
– typ premenných zoznamu – povolené sú len:
Double.class
, Color.class
,
Poloha.class
a String.class
null
public boolean jestvuje(String názov, Class<?> typ)
Zistí, či je premenná so zadaným názvom a typom definovaná v tomto priestore premenných skriptu.
názov
– názov premennejtyp
– typ premennej – povolené sú: Double.class
, Color.class
, Poloha.class
alebo String.class
true
;
ak premenná nejestvuje alebo bol zadaný nepovolený
údajový typ premennej, tak je návratovou hodnotou
tejto metódy hodnota false
Skript.premennáJestvuje(String, Trieda)
public Object čítaj(String názov, Class<?> typ)
Zistí hodnotu premennej zadaného údajového typu, ktorá
by mala byť definovaná v tomto priestore premenných
skriptu. Ak taká premenná nie je definovaná, tak bude
návratová hodnota tejto metódy rovná hodnote
null
.
názov
– názov premennejtyp
– typ premennej – povolené sú: Double.class
, Color.class
,
Poloha.class
alebo String.class
null
Skript.čítajPremennú(String, Trieda)
public boolean zapíš(String názov, Object hodnota)
Nastaví novú hodnotu premennej v tomto priestore
premenných skriptu. Ak je zadaná hodnota nepovoleného
údajového typu, tak nebude nastavená hodnota žiadnej
premennej. To isté platí pri pokuse o zapísanie hodnoty
null
alebo pri pokuse o nastavenie premennej
s prázdnym menom. Úspešnosť (resp. neúspešnosť) nastavenia
hodnoty premennej potvrdzuje návratová hodnota tejto
metódy – true
(úspech) / false
(neúspech).
Poznámka: Táto metóda automaticky definuje nejestvujúce premenné.
názov
– názov premennejhodnota
– hodnota premennej povoleného údajového typu –
povolené sú: Double
,
Color
, Poloha
alebo
String
true
, tak bola zadaná hodnota zapísaná do
premennej prislúchajúceho údajového typu, v opačnom
prípade je návratová hodnota rovná false
Skript.zapíšPremennú(String, Object)
public void vymaž(String názov, Class<?> typ)
Vymaže definíciu premennej zadaného údajového typu, ak je definovaná v tomto priestore premenných skriptu.
názov
– názov premennejtyp
– typ premennej – povolené sú: Double.class
, Color.class
,
Poloha.class
alebo String.class
Skript.vymažPremennú(String, Trieda)
public void vymaž()
Odstráni všetky premenné v tomto priestore premenných skriptov. Po vykonaní tejto metódy bude tento priestor premenných skriptov prázdny.
public void vymaz()
Alias pre vymaž
.
public static Skript.PremenneSkriptu novýPriestor()
Vytvorí nový priestor premenných skriptov. Interpreter skriptov túto metódu využíva na vytvorenie nového priestoru pri každom vstupe (vnorení) do vnoreného bloku.
public static Skript.PremenneSkriptu novyPriestor()
Alias pre novýPriestor
.
public static boolean obzorJestvuje(String názovObzoru)
Zistí, či je definovaný pomenovaný priestor skriptov zvaný
„obzor“ (pozri aj dajObzor
). Metóda
vráti true
len vtedy, ak priestor jestvuje. Pozor,
pri zadaní prázdneho názvu obzoru vráti metóda vždy hodnotu
true
, pretože prázdne meno má význam globálneho
priestoru premenných, ktorý jestvuje vždy.
názovObzoru
– identifikátor (meno) menného priestoru
premenných skriptovtrue
, ak priestor so zadaným menom jestvujedajObzor(String)
,
Skript.PremennéSkriptu
public static boolean obzorExistuje(String názovObzoru)
Alias pre obzorJestvuje
.
public static Skript.PremenneSkriptu dajObzor(String názovObzoru)
Vráti pomenovaný priestor premenných skriptov, ktorý je v tomto programovacom rámci označovaný termínom „obzor.“ Ak priestor nejestvuje, tak je automaticky vytvorený. Špeciálny prípad nastáva pri zadaní prázdneho názvu obzoru. Vtedy metóda vráti globálny priestor premenných…
Poznámka: Globálny priestor premenných
získame aj volaním metódy Skript
.
globálnePremenné
.
názovObzoru
– identifikátor (meno) menného priestoru
premenných skriptovobzorJestvuje(String)
,
Skript.PremennéSkriptu