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.classnullpublic 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.classtrue;
ak premenná nejestvuje alebo bol zadaný nepovolený
údajový typ premennej, tak je návratovou hodnotou
tejto metódy hodnota falseSkript.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.classnullSkript.čí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
Stringtrue, tak bola zadaná hodnota zapísaná do
premennej prislúchajúceho údajového typu, v opačnom
prípade je návratová hodnota rovná falseSkript.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.classSkript.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éSkriptupublic 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