Súbor

java.lang.Object
- Súbor

Všetky implementované rozhrania:: Closeable, AutoCloseable

Známe priame odvodené triedy:: Subor

public class Súbor
extends Object
implements Closeable

Trieda na prácu so súbormi. Definuje metódy na otváranie, zatváranie, zápis a čítanie textových súborov a metódy na prácu s takzvanými „vlastnosťami“ (pozri nižšie).

Príklad:

V tomto príklade je ukázaný jednoduchý spôsob zápisu niekoľkých riadkov textu do súboru a vzápätí vypísania obsahu súboru na obrazovku.

try
{
    // Otvoriť súbor na zápis a zapísať niekoľko riadkov
    súbor.otvorNaZápis("pokus.txt");
    súbor.zapíšRiadok("Toto");
    súbor.zapíšRiadok("Je");
    súbor.zapíšRiadok("Pokusný");
    súbor.zapíšRiadok("Zápis");
    súbor.zapíšRiadok("Do");
    súbor.zapíšRiadok("Súboru");
    súbor.zavri();    // Každý súbor musí byť po použití zatvorený

    // Vzápätí otvoriť súbor na čítanie a vypísať ho po riadkoch
    súbor.otvorNaČítanie("pokus.txt");
    String riadok;
    while (null != (riadok = súbor.čítajRiadok()))
        Svet.vypíšRiadok("„", riadok, "“");
}
catch (IOException e)   // vyžaduje import java.io.IOException;
    // alternatívne je možné použiť namiesto IOException všeobecný
    // typ Exception, ktorý nevyžaduje žiadny import, ale potom by
    // bolo vhodné vymazať nasledujúci blok catch (pretože sa
    // stane zbytočným)
{
    // Keby sme chceli text chyby vypísať na štandardný výstup,
    // použili by sme:
    //   System.out.println(e.getMessage());

    // Keby sme chceli vypísať úplný výpis chybovej stopy na štandardný
    // chybový výstup, použili by sme:
    //   e.printStackTrace();

    // Použijeme vnútornú konzolu robota na výpis textu chyby červenou
    // farbou:
    Farba záloha = Svet.farbaTextu();
    Svet.farbaTextu(červená);
    Svet.vypíšRiadok(e.getMessage());
    Svet.farbaTextu(záloha);
}
catch (GRobotException e)   // Táto výnimka vzniká napríklad ak súbor
    // nejestvuje. To by sa v našom prípade nemalo stať, ale ak
    // by ste chceli tento príklad „recyklovať“ na iné účely, mal
    // by tam tento blok byť.
{
    Farba záloha = Svet.farbaTextu();
    Svet.farbaTextu(červená);
    Svet.vypíšRiadok(e.getMessage());
    Svet.farbaTextu(záloha);
}

// Keby nastala chyba v predchádzajúcom bloku, súbor by nemusel byť
// korektne zavretý, preto ho zatvárame v samostatnom bloku try-catch
try
{
    súbor.zavri();
}
catch (IOException e)
{
    // Chyby vypíše červenou farbou…
    Farba záloha = Svet.farbaTextu();
    Svet.farbaTextu(červená);
    Svet.vypíšRiadok(e.getMessage());
    Svet.farbaTextu(záloha);
}

Ak sa všetko vykoná korektne, súbor bude obsahovať nasledujúce riadky:

Toto
Je
Pokusný
Zápis
Do
Súboru

Na obrazovke budú jednotlivé riadky vypísané v úvodzovkách („“).

Príklad:

V tomto príklade je ukázaný jednoduchý spôsob čítania série celých čísiel zo súboru.

Predpokladajme, že v priečinku s projektom BlueJa jestvuje textový súbor _čísla.txt s nasledujúcim obsahom (medzery sú úmyselne podfarbené tyrkysovou farbou):

   8 23  3 4 32  0  -14  
   
 21  -2  +8 14 

64  -0  -24

Nasledujúci úryvok kódu bude zo súboru čítať a vypisovať na obrazovku celé čísla dovtedy, kým sa tam nejaké vyskytujú:

try
{
    súbor.otvorNaČítanie("_čísla.txt");
    Long číslo; boolean prvé = true;
    while (null != (číslo = súbor.čítajCeléČíslo()))
    {
        if (prvé) prvé = false; else Svet.vypíš(", ");
        Svet.vypíš(číslo);
    }

    Svet.vypíšRiadok(".");
}
catch (IOException e)   // vyžaduje import java.io.IOException;
    // alternatívne je možné použiť namiesto IOException všeobecný
    // typ Exception, ktorý nevyžaduje žiadny import, ale potom by
    // bolo vhodné vymazať nasledujúci blok catch (pretože sa
    // stane zbytočným)
{
    // Nasledujúci príkaz vypíše zápis o prípadnej chybe na štandardný
    // chybový výstup (System.err). Zápis by sa objavil v okne
    // terminálu BlueJa.
    System.err.print("IOException: ");
    e.printStackTrace();
}
catch (GRobotException e)
{
    System.err.print("GRobotException: ");
    e.printStackTrace();
}

Výsledný výpis bude vyzerať takto:

8, 23, 3, 4, 32, 0, -14, 21, -2, 8, 14, 64, 0, -24.

Okrem klasických metód na čítanie a zápis, obsahuje trieda Súbor aj metódy na zápis a čítanie vlastností, ktoré sú do textového súboru ukladané v tvare názov=hodnota.

Neodporúčame kombinovať použitie klasických metód na čítanie a zápis s metódami na čítanie a zápis vlastností. Rozdiel medzi oboma prístupmi je, že „klasické“ údaje musia byť čítané zo súboru v rovnakom poradí ako boli zapísané a vlastnosti môžu byť čítané a zapisované v ľubovoľnom poradí. Vlastnosti tiež ošetrujú výskyt takzvaných únikových (escape) sekvencií vo svojich hodnotách. Na lepšie pochopenie práce s vlastnosťami poslúži nasledujúci príklad:

Poznámka: Cenou za náhodný („nesekvenčný“) prístup k hodnotám vlastností je vyššia pamäťová zložitosť vnútorných algoritmov a z toho vyplývajúce pomalšie spracovanie pri čítaní a zápise. Náhodný experiment pri tvorbe dokumentácie ukázal, že trieda Súbor dokáže spracovať aj relatívne veľké konfiguračné súbory (určite najmenej päť megabajtov), ale ich spracovanie (zostavenie, zápis, čítanie a analýza) trvalo niekoľko desiatok sekúnd až minút (experiment bol náhodný, nie účelový a program na tvorbu dokumentácie zostavoval a analyzoval asi päťdesiat rôzne veľkých konfiguračných súborov – od kilobajtov po megabajty; procesy zostavenia so zápisom a čítania s analýzou trvali niekoľko minút – experiment bol vykonaný v roku 2018 na prenosnom počítači so štandardným výkonom).

try
{
    // Pokúsi sa otvoriť súbor na čítanie (ak nejestvuje, nastane
    // výnimka a program skončí, preto je potrebné vopred vytvoriť
    // prázdny súbor s názvom vlastnosti.txt – v operačnom systéme
    // zvonka BlueJa alebo pripísať pred tento program úryvok kódu
    // zverejnený nižšie – čítajte ďalej…)
    súbor.otvorNaČítanie("vlastnosti.txt");

    // Definícia premenných obsahujúca čítanie vlastností zo súboru
    double[] pole = new double[]{2.2, 4.4, 2.8, 14.0, 18};
    Double číslo = súbor.čítajVlastnosť("číslo", new Double(0));
    String reťazec = súbor.čítajVlastnosť("reťazec", new String("pokus"));
    pole = súbor.čítajVlastnosť("pole", pole);

    // Zavretie súboru
    súbor.zavri();

    // Výpis hodnôt premenných
    Svet.vypíšRiadok("číslo: ", číslo);
    Svet.vypíšRiadok("reťazec: ", reťazec);
    Svet.vypíšRiadok("pole: ", pole);

    // Zmena hodnoty prvku poľa (na demonštráciu)
    pole[3] *= 2;

    // Otvorenie súboru na zápis a zápis vlastností do súboru
    // (namiesto obsahu premennej číslo zapíšeme konštantnú hodnotu
    // 4 a v prvku pole[3] bude dvojnásobok pôvodnej hodnoty,
    // všetky ostatné údaje zostanú v pôvodnom tvare)
    súbor.otvorNaZápis("vlastnosti.txt");
    súbor.zapíšVlastnosť("číslo", 4);
    súbor.zapíšVlastnosť("reťazec", reťazec);
    súbor.zapíšVlastnosť("pole", pole);
}
catch (IOException e)   // vyžaduje import java.io.IOException;
    // alternatívne je možné použiť namiesto IOException všeobecný
    // typ Exception, ktorý nevyžaduje žiadny import, ale potom by
    // bolo vhodné vymazať nasledujúce bloky catch (pretože sa
    // stanú zbytočnými)
{
    // Chyby vypíše červenou farbou…
    Farba záloha = Svet.farbaTextu();
    Svet.farbaTextu(červená);
    Svet.vypíšRiadok(e.getMessage());
    Svet.farbaTextu(záloha);
}
catch (IllegalArgumentException e)
{
    Farba záloha = Svet.farbaTextu();
    Svet.farbaTextu(červená);
    Svet.vypíšRiadok(e.getMessage());
    Svet.farbaTextu(záloha);
}
catch (GRobotException e)
{
    Farba záloha = Svet.farbaTextu();
    Svet.farbaTextu(červená);
    Svet.vypíšRiadok(e.getMessage());
    Svet.farbaTextu(záloha);
}
finally
{
    try
    {
        // Zavretie súboru
        súbor.zavri();
    }
    catch (IOException e)
    {
        Farba záloha = Svet.farbaTextu();
        Svet.farbaTextu(červená);
        Svet.vypíšRiadok(e.getMessage());
        Svet.farbaTextu(záloha);
    }
}

Ak sa všetko vykoná korektne (pozorne si prečítajte aj komentáre v príklade), na obrazovke bude výpis:

číslo: 0.0
reťazec: pokus
pole: 2.2 4.4 2.8 14.0 18.0

V súbore však budú údaje zapísané s drobnými rozdielmi:

číslo=4
reťazec=pokus
pole=2.2 4.4 2.8 28.0 18.0

Po každom ďalšom spustení programu bude hodnota štvrtého prvku poľa dvojnásobná.

Ak nechcete ručne vytvárať prázdny súbor vlastnosti.txt zvonka BlueJa, tak pripíšte na začiatok programu nasledujúci úryvok kódu, ktorý vykoná kontrolu, či súbor jestvuje a v prípade, že nejestvuje ho vytvorí (na vytvorenie súboru ho stačí otvoriť na zápis a zavrieť).

try
{
    if (!Súbor.jestvuje("vlastnosti.txt"))
    {
        súbor.otvorNaZápis("vlastnosti.txt");
        súbor.zavri();
    }
}
catch (IOException | IllegalArgumentException e)
{
    Farba záloha = Svet.farbaTextu();
    Svet.farbaTextu(červená);
    Svet.vypíšRiadok(e.getMessage());
    Svet.farbaTextu(záloha);
}

Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!

Prehľad konštruktorov

Konštruktory
Konštruktor a opis

Súbor()

Konštruktory
Konštruktor a opis
`Súbor()`

Prehľad metód

Všetky metódy Statické metódy Inštančné metódy Skutočne definované metódy
Modifikátor a typ	Metóda a opis
`String`	`aktivnaSekcia()` Alias pre `aktívnaSekcia`.
`String`	`aktívnaSekcia()` Vráti názov aktívnej sekcie.
`void`	`aktivujSekciu(String názov)` Pridá novú alebo aktivuje jestvujúcu sekciu konfiguračných direktív.
`boolean`	`archivPriradeny()` Alias pre `archívPriradený`.
`boolean`	`archívPriradený()` Zistí, či je k tomuto súboru pripojený archív.
`void`	`citaj(Object... objekty)` Alias pre `čítaj`.
`Boolean`	`citajBoolean()` Alias pre `čítajBoolean`.
`Long`	`citajCeleCislo()` Alias pre `čítajCeléČíslo`.
`Double`	`citajRealneCislo()` Alias pre `čítajReálneČíslo`.
`String`	`citajRiadok()` Alias pre `čítajRiadok`.
`String[][]`	`citajTabulku(String názovSúboru, String... nastavenia)` Alias pre `čítajTabuľku`.
`Boolean`	`citajVlastnost(String názov, Boolean predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`boolean[]`	`citajVlastnost(String názov, boolean[] predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`Farba`	`citajVlastnost(String názov, Color predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`Double`	`citajVlastnost(String názov, Double predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`double[]`	`citajVlastnost(String názov, double[] predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`Farba`	`citajVlastnost(String názov, Farebnosť predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`Float`	`citajVlastnost(String názov, Float predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`float[]`	`citajVlastnost(String názov, float[] predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`char[]`	`citajVlastnost(String názov, char[] predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`int[]`	`citajVlastnost(String názov, int[] predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`Integer`	`citajVlastnost(String názov, Integer predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`Long`	`citajVlastnost(String názov, Long predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`long[]`	`citajVlastnost(String názov, long[] predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`Point2D.Double`	`citajVlastnost(String názov, Point2D predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`Bod`	`citajVlastnost(String názov, Poloha predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`String`	`citajVlastnost(String názov, String predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`StringBuffer`	`citajVlastnost(String názov, StringBuffer predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`Character`	`citajZnak()` Alias pre `čítajZnak`.
`void`	`close()` Zavrie súbor, ktorý bol predtým otvorený na čítanie alebo zápis.
`int`	`čítaj(Object... objekty)` Pokúsi sa prečítať zo súboru otvoreného na čítanie toľko textu, koľko je potrebné na naplnenie zadaného počtu objektov, pričom objem prečítaného textu je závislý od typu objektu.
`Boolean`	`čítajBoolean()` Prečíta zo súboru otvoreného na čítanie text od aktuálnej polohy v súbore po najbližšiu medzeru alebo koniec riadka a pokúsi sa ho previesť na objekt typu `Boolean` obsahujúci pravdivostnú hodnotu `true`/`false`.
`Long`	`čítajCeléČíslo()` Prečíta zo súboru otvoreného na čítanie text od aktuálnej polohy v súbore po najbližšiu medzeru alebo koniec riadka a pokúsi sa ho previesť na celé číslo…
`Double`	`čítajReálneČíslo()` Prečíta zo súboru otvoreného na čítanie text od aktuálnej polohy v súbore po najbližšiu medzeru alebo koniec riadka a pokúsi sa ho previesť na reálne číslo…
`String`	`čítajRiadok()` Prečíta zo súboru otvoreného na čítanie riadok textu a vráti ho v objekte typu `String`.
`String[][]`	`čítajTabuľku(String názovSúboru, String... nastavenia)` Prečíta tabuľku zo zadaného súboru.
`Boolean`	`čítajVlastnosť(String názov, Boolean predvolenáHodnota)` Číta hodnotu vlastnosti v tvare logickej hodnoty `true` / `false`.
`boolean[]`	`čítajVlastnosť(String názov, boolean[] predvolenáHodnota)` Číta hodnotu vlastnosti do poľa logických hodnôt typu `boolean`.
`Farba`	`čítajVlastnosť(String názov, Color predvolenáHodnota)` Číta hodnotu vlastnosti ako objekt, ktorý je odvodený od typu `Color`.
`Double`	`čítajVlastnosť(String názov, Double predvolenáHodnota)` Číta hodnotu vlastnosti v tvare reálneho čísla.
`double[]`	`čítajVlastnosť(String názov, double[] predvolenáHodnota)` Číta hodnotu vlastnosti do poľa reálnych čísel typu `double`.
`Farba`	`čítajVlastnosť(String názov, Farebnosť predvolenáHodnota)` Číta hodnotu vlastnosti ako objekt, ktorý je implementáciou rozhrania `Farebnosť`.
`Float`	`čítajVlastnosť(String názov, Float predvolenáHodnota)` Číta hodnotu vlastnosti v tvare reálneho čísla.
`float[]`	`čítajVlastnosť(String názov, float[] predvolenáHodnota)` Číta hodnotu vlastnosti do poľa reálnych čísel typu `float`.
`char[]`	`čítajVlastnosť(String názov, char[] predvolenáHodnota)` Číta hodnotu vlastnosti do poľa znakov (`char[]`).
`int[]`	`čítajVlastnosť(String názov, int[] predvolenáHodnota)` Číta hodnotu vlastnosti do celočíselného poľa typu `int`.
`Integer`	`čítajVlastnosť(String názov, Integer predvolenáHodnota)` Číta hodnotu vlastnosti v tvare celého čísla.
`Long`	`čítajVlastnosť(String názov, Long predvolenáHodnota)` Číta hodnotu vlastnosti v tvare celého čísla.
`long[]`	`čítajVlastnosť(String názov, long[] predvolenáHodnota)` Číta hodnotu vlastnosti do celočíselného poľa typu `long`.
`Point2D.Double`	`čítajVlastnosť(String názov, Point2D predvolenáHodnota)` Číta hodnotu vlastnosti ako objekt, ktorý je odvodený od typu `Point2D`.
`Bod`	`čítajVlastnosť(String názov, Poloha predvolenáHodnota)` Číta hodnotu vlastnosti ako objekt, ktorý je implementáciou rozhrania `Poloha`.
`String`	`čítajVlastnosť(String názov, String predvolenáHodnota)` Číta hodnotu vlastnosti v tvare reťazca.
`StringBuffer`	`čítajVlastnosť(String názov, StringBuffer predvolenáHodnota)` Číta hodnotu vlastnosti v tvare reťazca, pričom výsledok je vrátený v objekte typu `StringBuffer`.
`Character`	`čítajZnak()` Prečíta zo súboru otvoreného na nasledujúci znak a vráti jeho hodnotu.
`static String`	`datumNaRetazec(long miliDátum)` Alias pre `dátumNaReťazec`.
`static String`	`dátumNaReťazec(long miliDátum)` Zostaví reťazec dátumu v predvolenom formáte zo zadaného počtu milisekúnd počítaných od začiatku takzvanej epochy.
`static String`	`datumNaRetazec(long miliDátum, String formát)` Alias pre `dátumNaReťazec`.
`static String`	`dátumNaReťazec(long miliDátum, String formát)` Podľa zadaných údajov vytvorí reťazec dátumu.
`static String`	`dialogOtvorit(String titulok)` Alias pre `dialógOtvoriť`.
`static String`	`dialógOtvoriť(String titulok)` Otvorí používateľský dialóg na otvorenie súboru, ktorý vráti reťazec s úplnou cestou a názvom súboru zvoleného v dialógu používateľom.
`static String`	`dialogOtvorit(String titulok, String predvolenýNázovSúboru, String... filtre)` Alias pre `dialógOtvoriť`.
`static String`	`dialógOtvoriť(String titulok, String predvolenýNázovSúboru, String... filtre)` Otvorí používateľský dialóg na otvorenie súboru, ktorý vráti reťazec s úplnou cestou a názvom súboru zvoleného v dialógu používateľom.
`static String`	`dialogUlozit(String titulok)` Alias pre `dialógUložiť`.
`static String`	`dialogUlozit(String titulok, String predvolenýNázovSúboru, String... filtre)` Alias pre `dialógUložiť`.
`static String`	`dialógUložiť(String titulok)` Otvorí používateľský dialóg na uloženie súboru, ktorý vráti reťazec s úplnou cestou a názvom súboru zvoleného v dialógu používateľom.
`static String`	`dialógUložiť(String titulok, String predvolenýNázovSúboru, String... filtre)` Otvorí používateľský dialóg na uloženie súboru, ktorý vráti reťazec s úplnou cestou a názvom súboru zvoleného v dialógu používateľom.
`String`	`docitajRiadok()` Alias pre `dočítajRiadok`.
`String`	`dočítajRiadok()` Umožňuje dočítať zo súboru otvoreného na čítanie aktuálne spracúvaný riadok textu.
`static boolean`	`existuje(String názov)` Overí, či súbor alebo priečinok so zadaným názvom jestvuje.
`static boolean`	`jePriecinok(String názov)` Alias pre `jePriečinok`.
`static boolean`	`jePriečinok(String názov)` Overí, či zadaný názov označuje priečinok.
`static boolean`	`jestvuje(String názov)` Overí, či súbor alebo priečinok so zadaným názvom jestvuje.
`static boolean`	`jeSubor(String názov)` Alias pre `jeSúbor`.
`static boolean`	`jeSúbor(String názov)` Overí, či zadaný názov určuje obyčajný súbor.
`String`	`kdeJeSubor(String názovSúboru)` Alias pre `kdeJeSúbor`.
`static String`	`kdeJeSúbor(String názovSúboru)` Vyhľadá skutočné umiestnenie súboru určeného na čítanie alebo vráti hodnotu `null`, ak súbor nebol nájdený.
`boolean`	`koniecRiadka()` Overí, či sa prúd údajov čítaný zo súboru momentálne nachádza na konci riadka.
`boolean`	`koniecSuboru()` Alias pre `koniecSúboru`.
`boolean`	`koniecSúboru()` Overí, či sa prúd údajov čítaný zo súboru skončil.
`static byte[]`	`kontrolnySucet(String názov)` Alias pre `kontrolnýSúčet`.
`static byte[]`	`kontrolnýSúčet(String názov)` Vyrobí kontrolný súčet súboru algoritmom SHA1.
`static void`	`kopiruj(String zdroj, String cieľ)` Alias pre `kopíruj`.
`static void`	`kopíruj(String zdroj, String cieľ)` Skopíruje zdrojový súbor do cieľového súboru.
`static void`	`kopiruj(String zdroj, String cieľ, boolean prepísať)` Alias pre `kopíruj`.
`static void`	`kopíruj(String zdroj, String cieľ, boolean prepísať)` Skopíruje zdrojový súbor do cieľového súboru.
`String`	`mennyPriestorVlastnosti()` Alias pre `mennýPriestorVlastností`.
`String`	`mennýPriestorVlastností()` Zistí aktuálne používaný menný priestor na čítanie a zápis vlastností.
`void`	`mennyPriestorVlastnosti(String novýMennýPriestor)` Alias pre `mennýPriestorVlastností`.
`void`	`mennýPriestorVlastností(String novýMennýPriestor)` Stanoví nový menný priestor na čítanie a zápis vlastností.
`static long`	`naposledyUpraveny(String názov)` Alias pre `naposledyUpravený`.
`static long`	`naposledyUpravený(String názov)` Zistí dátum a čas poslednej úpravy zadaného súboru alebo priečinka.
`static void`	`naposledyUpraveny(String názov, long miliDátum)` Alias pre `naposledyUpravený`.
`static void`	`naposledyUpravený(String názov, long miliDátum)` Nastaví dátum a čas poslednej úpravy zadaného súboru alebo priečinka.
`static boolean`	`novyPriecinok(String názov)` Alias pre `vytvorPriečinok`.
`static boolean`	`novyPriecinok(String názov, boolean ajRodičov)` Alias pre `vytvorPriečinok`.
`static boolean`	`novýPriečinok(String názov)` Alias pre `vytvorPriečinok`.
`static boolean`	`novýPriečinok(String názov, boolean ajRodičov)` Alias pre `vytvorPriečinok`.
`void`	`odstranujNepouziteVlastnosti()` Alias pre `odstraňujNepoužitéVlastnosti`.
`void`	`odstraňujNepoužitéVlastnosti()` Prepne inštanciu do režimu odstraňovania nepoužitých vlastností.
`void`	`otvorNaCitanie(String názovSúboru)` Alias pre `otvorNaČítanie`.
`void`	`otvorNaCitanie(String názovSúboru, String kódovanie)` Alias pre `otvorNaČítanie`.
`void`	`otvorNaČítanie(String názovSúboru)` Otvorí zadaný súbor s kódovaním UTF-8 na čítanie.
`void`	`otvorNaČítanie(String názovSúboru, String kódovanie)` Otvorí zadaný súbor na čítanie.
`void`	`otvorNaZapis(String názovSúboru)` Alias pre `otvorNaZápis`.
`void`	`otvorNaZápis(String názovSúboru)` Otvorí zadaný súbor na zápis.
`void`	`otvorNaZapis(String názovSúboru, boolean pripojiť)` Alias pre `otvorNaZápis`.
`void`	`otvorNaZápis(String názovSúboru, boolean pripojiť)` Otvorí zadaný súbor na zápis.
`void`	`otvorNaZapis(String názovSúboru, String kódovanie, boolean pripojiť)` Alias pre `otvorNaZápis`.
`void`	`otvorNaZápis(String názovSúboru, String kódovanie, boolean pripojiť)` Otvorí zadaný súbor na zápis.
`static boolean`	`porovnaj(String názov1, String názov2)` Porovná obsah dvoch súborov.
`static String`	`predvolenaCestaDialogov()` Alias pre `predvolenáCestaDialógov`.
`static String`	`predvolenáCestaDialógov()` Zistí, aká je aktuálna predvolená cesta (systémových pomocných) dialógov na otvorenie a uloženie súborov.
`static void`	`predvolenaCestaDialogov(String cesta)` Alias pre `predvolenáCestaDialógov`.
`static void`	`predvolenáCestaDialógov(String cesta)` Nastaví novú predvolenú cestu (systémových pomocných) dialógov na otvorenie a uloženie súborov.
`void`	`prekladajVlastnosti(String[][] prekladyNázvov, String[][] prekladyHodnôt)` Táto metóda zapne alebo vypne automatický preklad názvov a hodnôt vlastností tak, aby aj tie vlastnosti konfiguračných súborov, ktoré programovací rámec zapisuje automaticky, mohli byť v prípade potreby používané v cudzojazyčnom prostredí.
`static boolean`	`premenuj(String zdroj, String cieľ)` Premenuje (presunie) zdrojový súbor alebo priečinok na cieľový súbor alebo priečinok (do cieľovej cesty).
`void`	`premenujSekciu(String názov)` Zmení názov aktuálnej sekcie.
`static boolean`	`presun(String zdroj, String cieľovýPriečinok)` Alias pre `presuň`.
`static boolean`	`presuň(String zdroj, String cieľovýPriečinok)` Presunie zdrojový súbor alebo priečinok do cieľovej cesty.
`static void`	`pripoj(String zdroj, String cieľ)` Pripojí zdrojový súbor k cieľovému súboru.
`void`	`pripojArchiv(Archív archív)` Alias pre `pripojArchív`.
`void`	`pripojArchív(Archív archív)` Priradí k tomuto súboru zadanú inštanciu archívu.
`static long`	`retazecNaDatum(String dátum)` Alias pre `reťazecNaDátum`.
`static long`	`reťazecNaDátum(String dátum)` Vráti dátum v milisekundách počítaných od začiatku takzvanej epochy.
`static long`	`retazecNaDatum(String dátum, String formát)` Alias pre `reťazecNaDátum`.
`static long`	`reťazecNaDátum(String dátum, String formát)` Vráti dátum v milisekundách počítaných od začiatku takzvanej epochy.
`static String[][]`	`retazecNaTabulku(String tabuľka, String... nastavenia)` Alias pre `reťazecNaTabuľku`.
`static String[][]`	`reťazecNaTabuľku(String tabuľka, String... nastavenia)` Prevedie zadaný reťazec na tabuľku.
`static boolean`	`suctySuZhodne(byte[] kontrolnýSúčet1, byte[] kontrolnýSúčet2)` Alias pre `súčtySúZhodné`.
`static boolean`	`súčtySúZhodné(byte[] kontrolnýSúčet1, byte[] kontrolnýSúčet2)` Porovná zhodu dvoch kontrolných súčtov súborov.
`static String`	`tabulkaNaRetazec(String[][] tabuľka, String... nastavenia)` Alias pre `tabuľkaNaReťazec`.
`static String`	`tabuľkaNaReťazec(String[][] tabuľka, String... nastavenia)` Prevedie tabuľku na jeden reťazec.
`static long`	`velkost(String názov)` Alias pre `veľkosť`.
`static long`	`veľkosť(String názov)` Zistí veľkosť zadaného súboru alebo zdroja.
`boolean`	`vlastnostExistuje(String názov)` Alias pre `vlastnosťJestvuje`.
`boolean`	`vlastnosťExistuje(String názov)` Alias pre `vlastnosťJestvuje`.
`boolean`	`vlastnostJestvuje(String názov)` Alias pre `vlastnosťJestvuje`.
`boolean`	`vlastnosťJestvuje(String názov)` Zistí, či je v súbore otvorenom na čítanie (vlastností) definovaná zadaná vlastnosť.
`void`	`vnorMennyPriestorVlastnosti()` Alias pre `vnorMennýPriestorVlastností`.
`void`	`vnorMennýPriestorVlastností()` Zálohuje aktuálny menný priestor na čítanie a zápis vlastností do vnútorného zásobníka.
`void`	`vnorMennyPriestorVlastnosti(String vnorenýMennýPriestor)` Alias pre `vnorMennýPriestorVlastností`.
`void`	`vnorMennýPriestorVlastností(String vnorenýMennýPriestor)` Zmení menný priestor na čítanie a zápis vlastností tak, aby vznikol vnorený priestor podľa konvencie opísanej nižšie.
`static boolean`	`vymaz(String názov)` Alias pre `vymaž`.
`void`	`vymazSekciu(String názov)` Alias pre `vymažSekciu`.
`void`	`vymazVlastnost(String názov)` Alias pre `vymažVlastnosť`.
`static boolean`	`vymaž(String názov)` Vymaže súbor alebo priečinok so zadaným názvom.
`void`	`vymažSekciu(String názov)` Vymaže sekciu so zadaným názvom.
`void`	`vymažVlastnosť(String názov)` Odstráni zo súboru záznam o vlastnosti so zadaným menom.
`void`	`vymažVlastnosti()` Vymaže všetky vlastnosti z vnútornej pamäte, ktoré mohli zostať zapamätané po poslednom čítaní súboru.
`void`	`vynorMennyPriestorVlastnosti()` Alias pre `vynorMennýPriestorVlastností`.
`void`	`vynorMennýPriestorVlastností()` Obnoví posledný zálohovaný menný priestor na čítanie a zápis vlastností z vnútorného zásobníka.
`static boolean`	`vytvorPriecinok(String názov)` Alias pre `vytvorPriečinok`.
`static boolean`	`vytvorPriecinok(String názov, boolean ajRodičov)` Alias pre `vytvorPriečinok`.
`static boolean`	`vytvorPriečinok(String názov)` Vytvorí nový priečinok so zadaným názvom buď v aktuálnom priečinku, alebo na zadanej ceste (pripojenej pred názvom).
`static boolean`	`vytvorPriečinok(String názov, boolean ajRodičov)` Vytvorí nový priečinok so zadaným názvom buď v aktuálnom priečinku, alebo na zadanej ceste (pripojenej pred názvom).
`void`	`zachovajNepouziteVlastnosti()` Alias pre `zachovajNepoužitéVlastnosti`.
`void`	`zachovajNepoužitéVlastnosti()` Prepne inštanciu do režimu zachovávania nepoužitých vlastností.
`boolean`	`zachovavaNepouziteVlastnosti()` Alias pre `zachovávaNepoužitéVlastnosti`.
`boolean`	`zachovávaNepoužitéVlastnosti()` Zistí v akom režime sa nachádza táto inštancia triedy `Súbor`.
`void`	`zapis(Object... objekty)` Alias pre `zapíš`.
`void`	`zapisBOM()` Alias pre `zapíšBOM`.
`void`	`zapisKomentarVlastnosti(String komentár)` Alias pre `zapíšKomentárVlastností`.
`void`	`zapisPrazdnyRiadokVlastnosti()` Alias pre `zapíšPrázdnyRiadokVlastností`.
`void`	`zapisRetazec(String text)` Alias pre `zapíšReťazec`.
`void`	`zapisRiadok()` Alias pre `zapíšRiadok`.
`void`	`zapisRiadok(String text)` Alias pre `zapíšRiadok`.
`void`	`zapisTabulku(String názovSúboru, String[][] tabuľka, String... nastavenia)` Alias pre `zapíšTabuľku`.
`void`	`zapisVlastnost(String názov, Object hodnota)` Alias pre `zapíšVlastnosť`.
`void`	`zapíš(Object... objekty)` Zapíše do súboru otvoreného na zápis textovú podobu zoznamu objektov rôzneho údajového typu (napríklad celé čísla `int` budú zapísané ako séria číslic – čísla vo forme textu).
`void`	`zapíšBOM()` Zapíše do súboru otvoreného na zápis značku BOM.
`void`	`zapíšKomentárVlastností(String komentár)` Dovoľuje vkladať do textových súborov vlastností jednoriadkové komentáre.
`void`	`zapíšPrázdnyRiadokVlastností()` Dovoľuje vkladať do textových súborov vlastností prázdne riadky slúžiace ako oddeľovače.
`void`	`zapíšReťazec(String text)` Zapíše do súboru otvoreného na zápis určený reťazec.
`void`	`zapíšRiadok()` Zapíše do súboru otvoreného na zápis prázdny riadok.
`void`	`zapíšRiadok(String text)` Zapíše do súboru otvoreného na zápis riadok textu.
`void`	`zapíšTabuľku(String názovSúboru, String[][] tabuľka, String... nastavenia)` Zapíše tabuľku do zadaného súboru.
`void`	`zapíšVlastnosť(String názov, Object hodnota)` Zapíše vlastnosť podporovaného údajového typu.
`void`	`zavri()` Zavrie súbor, ktorý bol predtým otvorený na čítanie alebo zápis.
`static String[]`	`zoznam(String cesta)` Vytvorí zoznam všetkých položiek umiestnených na zadanej ceste.
`static String[]`	`zoznamPriecinkov(String cesta)` Alias pre `zoznamPriečinkov`.
`static String[]`	`zoznamPriečinkov(String cesta)` Vytvorí zoznam priečinkov umiestnených na zadanej ceste.
`Zoznam<String>`	`zoznamSekcii()` Alias pre `zoznamSekcií`.
`Zoznam<String>`	`zoznamSekcií()` Vráti zoznam aktuálnych sekcií definovaných v tomto konfiguračnom súbore.
`static String[]`	`zoznamSuborov(String cesta)` Alias pre `zoznamSúborov`.
`static String[]`	`zoznamSúborov(String cesta)` Vytvorí zoznam súborov umiestnených v zadanom priečinku.
`static String[]`	`zoznamSuborovAPriecinkov(String cesta)` Alias pre `zoznamSúborovAPriečinkov`.
`static String[]`	`zoznamSúborovAPriečinkov(String cesta)` Vytvorí zoznam súborov a priečinkov umiestnených v zadanom priečinku.
`Zoznam<String>`	`zoznamVlastnosti()` Alias pre `zoznamVlastností`.
`Zoznam<String>`	`zoznamVlastností()` Vráti zoznam vlastností definovaných v aktuálnej sekcii konfigurácie.

Metódy zdedené z triedy java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Podrobnosti konštruktorov
- Súbor
```
public Súbor()
```

Podrobnosti metód

aktívnaSekcia
```
public String aktívnaSekcia()
```
Vráti názov aktívnej sekcie. Prázdny reťazec označuje prvú bezmennú konfiguračnú pasáž.

Návratová hodnota:

názov aktívnej sekcie alebo prázdny reťazec

Pozri tiež:

aktivujSekciu(String), vymažSekciu(String), premenujSekciu(String), zoznamSekcií()

aktivnaSekcia
```
public String aktivnaSekcia()
```
Alias pre aktívnaSekcia.

aktivujSekciu
```
public void aktivujSekciu(String názov)
                   throws IOException
```
Pridá novú alebo aktivuje jestvujúcu sekciu konfiguračných direktív. Prázdny reťazec označuje prvú bezmennú konfiguračnú pasáž. (Tá je definovaná predvolene.)

Poznámka: Hodnota null je v tomto prípade nahradená hodnotou prázdneho reťazca "", takže tiež označuje predvolený (bezmenný) konfiguračný priestor.

Parametre:

názov – názov novej alebo jestvujúcej sekcie

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

Pozri tiež:

aktívnaSekcia(), vymažSekciu(String), premenujSekciu(String), zoznamSekcií()

vymažSekciu
```
public void vymažSekciu(String názov)
                 throws IOException
```
Vymaže sekciu so zadaným názvom.

Pozor! Táto akcia je nevratná!

Parametre:

názov – názov sekcie na vymazanie

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

Pozri tiež:

aktívnaSekcia(), aktivujSekciu(String), premenujSekciu(String), zoznamSekcií()

vymazSekciu

public void vymazSekciu(String názov)
                 throws IOException

Alias pre vymažSekciu.

Výnimky:: IOException

premenujSekciu
```
public void premenujSekciu(String názov)
                    throws IOException
```
Zmení názov aktuálnej sekcie. Nový názov nesmie byť v konflikte s pomenovaním jestvujúcej sekcie. Ak je použitý prázny názov, tak (v prípade, že prázdna sekcia nejestvuje) bude táto sekcia premiestnená na prvé miesto v konfiguračnom súbore.

Parametre:

názov – nový názov sekcie

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

Pozri tiež:

aktívnaSekcia(), aktivujSekciu(String), vymažSekciu(String), zoznamSekcií()

zoznamSekcií
```
public Zoznam<String> zoznamSekcií()
                            throws IOException
```
Vráti zoznam aktuálnych sekcií definovaných v tomto konfiguračnom súbore. Zmeny vykonané vo vrátenom zozname nemajú žiadny vplyv na skutočné sekcie konfigurácie.

Návratová hodnota:

zoznam reťazcov označujúcich názvy aktuálne definovaných sekcií v tomto konfiguračnom súbore

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak súbor nie je otvorený na čítanie, prípadne obsahuje chybu

Pozri tiež:

aktívnaSekcia(), aktivujSekciu(String), vymažSekciu(String), premenujSekciu(String), zoznamVlastností()

zoznamSekcii

public Zoznam<String> zoznamSekcii()
                            throws IOException

Alias pre zoznamSekcií.

Výnimky:: IOException

zoznamSúborov
```
public static String[] zoznamSúborov(String cesta)
```
Vytvorí zoznam súborov umiestnených v zadanom priečinku.

Parametre:

cesta – cesta a názov priečinka, z obsahu ktorého má byť vytvorený zoznam

Návratová hodnota:

pole typu String so zoznamom súborov

Výnimky:

GRobotException – ak zadaná cesta nebola nájdená alebo je neplatná; ak zadaná cesta nespĺňa niektoré pravidlo platnej cesty

zoznamSuborov

public static String[] zoznamSuborov(String cesta)

Alias pre zoznamSúborov.

zoznamPriečinkov
```
public static String[] zoznamPriečinkov(String cesta)
```
Vytvorí zoznam priečinkov umiestnených na zadanej ceste.

Parametre:

cesta – cesta na ktorej sa majú hľadať priečinky

Návratová hodnota:

pole typu String so zoznamom priečinkov

Výnimky:

GRobotException – ak zadaná cesta nebola nájdená alebo je neplatná; ak zadaná cesta nespĺňa niektoré pravidlo platnej cesty

zoznamPriecinkov

public static String[] zoznamPriecinkov(String cesta)

Alias pre zoznamPriečinkov.

zoznamSúborovAPriečinkov
```
public static String[] zoznamSúborovAPriečinkov(String cesta)
```
Vytvorí zoznam súborov a priečinkov umiestnených v zadanom priečinku.

Parametre:

cesta – cesta a názov priečinka, z obsahu ktorého má byť vytvorený zoznam

Návratová hodnota:

pole typu String so zoznamom súborov a priečinkov

Výnimky:

GRobotException – ak zadaná cesta nebola nájdená alebo je neplatná; ak zadaná cesta nespĺňa niektoré pravidlo platnej cesty

zoznamSuborovAPriecinkov

public static String[] zoznamSuborovAPriecinkov(String cesta)

Alias pre zoznamSúborovAPriečinkov.

zoznam
```
public static String[] zoznam(String cesta)
```
Vytvorí zoznam všetkých položiek umiestnených na zadanej ceste. Je pravdepodobné, že zoznam bude zhodný so zoznamom vytvoreným pomocou metódy zoznamSúborovAPriečinkov, no tento zoznam môže obsahovať aj také položky, ktoré nie sú klasifikované ani ako súbory, ani ako priečinky (napríklad systémové odkazy, aliasy, jednotky…).

Parametre:

cesta – cesta a názov priečinka, z obsahu ktorého má byť vytvorený zoznam

Návratová hodnota:

pole typu String so zoznamom položiek

Výnimky:

GRobotException – ak zadaná cesta nebola nájdená alebo je neplatná; ak zadaná cesta nespĺňa niektoré pravidlo platnej cesty

existuje
```
public static boolean existuje(String názov)
```
Overí, či súbor alebo priečinok so zadaným názvom jestvuje. Metóda overuje len jestvovanie reálnych súborov na pevnom disku a len v rámci aktuálneho umiestnenia – neprehľadáva cestu classpath ani balíček .jar. V prípade potreby môžete použiť metódu kdeJeSúbor, ktorá uvedené umiestnenia prehľadáva, a ktorá v prípade nenájdenia súboru vráti hodnotu null.

Parametre:

názov – názov súboru alebo priečinka

Návratová hodnota:

true – áno; false – nie

jestvuje
```
public static boolean jestvuje(String názov)
```
Overí, či súbor alebo priečinok so zadaným názvom jestvuje.

Metóda overuje len jestvovanie reálnych súborov na pevnom disku a len v rámci aktuálneho umiestnenia (resp. na presne zadanej ceste) – neprehľadáva cestu classpath ani balíček .jar. V prípade potreby môžete použiť metódu kdeJeSúbor, ktorá uvedené umiestnenia prehľadáva, a ktorá v prípade nenájdenia súboru vráti hodnotu null.

Parametre:

názov – názov súboru alebo priečinka

Návratová hodnota:

true – áno; false – nie

Pozri tiež:

kdeJeSúbor(String)

vytvorPriečinok
```
public static boolean vytvorPriečinok(String názov,
                                      boolean ajRodičov)
```
Vytvorí nový priečinok so zadaným názvom buď v aktuálnom priečinku, alebo na zadanej ceste (pripojenej pred názvom). Ak je parameter ajRodičov rovný true, tak sa metóda pokúsi vytvoriť aj rodičovské priečinky, ktoré nejestvujú.

Parametre:

názov – názov súboru alebo priečinka

ajRodičov – určuje, či sa má metóda pokúsiť vytvoriť aj prípadných rodičov

Návratová hodnota:

true vtedy a len vtedy, ak bol priečinok (vrátane prípadných rodičovských priečinkov) úspešne vytvorený úspešne, inak false

vytvorPriecinok

public static boolean vytvorPriecinok(String názov,
                                      boolean ajRodičov)

Alias pre vytvorPriečinok.

novýPriečinok

public static boolean novýPriečinok(String názov,
                                    boolean ajRodičov)

Alias pre vytvorPriečinok.

novyPriecinok

public static boolean novyPriecinok(String názov,
                                    boolean ajRodičov)

Alias pre vytvorPriečinok.

vytvorPriečinok
```
public static boolean vytvorPriečinok(String názov)
```
Vytvorí nový priečinok so zadaným názvom buď v aktuálnom priečinku, alebo na zadanej ceste (pripojenej pred názvom).

Parametre:

názov – názov súboru alebo priečinka

Návratová hodnota:

true vtedy a len vtedy, ak bol priečinok úspešne vytvorený úspešne, inak false

vytvorPriecinok

public static boolean vytvorPriecinok(String názov)

Alias pre vytvorPriečinok.

novýPriečinok

public static boolean novýPriečinok(String názov)

Alias pre vytvorPriečinok.

novyPriecinok

public static boolean novyPriecinok(String názov)

Alias pre vytvorPriečinok.

jeSúbor
```
public static boolean jeSúbor(String názov)
```
Overí, či zadaný názov určuje obyčajný súbor. Obyčajný súbor znamená nie priečinok, ani iná špeciálna položka v rámci súborového systému.

Parametre:

názov – názov súboru alebo priečinka

Návratová hodnota:

true v prípade, že súbor so zadaným názvom jestvuje a ide o normálny súbor, inak false

jeSubor

public static boolean jeSubor(String názov)

Alias pre jeSúbor.

jePriečinok
```
public static boolean jePriečinok(String názov)
```
Overí, či zadaný názov označuje priečinok.

Parametre:

názov – názov súboru alebo priečinka

Návratová hodnota:

true v prípade, že položka so zadaným názvom jestvuje a je to priečinok, inak false

jePriecinok

public static boolean jePriecinok(String názov)

Alias pre jePriečinok.

porovnaj
```
public static boolean porovnaj(String názov1,
                               String názov2)
                        throws IOException
```
Porovná obsah dvoch súborov. Oba názvy musia označovať súbory, inak vznikne výnimka. Ak obidva súbory nejestvujú, je to vyhodnotené ako zhoda. Ak nejestvuje iba jeden zo súborov, vznikne výnimka, preto musí byť príkaz uzavretý do bloku try-catch (pozri napríklad príklad v opise metódy kopíruj). Ak obidva súbory jestvujú, tak sú porovnané a v prípade ich zhody je návratová hodnota rovná true, inak je rovná false.

V rámci obsluhy udalostí je k dispozícii reakcia – sekvencia (s prislúchajúcim variantom pre jednotlivé roboty). Počas procesu porovnávania je uvedená reakcia spúšťaná (samozrejme aj so všetkými jej variantmi) s kódom spracovania POROVNANIE_SÚBOROV.

Parametre:

názov1 – názov (a cesta) prvého súboru

názov2 – názov (a cesta) druhého súboru

Návratová hodnota:

true v prípade, že sú súbory zhodné, inak false

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – jeden zo zadaných objektov nie je súbor alebo nejestvuje len jeden zo súborov (pričom druhý áno)

kopíruj
```
public static void kopíruj(String zdroj,
                           String cieľ,
                           boolean prepísať)
                    throws IOException
```
Skopíruje zdrojový súbor do cieľového súboru. Oba názvy musia označovať súbory, inak vznikne výnimka. Zdrojový súbor musí jestvovať a ak nie je argument prepísať rovný true, cieľový súbor nesmie jestvovať. Počas procesu kopírovania môže vzniknúť výnimka, preto musí byť príkaz uzavretý do bloku try-catch:
```
String zdroj = "citajma.txt";
String cieľ = "zaloha_citajma.txt";

try
{
    Súbor.kopíruj(zdroj, cieľ, true);
    Svet.správa("Súbor „" + zdroj + "“ úspešne skopírovaný do „" + cieľ + "“…");
}
catch (Exception e)
{
    Svet.správa(e.getMessage());
}
```
V rámci obsluhy udalostí je k dispozícii reakcia – sekvencia (s prislúchajúcim variantom pre jednotlivé roboty). Počas procesu kopírovania je uvedená reakcia spúšťaná (samozrejme aj so všetkými jej variantmi) s kódom spracovania KOPÍROVANIE_SÚBOROV.
Parametre:

zdroj – názov (a cesta) zdrojového súboru

cieľ – názov (a cesta) cieľového súboru

prepísať – ak je true, cieľový súbor bude prepísaný (ak jestvuje)

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak argument prepísať je false a cieľový súbor jestvuje; ak cieľový súbor nemôže byť prepísaný, lebo nie je súborom; ak zdrojový súbor nie je súborom; ak zdrojový súbor nejestvuje

kopiruj

public static void kopiruj(String zdroj,
                           String cieľ,
                           boolean prepísať)
                    throws IOException

Alias pre kopíruj.

Výnimky:: IOException

kopíruj
```
public static void kopíruj(String zdroj,
                           String cieľ)
                    throws IOException
```
Skopíruje zdrojový súbor do cieľového súboru. Oba názvy musia označovať súbory, inak vznikne výnimka. Zdrojový súbor musí jestvovať a cieľový súbor nesmie jestvovať. Počas procesu kopírovania môže vzniknúť výnimka, preto musí byť príkaz uzavretý do bloku try-catch (pozri príklad pri kopíruj(zdroj, cieľ, prepísať)).

Parametre:

zdroj – názov (a cesta) zdrojového súboru

cieľ – názov (a cesta) cieľového súboru

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

kopiruj

public static void kopiruj(String zdroj,
                           String cieľ)
                    throws IOException

Alias pre kopíruj.

Výnimky:: IOException

pripoj
```
public static void pripoj(String zdroj,
                          String cieľ)
                   throws IOException
```
Pripojí zdrojový súbor k cieľovému súboru. Oba názvy musia označovať súbory a oba musia jestvovať, inak vznikne výnimka. Počas procesu pripájania môže vzniknúť výnimka, preto musí byť príkaz uzavretý do bloku try-catch (podobne ako ostatné príkazy tejto triedy)…

V rámci obsluhy udalostí je k dispozícii reakcia – sekvencia (s prislúchajúcim variantom pre jednotlivé roboty). Počas procesu pripájania je uvedená reakcia spúšťaná (samozrejme aj so všetkými jej variantmi) s kódom spracovania PRIPÁJANIE_SÚBOROV.

Parametre:

zdroj – názov (a cesta) zdrojového súboru

cieľ – názov (a cesta) cieľového súboru

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak cieľový súbor nemôže byť použitý, lebo nie je súborom; ak zdrojový súbor nie je súborom; alebo ak zdrojový súbor nejestvuje

premenuj
```
public static boolean premenuj(String zdroj,
                               String cieľ)
```
Premenuje (presunie) zdrojový súbor alebo priečinok na cieľový súbor alebo priečinok (do cieľovej cesty). Počas vykonania tejto operácie musí byť braných do úvahy veľa platformovo závislých aspektov. Premenovanie (presun) môže zlyhať z mnohých dôvodov: presun medzi rôznymi súborovými systémami, pokus o presun netriviálnej položky, pokus o premenovanie na názov jestvujúceho súboru… Vždy by ste mali overiť návratovú hodnotu tejto metódy, aby ste si mohli byť istí, že operácia prebehla úspešne.

Parametre:

zdroj – názov (a cesta) zdrojového súboru alebo priečinka

cieľ – názov (a cesta) cieľového súboru alebo priečinka

Návratová hodnota:

true vtedy a len vtedy, ak operácia premenovania prebehla úspešne, inak false

presuň
```
public static boolean presuň(String zdroj,
                             String cieľovýPriečinok)
```
Presunie zdrojový súbor alebo priečinok do cieľovej cesty. Počas vykonania tejto operácie musí byť braných do úvahy veľa platformovo závislých aspektov. Presun môže zlyhať z mnohých dôvodov: presun medzi rôznymi súborovými systémami, pokus o presun netriviálnej položky, pokus o nahradenie jestvujúcej položky pri presune… Vždy by ste mali overiť návratovú hodnotu tejto metódy, aby ste si mohli byť istí, že operácia prebehla úspešne.

Parametre:

zdroj – názov (a cesta) zdrojového súboru alebo priečinka

cieľovýPriečinok – cesta do cieľového priečinka

Návratová hodnota:

true vtedy a len vtedy, ak operácia presunu prebehla úspešne, inak false

presun

public static boolean presun(String zdroj,
                             String cieľovýPriečinok)

Alias pre presuň.

vymaž
```
public static boolean vymaž(String názov)
```
Vymaže súbor alebo priečinok so zadaným názvom. Ak názov označuje priečinok, tak určený priečinok musí byť prázdny, inak nebude môcť byť vymazaný.

Parametre:

názov – názov súboru alebo priečinka

Návratová hodnota:

true vtedy a len vtedy, ak operácia vymazania prebehla úspešne, inak false

vymaz

public static boolean vymaz(String názov)

Alias pre vymaž.

dátumNaReťazec
```
public static String dátumNaReťazec(long miliDátum)
```
Zostaví reťazec dátumu v predvolenom formáte zo zadaného počtu milisekúnd počítaných od začiatku takzvanej epochy. Táto metóda je kópiou metódy dátumNaReťazec. Ďalšie detaily nájdete v jej opise.

Parametre:

miliDátum – dátum v milisekundách epochy

Návratová hodnota:

reťazec dátumu v predvolenom formáte

Pozri tiež:

dátumNaReťazec(long, String), reťazecNaDátum(String), reťazecNaDátum(String, String), naposledyUpravený(String)

datumNaRetazec

public static String datumNaRetazec(long miliDátum)

Alias pre dátumNaReťazec.

dátumNaReťazec
```
public static String dátumNaReťazec(long miliDátum,
                                    String formát)
```
Podľa zadaných údajov vytvorí reťazec dátumu. Prvý parameter je počet milisekúnd počítaných od začiatku takzvanej epochy a druhý parameter určuje požadovaný formát. Táto metóda je kópiou metódy dátumNaReťazec. Ďalšie detaily nájdete v jej opise.

Parametre:

miliDátum – dátum v milisekundách epochy

formát – reťazec určujúci formát dátumu

Návratová hodnota:

reťazec dátumu v zadanom formáte

Pozri tiež:

dátumNaReťazec(long), reťazecNaDátum(String), reťazecNaDátum(String, String), naposledyUpravený(String)

datumNaRetazec

public static String datumNaRetazec(long miliDátum,
                                    String formát)

Alias pre dátumNaReťazec.

reťazecNaDátum
```
public static long reťazecNaDátum(String dátum)
```
Vráti dátum v milisekundách počítaných od začiatku takzvanej epochy. Táto metóda je kópiou metódy reťazecNaDátum. Ďalšie detaily nájdete v jej opise.

Parametre:

dátum – reťazec dátumu v predvolenom formáte

Návratová hodnota:

dátum v milisekundách epochy

Pozri tiež:

dátumNaReťazec(long), dátumNaReťazec(long, String), reťazecNaDátum(String, String), naposledyUpravený(String, long)

retazecNaDatum

public static long retazecNaDatum(String dátum)

Alias pre reťazecNaDátum.

reťazecNaDátum
```
public static long reťazecNaDátum(String dátum,
                                  String formát)
```
Vráti dátum v milisekundách počítaných od začiatku takzvanej epochy. Táto metóda je kópiou metódy reťazecNaDátum. Ďalšie detaily nájdete v jej opise.

Parametre:

dátum – reťazec dátumu v predvolenom formáte

formát – očakávaný formát dátumu

Návratová hodnota:

dátum v milisekundách epochy

Pozri tiež:

dátumNaReťazec(long), dátumNaReťazec(long, String), reťazecNaDátum(String), naposledyUpravený(String, long)

retazecNaDatum

public static long retazecNaDatum(String dátum,
                                  String formát)

Alias pre reťazecNaDátum.

naposledyUpravený
```
public static long naposledyUpravený(String názov)
```
Zistí dátum a čas poslednej úpravy zadaného súboru alebo priečinka. Hodnota je udaná v milisekundách od začiatku takzvanej epochy – polnoc 1. januára 1970, pričom v našom časovom pásme to znamená hodinový posun, čiže jednu hodinu v noci rovnakého dátumu.

Parametre:

názov – názov súboru alebo priečinka

Návratová hodnota:

celočíselná hodnota reprezentujúca čas poslednej úpravy súboru; meraná je v milisekundách od začiatku epochy; ak súbor nejestvuje, návratová hodnota je 0 (začiatok epochy)

Pozri tiež:

naposledyUpravený(String, long), dátumNaReťazec(long), dátumNaReťazec(long, String)

naposledyUpraveny

public static long naposledyUpraveny(String názov)

Alias pre naposledyUpravený.

naposledyUpravený
```
public static void naposledyUpravený(String názov,
                                     long miliDátum)
```
Nastaví dátum a čas poslednej úpravy zadaného súboru alebo priečinka. Hodnota je udaná v milisekundách od začiatku takzvanej epochy – polnoc 1. januára 1970, pričom v našom časovom pásme to znamená hodinový posun, čiže jednu hodinu v noci rovnakého dátumu.

Parametre:

názov – názov súboru alebo priečinka

miliDátum – celočíselná hodnota reprezentujúca dátum a čas v milisekundách meraný od začiatku epochy

Pozri tiež:

naposledyUpravený(String), reťazecNaDátum(String), reťazecNaDátum(String, String)

naposledyUpraveny

public static void naposledyUpraveny(String názov,
                                     long miliDátum)

Alias pre naposledyUpravený.

veľkosť
```
public static long veľkosť(String názov)
```
Zistí veľkosť zadaného súboru alebo zdroja. Ak súbor alebo zdroj nemohli byť nájdené, tak metóda vráti hodnotu −1.

Tip: Ak metóda jestvuje vráti pre zadaný názov hodnotu false, tak vrátená platná veľkosť je veľkosťou zdroja.

Parametre:

názov – názov súboru alebo zdroja

Návratová hodnota:

celočíselná hodnota reprezentujúca veľkosť zadaného súboru alebo zdroja

Pozri tiež:

kdeJeSúbor(String)

velkost

public static long velkost(String názov)

Alias pre veľkosť.

kontrolnýSúčet
```
public static byte[] kontrolnýSúčet(String názov)
```
Vyrobí kontrolný súčet súboru algoritmom SHA1. Tento súčet sa dá použiť na overenie toho, či bol obsah súboru zmenený. Dá sa to využiť napríklad na overenie toho, či sa zmenil obsah konfigurácie zapísanej na disku, pretože je omnoho menej pamäťovo náročné uchovávať v pamäti len kontrolný súčet (kvázi signatúru) súboru ako celý súbor.

Princíp je jednoduchý – uchovať kontrolný súčet vytvorený tesne po prečítaní a spracovaní obsahu súboru (t. j. napr. po prečítaní konfigurácie) a ten neskôr porovnavať s novým súčtom vytvoreným pri vzniku podozrenia na zmeny v súbore (napr. pri zistení zmeny dátumu a času poslednej úpravy súboru). Je minimálna šanca, že by mali súbory s rôznym obsahom a rovnakou veľkosťou rovnaké kontroné súčty (signatúry).

Parametre:

názov – názov súboru

Návratová hodnota:

pole bajtov obsahujúce kontrolný súčet súboru alebo null, ak súbor nejestvuje alebo je to priečinok, prípadne sa nedá čítať

Pozri tiež:

súčtySúZhodné(byte[], byte[])

kontrolnySucet

public static byte[] kontrolnySucet(String názov)

Alias pre kontrolnýSúčet.

súčtySúZhodné
```
public static boolean súčtySúZhodné(byte[] kontrolnýSúčet1,
                                    byte[] kontrolnýSúčet2)
```
Porovná zhodu dvoch kontrolných súčtov súborov. Kontrolné súčty súborov sa dajú získať metódou: kontrolnýSúčet.

Parametre:

kontrolnýSúčet1 – kontrolný súčet 1 (prvý „odtlačok“ súboru na porovnanie oddelený od druhého v čase alebo priestore)

kontrolnýSúčet2 – kontrolný súčet 2 (druhý „odtlačok“ súboru)

Návratová hodnota:

true ak sa súčty zhodujú; true v opačnom prípade

Pozri tiež:

kontrolnýSúčet(String)

suctySuZhodne

public static boolean suctySuZhodne(byte[] kontrolnýSúčet1,
                                    byte[] kontrolnýSúčet2)

Alias pre súčtySúZhodné.

mennýPriestorVlastností
```
public String mennýPriestorVlastností()
```
Zistí aktuálne používaný menný priestor na čítanie a zápis vlastností. Pre viac informácií o účele menného priestoru pozri mennýPriestorVlastností(String).

Návratová hodnota:

vráti aktuálne používaný menný priestor v objekte typu String alebo null ak nie je používaný žiadny menný priestor

mennyPriestorVlastnosti
```
public String mennyPriestorVlastnosti()
```
Alias pre mennýPriestorVlastností.

mennýPriestorVlastností
```
public void mennýPriestorVlastností(String novýMennýPriestor)
```
Stanoví nový menný priestor na čítanie a zápis vlastností.

Menný priestor slúži na oddelenie určitej skupiny vlastností od ostatných vlastností alebo skupín vlastností. Vďaka nemu je napríklad možné zapisovať vlastnosti s rovnakým názvom pre rôzne inštancie objektov.

Menný priestor nesmie byť prázdny, nesmie sa začínať alebo končiť bodkou a nesmie obsahovať znak rovná sa. Ak chceme zrušiť používanie menného priestoru, treba volať túto metódu s argumentom null.

Vo všeobecnosti menný priestor buď je, alebo nie je nastavený. V súčasnej verzii rámca je však implementovaný zásobník menných priestorov a menné priestory je možné s jednoduchosťou vnárať a vynárať.

Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!

Parametre:

novýMennýPriestor – názov nového menného priestoru alebo null na zrušenie používania menného priestoru

Výnimky:

GRobotException – ak názov menného priestoru nespĺňa niektorú požiadavku

mennyPriestorVlastnosti

public void mennyPriestorVlastnosti(String novýMennýPriestor)

Alias pre mennýPriestorVlastností.

vnorMennýPriestorVlastností

public void vnorMennýPriestorVlastností(String vnorenýMennýPriestor)

Zmení menný priestor na čítanie a zápis vlastností tak, aby vznikol vnorený priestor podľa konvencie opísanej nižšie. Pozri aj informácie v opise metódy mennýPriestorVlastností.

Upozornenie: Každá sekcia disponuje vlastným zásobníkom menných priestorov

Ak je namiesto názvu vnoreného menného priestoru zadaná hodnota null, tak je aktuálny menný priestor zálohovaný do vnútorného zásobníka a zostáva nezmenený. (Je to ekvivalentné volaniu metódy vnorMennýPriestorVlastností bez parametra.) Obnoviť ho môžete volaním metódy vynorMennýPriestorVlastností. Až do volania uvedenej metódy môžete ľubovoľne meniť menný priestor metódou mennýPriestorVlastností a nakoniec jej volaním obnoviť posledný zálohovaný stav.

Ak je zadaný korektný názov vnoreného menného priestoru, tak je okrem zálohovania pozmenený aktuálny priestor takto:

Ak predtým nebol aktívny žiadny menný priestor, tak zadaný menný priestor sa stáva hlavným menným priestorom.
Ak bol predtým aktívny ľubovoľný menný priestor, tak je vytvorený vnorený menný priestor podľa konvencie: «aktuálny menný priestor».«vnorený menný priestor»; príklad: starýPriestor.vnorenýPriestor.

Obnoviť predchádzajúci menný priestor môžete aj v tomto prípade rovnako ako v prípade volania tejto metódy s hodnotou null) – volaním metódy vynorMennýPriestorVlastností.

Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!

Príklad:

Upozornenie: Nasledujúci príklad staticky importuje triedy Svet, ÚdajeUdalostí a Math. Je to ukážka toho, ako je možné zjednodušiť písanie kódu v Jave. Negatívnym dôsledkom je nižšia čitateľnosť kódu, pretože statické metódy týchto tried (čo sú v prípade uvedených tried prakticky všetky metódy) nie sú jednoduchým spôsobom odlíšiteľné (nemajú prefix triedy).

Tento príklad ukazuje využitie vnárania menných priestorov v rámci jednoduchej aplikácie – skicára miestností.

// Upozornenie! Tento príklad staticky importuje triedy Svet, ÚdajeUdalostí
// a Math. Je to ukážka toho, ako je možné zjednodušiť písanie kódu v Jave.
// Negatívnym dôsledkom je nižšia čitateľnosť kódu, pretože statické metódy
// týchto tried (čo sú v prípade uvedených tried prakticky všetky ich metódy)
// nie sú jednoduchým spôsobom odlíšiteľné (nemajú prefix triedy).

import knižnica.*;
import java.io.IOException;

import static java.lang.Math.*;
import static knižnica.Svet.*;
import static knižnica.ÚdajeUdalostí.*;

public class SkicárMiestností extends GRobot
{
    // Menovka miestnosti použitá v prípade, keď je názov miestnosti
    // rovný null. To môže nastať v prípade, že používateľ zruší zadávanie
    // názvu novej miestnosti – miestnosť je síce vytvorená, ale nemá meno.
    private final static String bezMena = "«bez mena»";

    // Trieda zhromažďujúca informácie o miestnosti.
    private class Miestnosť extends Častica
    {
        public String meno = null;

        // Prečítanie záznamu o miestnosti z konfiguračného súboru.
        public void čítajZoSúboru(Súbor súbor, String identifikátor)
            throws IOException
        {
            súbor.vnorMennýPriestorVlastností(identifikátor);
            try
            {
                meno = orežMeno(súbor.čítajVlastnosť("meno", meno));
                x = súbor.čítajVlastnosť("x", x);
                y = súbor.čítajVlastnosť("y", y);
                uhol = súbor.čítajVlastnosť("uhol", uhol);
                w = súbor.čítajVlastnosť("šírka", w);
                h = súbor.čítajVlastnosť("výška", h);
            }
            finally
            {
                súbor.vynorMennýPriestorVlastností();
            }
        }

        // Zapísanie záznamu o miestnosti do konfiguračného súboru.
        public void uložDoSúboru(Súbor súbor, String identifikátor)
            throws IOException
        {
            súbor.vnorMennýPriestorVlastností(identifikátor);
            try
            {
                súbor.zapíšVlastnosť("meno", meno);
                súbor.zapíšVlastnosť("x", x);
                súbor.zapíšVlastnosť("y", y);
                súbor.zapíšVlastnosť("uhol", uhol);
                súbor.zapíšVlastnosť("šírka", w);
                súbor.zapíšVlastnosť("výška", h);
            }
            finally
            {
                súbor.vynorMennýPriestorVlastností();
            }
        }
    }

    // Zoznam pracovných režimov.
    private final static int PASÍVNY = 0;
    private final static int UPRAV_MIESTNOSŤ = 1;
    private final static int ŤAHAJ_MIESTNOSŤ = 2;
    private final static int PRESUŇ_MIESTNOSŤ = 3;
    private final static int PRESUŇ_VŠETKO = 4;

    // Aktuálny pracovný režim.
    private int režim = PASÍVNY;

    // Aktuálna inštancia miestnosti.
    private Miestnosť miestnosť = null;

    // Pracovné súradnice myši.
    private double myšX = 0.0, myšY = 0.0;
    private double myšZX = 0.0, myšZY = 0.0;

    // Zoznam vytvorených miestností.
    private final Zoznam<Miestnosť> miestnosti = new Zoznam<Miestnosť>();

    // Konštruktor.
    private SkicárMiestností()
    {
        super("Skicár miestností…");
        farbaPozadia(šedá);
        farbaPlochy(tmavošedá);
        písmo("Calibri", 14);
        hrúbkaČiary(2.5);
        skry();

        // Čítanie a zápis konfigurácie. Zapisuje sa počet miestností a každá
        // miestnosť je zapísaná do vnoreného menného priestoru s unikátnym
        // názvom (identifikátorom).
        new ObsluhaUdalostí()
        {
            @Override public boolean konfiguráciaZmenená()
            { return true; }

            @Override public void zapíšKonfiguráciu(Súbor súbor)
                throws IOException
            {
                int početMiestností = miestnosti.veľkosť();
                súbor.zapíšPrázdnyRiadokVlastností();
                súbor.zapíšVlastnosť("početMiestností", početMiestností);

                for (int i = 0; i < početMiestností; ++i)
                {
                    súbor.zapíšPrázdnyRiadokVlastností();
                    miestnosti.daj(i).uložDoSúboru(súbor,
                        "miestnosť[" + i + "]");
                }
            }

            @Override public void čítajKonfiguráciu(Súbor súbor)
                throws IOException
            {
                int početMiestností = súbor.čítajVlastnosť(
                    "početMiestností", 0);
                for (int i = 0; i < početMiestností; ++i)
                {
                    Miestnosť miestnosť = new Miestnosť();
                    miestnosť.čítajZoSúboru(súbor, "miestnosť[" + i + "]");
                    miestnosti.pridaj(miestnosť);
                }
            }
        };
    }

    // Pomocná metóda zaokrúhľujúca súradnice myši do mriežky.
    private void zaokrúhliMyš()
    {
        myšX = polohaMyšiX(); myšX += najmenšieX();
        myšY = polohaMyšiY(); myšY += najmenšieY();

        myšX /= 10; myšX = (int)myšX; myšX *= 10;
        myšY /= 10; myšY = (int)myšY; myšY *= 10;

        myšX -= najmenšieX();
        myšY -= najmenšieY();
    }

    // Pomocná metóda zbavujúca nadbytočných medzier názov miestnosti
    // (prípadne iného objektu).
    private String orežMeno(String meno)
    {
        return meno.replaceAll("\\s+", " ").trim();
    }

    // Pomocná metóda slúžiaca na zadanie alebo úpravu názvu miestnosti.
    private void premenuj(Miestnosť miestnosť)
    {
        if (null != miestnosť)
        {
            String meno = null == miestnosť.meno ? zadajReťazec(
                "Zadaj meno miestnosti") : upravReťazec(miestnosť.meno,
                "Uprav meno miestnosti");
            if (null != meno) miestnosť.meno = orežMeno(meno);
        }
    }

    // Časť ovládania myšou.
    @Override public void ťahanieMyšou()
    {
        switch (režim)
        {
        case PASÍVNY:
            // Začatie ťahania myšou so stlačeným klávesom Ctrl v pasívnom
            // režime začne definíciu novej miestnosti.
            if (myš().isControlDown())
            {
                zaokrúhliMyš();
                miestnosť = new Miestnosť();
                miestnosť.x = myšZX = myšX;
                miestnosť.y = myšZY = myšY;
                miestnosti.pridaj(miestnosť);
                režim = ŤAHAJ_MIESTNOSŤ;
                žiadajPrekreslenie();
            }

            // Klasické ťahanie myšou v pasívnom režime buď ťahá všetko,
            // alebo miestnosť na polohe myši.
            else
            {
                zaokrúhliMyš();
                myšZX = myšX;
                myšZY = myšY;
                režim = PRESUŇ_VŠETKO;
                for (Miestnosť miestnosť : miestnosti)
                {
                    skočNa(miestnosť);
                    if (myšVObdĺžniku(5 + miestnosť.w, 5 + miestnosť.h))
                    {
                        this.miestnosť = miestnosť;
                        režim = PRESUŇ_MIESTNOSŤ;
                        žiadajPrekreslenie();
                        break;
                    }
                }
            }
            break;

        case UPRAV_MIESTNOSŤ:
            // Ťahanie v režime úpravy miestnosti (t. j. keď je niektorá
            // miestnosť označená) ukončí tento režim a vykoná to isté ako
            // v pasívnom režime.
            režim = PASÍVNY;
            miestnosť = null;
            ťahanieMyšou();
            break;

        case ŤAHAJ_MIESTNOSŤ:
            // Režim ťahania novej miestnosti – mení rozmery miestnosti.
            zaokrúhliMyš();
            miestnosť.w = 10 + abs(myšX - myšZX);
            miestnosť.h = 10 + abs(myšY - myšZY);
            žiadajPrekreslenie();
            break;

        case PRESUŇ_MIESTNOSŤ:
            // Režim presúvania alebo zmeny rozmeru označenej miestnosti.
            zaokrúhliMyš();
            if (myš().isShiftDown())
            {
                // (Stlačenie klávesu Shift znamená zmenu rozmerov miestnosti.)
                if (myšX >= miestnosť.x)
                    miestnosť.w += myšX - myšZX;
                else
                    miestnosť.w += myšZX - myšX;

                if (myšY >= miestnosť.y)
                    miestnosť.h += myšY - myšZY;
                else
                    miestnosť.h += myšZY - myšY;
            }
            else
            {
                miestnosť.x += myšX - myšZX;
                miestnosť.y += myšY - myšZY;
            }
            myšZX = myšX;
            myšZY = myšY;
            žiadajPrekreslenie();
            break;

        case PRESUŇ_VŠETKO:
            // Režim presúvania všetkého definovaného…
            zaokrúhliMyš();
            for (Miestnosť miestnosť : miestnosti)
            {
                miestnosť.x += myšX - myšZX;
                miestnosť.y += myšY - myšZY;
            }
            myšZX = myšX;
            myšZY = myšY;
            žiadajPrekreslenie();
            break;
        }
    }

    // Časť ovládania myšou – ukončuje ťahanie myšou.
    // (Kód je krátky a samovysvetľujúci.)
    @SuppressWarnings("fallthrough")
    @Override public void uvoľnenieTlačidlaMyši()
    {
        switch (režim)
        {
        case ŤAHAJ_MIESTNOSŤ:
            premenuj(miestnosť);
            // no break – fallthrough

        case PRESUŇ_MIESTNOSŤ:
            režim = UPRAV_MIESTNOSŤ;
            žiadajPrekreslenie();
            break;

        case PRESUŇ_VŠETKO:
            režim = PASÍVNY;
            break;
        }
    }

    // Časť ovládania myšou – klinutie sa vykoná vtedy, keď nenastalo
    // ťahanie myšou.
    @Override public void klik()
    {
        switch (režim)
        {
        case PASÍVNY:
            // Kliknutie v pasívnom režime so stlačeným klávesom Ctrl začne
            // definíciu novej miestnosti, ale na rozdiel od ťahania myšou si
            // najskôr vyžiada názov miestnosti.
            if (myš().isControlDown())
            {
                zaokrúhliMyš();
                miestnosť = new Miestnosť();
                miestnosť.w = 20;
                miestnosť.x = myšX;
                miestnosť.y = myšY;
                premenuj(miestnosť);
                miestnosti.pridaj(miestnosť);
                režim = UPRAV_MIESTNOSŤ;
                žiadajPrekreslenie();
            }
            else
            {
                // Kliknutie na niektorú miestnosť ju označí.
                for (Miestnosť miestnosť : miestnosti)
                {
                    skočNa(miestnosť);
                    if (myšVObdĺžniku(5 + miestnosť.w, 5 + miestnosť.h))
                    {
                        this.miestnosť = miestnosť;
                        režim = UPRAV_MIESTNOSŤ;
                        žiadajPrekreslenie();
                        break;
                    }
                }
            }
            break;

        case UPRAV_MIESTNOSŤ:
            skočNa(miestnosť);
            // Kliknutie na označenú miestnosť spustí úpravu jej názvu.
            if (myšVObdĺžniku(5 + miestnosť.w, 5 + miestnosť.h))
            {
                premenuj(miestnosť);
            }
            // Kliknutie mimo označenej miestnosti buď prejde do pasívneho
            // režimu, alebo označí inú miestnosť (podľa polohy myši).
            else
            {
                režim = PASÍVNY;
                miestnosť = null;
                for (Miestnosť miestnosť : miestnosti)
                {
                    skočNa(miestnosť);
                    if (myšVObdĺžniku(5 + miestnosť.w, 5 + miestnosť.h))
                    {
                        this.miestnosť = miestnosť;
                        režim = UPRAV_MIESTNOSŤ;
                        break;
                    }
                }
            }
            žiadajPrekreslenie();
            break;
        }
    }

    // Časovač – implementuje prekresľovanie scény.
    @Override public void tik()
    {
        if (neboloPrekreslené())
        {
            podlaha.vymažGrafiku();

            farba(čierna);
            for (Miestnosť miestnosť : miestnosti)
            {
                skočNa(miestnosť);
                if (miestnosť.w < 0.0) miestnosť.w = 0.0;
                if (miestnosť.h < 0.0) miestnosť.h = 0.0;
                if (miestnosť == this.miestnosť)
                {
                    farba(oranžová);
                    if (0.0 == miestnosť.w && 0.0 == miestnosť.h)
                        kruh(2.0);
                    else
                        kresliObdĺžnik(miestnosť.w, miestnosť.h);
                    farba(čierna);
                }
                else if (0.0 == miestnosť.w && 0.0 == miestnosť.h)
                    kruh(2.0);
                else
                    kresliObdĺžnik(miestnosť.w, miestnosť.h);
            }

            farba(biela);
            for (Miestnosť miestnosť : miestnosti)
            {
                skočNa(miestnosť);
                if (0.0 <= miestnosť.w && 0.0 <= miestnosť.h)
                    vyplňObdĺžnik(miestnosť.w, miestnosť.h);
            }

            farba(hnedá);
            for (Miestnosť miestnosť : miestnosti)
            {
                skočNa(miestnosť);
                if (miestnosť == this.miestnosť)
                {
                    if (null != miestnosť.meno)
                    {
                        farba(šedá);
                        if (90.0 != miestnosť.uhol)
                        {
                            vľavo(90 - miestnosť.uhol);
                            text(miestnosť.meno);
                            vpravo(90 - miestnosť.uhol);
                        }
                        else text(miestnosť.meno);
                        farba(hnedá);
                    }
                }
                else if (90.0 != miestnosť.uhol)
                {
                    vľavo(90 - miestnosť.uhol);
                    if (null == miestnosť.meno)
                        text(bezMena); else text(miestnosť.meno);
                    vpravo(90 - miestnosť.uhol);
                }
                else if (null == miestnosť.meno)
                    text(bezMena); else text(miestnosť.meno);
            }

            prekresli();
        }
    }

    // Ovládanie klávesnicou.
    @Override public void stlačenieKlávesu()
    {
        switch (režim)
        {
        case PASÍVNY:
            if (klávesnica().isControlDown())
            {
                switch (kláves())
                {
                // Ctrl + kurzorové klávesy v pasívnom režime otáčajú scénu.
                case Kláves.VPRAVO:
                    {
                        double a, b;
                        for (Miestnosť miestnosť : miestnosti)
                        {
                            a = miestnosť.x;
                            b = miestnosť.y;
                            miestnosť.x = b;
                            miestnosť.y = -a;
                            a = miestnosť.w;
                            b = miestnosť.h;
                            miestnosť.w = b;
                            miestnosť.h = a;
                            if (klávesnica().isShiftDown())
                                miestnosť.uhol += 90;
                        }
                    }
                    žiadajPrekreslenie();
                    break;

                case Kláves.VĽAVO:
                    {
                        double a, b;
                        for (Miestnosť miestnosť : miestnosti)
                        {
                            a = miestnosť.x;
                            b = miestnosť.y;
                            miestnosť.x = -b;
                            miestnosť.y = a;
                            a = miestnosť.w;
                            b = miestnosť.h;
                            miestnosť.w = b;
                            miestnosť.h = a;
                            if (klávesnica().isShiftDown())
                                miestnosť.uhol -= 90;
                        }
                    }
                    žiadajPrekreslenie();
                    break;

                // Ctrl + plus v pasívnom režime zväčší všetky miestnosti
                // a odsunie ich od stredu scény (pokus o jemnejšiu zmenu
                // mierky – s aktívnou mriežkou to nebolo možné implementovať
                // lepšie).
                // Ctrl + Shift + plus urobí opak – to isté, čo Ctrl + mínus.
                case Kláves.VK_PLUS:
                case Kláves.VK_ADD:
                    if (klávesnica().isShiftDown())
                    {
                        for (Miestnosť miestnosť : miestnosti)
                        {
                            if (miestnosť.x >= 0.0)
                                miestnosť.x -= 20.0;
                            else
                                miestnosť.x += 20.0;
                            if (miestnosť.y >= 0.0)
                                miestnosť.y -= 20.0;
                            else
                                miestnosť.y += 20.0;
                            miestnosť.w -= 10.0;
                            miestnosť.h -= 10.0;
                        }
                        žiadajPrekreslenie();
                    }
                    else
                    {
                        for (Miestnosť miestnosť : miestnosti)
                        {
                            if (miestnosť.x >= 0.0)
                                miestnosť.x += 20.0;
                            else
                                miestnosť.x -= 20.0;
                            if (miestnosť.y >= 0.0)
                                miestnosť.y += 20.0;
                            else
                                miestnosť.y -= 20.0;
                            miestnosť.w += 10.0;
                            miestnosť.h += 10.0;
                        }
                        žiadajPrekreslenie();
                    }
                    break;

                // Ctrl + mínus v pasívnom režime zmenší všetky miestnosti
                // a priblíži ich k stredu scény…
                // Ctrl + Shift + mínus urobí opak – to isté, čo Ctrl + plus.
                case Kláves.VK_MINUS:
                case Kláves.VK_SUBTRACT:
                    if (klávesnica().isShiftDown())
                    {
                        for (Miestnosť miestnosť : miestnosti)
                        {
                            if (miestnosť.x >= 0.0)
                                miestnosť.x += 20.0;
                            else
                                miestnosť.x -= 20.0;
                            if (miestnosť.y >= 0.0)
                                miestnosť.y += 20.0;
                            else
                                miestnosť.y -= 20.0;
                            miestnosť.w += 10.0;
                            miestnosť.h += 10.0;
                        }
                        žiadajPrekreslenie();
                    }
                    else
                    {
                        for (Miestnosť miestnosť : miestnosti)
                        {
                            if (miestnosť.x >= 0.0)
                                miestnosť.x -= 20.0;
                            else
                                miestnosť.x += 20.0;
                            if (miestnosť.y >= 0.0)
                                miestnosť.y -= 20.0;
                            else
                                miestnosť.y += 20.0;
                            miestnosť.w -= 10.0;
                            miestnosť.h -= 10.0;
                        }
                        žiadajPrekreslenie();
                    }
                    break;

                // Ctrl + hviezdička v pasívnom režime zdvojnásobí
                // mierku scény.
                // Ctrl + Shift + hviezdička urobí opak, len s vyžiadaním
                // potvrdenia akcie – to isté, čo Ctrl + lomka.
                case Kláves.VK_ASTERISK:
                case Kláves.VK_MULTIPLY:
                    if (klávesnica().isShiftDown())
                    {
                        if (ÁNO == otázka("Určite chcete znížiť " +
                            "rozlíšenie plánu?"))
                        {
                            for (Miestnosť miestnosť : miestnosti)
                            {
                                miestnosť.x /= 2.0;
                                miestnosť.y /= 2.0;
                                miestnosť.w /= 2.0;
                                miestnosť.h /= 2.0;
                            }
                            žiadajPrekreslenie();
                        }
                    }
                    else
                    {
                        for (Miestnosť miestnosť : miestnosti)
                        {
                            miestnosť.x *= 2.0;
                            miestnosť.y *= 2.0;
                            miestnosť.w *= 2.0;
                            miestnosť.h *= 2.0;
                        }
                        žiadajPrekreslenie();
                    }
                    break;

                // Ctrl + lomka v pasívnom režime zmenší mierku scény na
                // polovicu, avšak predtým si vyžiada potvrdenie akcie,
                // pretože hrozí deformácia scény mimo mriežku (toto nie
                // je v tejto verzii ošetrené).
                // Ctrl + Shift + lomka urobí opak – to isté, čo
                // Ctrl + hviezdička.
                case Kláves.VK_SLASH:
                case Kláves.VK_DIVIDE:
                    if (klávesnica().isShiftDown())
                    {
                        for (Miestnosť miestnosť : miestnosti)
                        {
                            miestnosť.x *= 2.0;
                            miestnosť.y *= 2.0;
                            miestnosť.w *= 2.0;
                            miestnosť.h *= 2.0;
                        }
                        žiadajPrekreslenie();
                    }
                    else
                    {
                        if (ÁNO == otázka("Určite chcete znížiť " +
                            "rozlíšenie plánu?"))
                        {
                            for (Miestnosť miestnosť : miestnosti)
                            {
                                miestnosť.x /= 2.0;
                                miestnosť.y /= 2.0;
                                miestnosť.w /= 2.0;
                                miestnosť.h /= 2.0;
                            }
                            žiadajPrekreslenie();
                        }
                    }
                    break;
                }
            }
            // Kurzorové klávesy (bez Ctrl) v pasívnom režime presúvajú scénu.
            else
            {
                switch (kláves())
                {
                case Kláves.HORE:
                    for (Miestnosť miestnosť : miestnosti)
                        miestnosť.y += 10;
                    žiadajPrekreslenie();
                    break;

                case Kláves.DOLE:
                    for (Miestnosť miestnosť : miestnosti)
                        miestnosť.y -= 10;
                    žiadajPrekreslenie();
                    break;

                case Kláves.VPRAVO:
                    for (Miestnosť miestnosť : miestnosti)
                        miestnosť.x += 10;
                    žiadajPrekreslenie();
                    break;

                case Kláves.VĽAVO:
                    for (Miestnosť miestnosť : miestnosti)
                        miestnosť.x -= 10;
                    žiadajPrekreslenie();
                    break;
                }
            }
            break;

        case UPRAV_MIESTNOSŤ:
            // Režim úpravy miestnosti…
            if (klávesnica().isShiftDown())
            {
                // Shift + kurzorové klávesy menia veľkosť
                // označenej miestnosti.
                switch (kláves())
                {
                case Kláves.HORE:
                    miestnosť.h += 10;
                    žiadajPrekreslenie();
                    break;

                case Kláves.DOLE:
                    miestnosť.h -= 10;
                    žiadajPrekreslenie();
                    break;

                case Kláves.VPRAVO:
                    miestnosť.w += 10;
                    žiadajPrekreslenie();
                    break;

                case Kláves.VĽAVO:
                    miestnosť.w -= 10;
                    žiadajPrekreslenie();
                    break;
                }
            }
            else if (klávesnica().isControlDown())
            {
                // Ctrl + kurzorové klávesy menia orientáciu textu názvu
                // označenej miestnosti. Klávesy vpravo a vľavo otáčajú
                // text o 90°, klávesy hore a dole jemnejšie – o 15°.
                switch (kláves())
                {
                case Kláves.HORE:
                    miestnosť.uhol -= 15;
                    žiadajPrekreslenie();
                    break;

                case Kláves.DOLE:
                    miestnosť.uhol += 15;
                    žiadajPrekreslenie();
                    break;

                case Kláves.VPRAVO:
                    miestnosť.uhol += 90;
                    žiadajPrekreslenie();
                    break;

                case Kláves.VĽAVO:
                    miestnosť.uhol -= 90;
                    žiadajPrekreslenie();
                    break;
                }
            }
            else
            {
                // Kurzorové klávesy (bez Ctrl a Shift) presúvajú
                // označenú miestnosť.
                switch (kláves())
                {
                case Kláves.HORE:
                    miestnosť.y += 10;
                    žiadajPrekreslenie();
                    break;

                case Kláves.DOLE:
                    miestnosť.y -= 10;
                    žiadajPrekreslenie();
                    break;

                case Kláves.VPRAVO:
                    miestnosť.x += 10;
                    žiadajPrekreslenie();
                    break;

                case Kláves.VĽAVO:
                    miestnosť.x -= 10;
                    žiadajPrekreslenie();
                    break;

                // Klávesy Escape a Enter ukončia režim úprav – zrušia
                // označenie miestnosti.
                case Kláves.ESCAPE:
                case Kláves.ENTER:
                    režim = PASÍVNY;
                    miestnosť = null;
                    žiadajPrekreslenie();
                    break;

                // Kláves Delete si vyžiada potvrdenie na vymazanie
                // miestnosti a v prípade pozitívnej odpovede ju vymaže.
                case Kláves.DELETE:
                    if (ÁNO == otázka("Určite chcete vymazať miestnosť?"))
                    {
                        miestnosti.odober(miestnosť);
                        režim = PASÍVNY;
                        miestnosť = null;
                        žiadajPrekreslenie();
                    }
                    break;
                }
            }
            break;
        }
    }

    // Vstupný bod programu.
    public static void main(String[] args)
    {
        // (Poznámka: Okrem konštruktora príkladu sú všetky metódy
        // v tomto bloku statickými metódami sveta – pozri upozornenie
        // na začiatku príkladu.)
        nekresli();
        použiKonfiguráciu("SkicárMiestností.cfg");
        new SkicárMiestností();

        if (prvéSpustenie())
        {
            zbaľ();
            vystreď();
        }

        spustiČasovač();
    }
}

Ukážka aplikácie:

Skicár
miestností.

Ukážka vzhľadu miniaplikácie „Skicár miestností.“

Parametre:: vnorenýMennýPriestor – názov vnoreného menného priestoru alebo null na zálohovanie aktuálneho menného priestoru
Výnimky:: GRobotException – ak názov vnoreného menného priestoru nespĺňa niektorú požiadavku – pozri informácie v opise metódy mennýPriestorVlastností

vnorMennyPriestorVlastnosti

public void vnorMennyPriestorVlastnosti(String vnorenýMennýPriestor)

Alias pre vnorMennýPriestorVlastností.

vnorMennýPriestorVlastností
```
public void vnorMennýPriestorVlastností()
```
Zálohuje aktuálny menný priestor na čítanie a zápis vlastností do vnútorného zásobníka. Obnoviť ho môžete volaním metódy vynorMennýPriestorVlastností.

Upozornenie: Každá sekcia disponuje vlastným zásobníkom menných priestorov

Pozri aj informácie a príklad v opise metódy vnorMennýPriestorVlastností.

vnorMennyPriestorVlastnosti
```
public void vnorMennyPriestorVlastnosti()
```
Alias pre vnorMennýPriestorVlastností.

vynorMennýPriestorVlastností
```
public void vynorMennýPriestorVlastností()
```
Obnoví posledný zálohovaný menný priestor na čítanie a zápis vlastností z vnútorného zásobníka. Zásobník nesmie byť prázdny, inak vznikne výnimka. Pozri aj informácie v opise metódy vnorMennýPriestorVlastností.

Upozornenie: Každá sekcia disponuje vlastným zásobníkom menných priestorov

Pozri aj informácie a príklad v opise metódy vnorMennýPriestorVlastností.

Výnimky:

EmptyStackException – ak je vnútorný zásobník menných priestorov prázdny

vynorMennyPriestorVlastnosti
```
public void vynorMennyPriestorVlastnosti()
```
Alias pre vynorMennýPriestorVlastností.

predvolenáCestaDialógov
```
public static String predvolenáCestaDialógov()
```
Zistí, aká je aktuálna predvolená cesta (systémových pomocných) dialógov na otvorenie a uloženie súborov. Ak je návratová hodnota rovná null (alebo prázdny reťazec), tak to znamená, že dialógy nemajú žiadnu predvolenú cestu a budú otvorené na umiestnení, ktoré určí operačný systém.

Návratová hodnota:

aktuálna predvolená cesta dialógov na otvorenie a uloženie súborov

predvolenaCestaDialogov
```
public static String predvolenaCestaDialogov()
```
Alias pre predvolenáCestaDialógov.

predvolenáCestaDialógov
```
public static void predvolenáCestaDialógov(String cesta)
```
Nastaví novú predvolenú cestu (systémových pomocných) dialógov na otvorenie a uloženie súborov. Ak je zadaná hodnota rovná null (alebo prázdny reťazec), tak to znamená, že dialógy nemajú žiadnu predvolenú cestu a budú otvorené na umiestnení, ktoré určí operačný systém.

Tip: Neoficiálnym trikom na voľbu priečinka aktuálneho pri spustení aplikácie (ktorý nie je podpoprovaný všetkými operačnými systémami) je zadanie reťazca "." (ktorý má v podporovaných OS presne význam aktuálneho priečinka).

Parametre:

cesta – nová predvolená cesta dialógov na otvorenie a uloženie súborov

predvolenaCestaDialogov

public static void predvolenaCestaDialogov(String cesta)

Alias pre predvolenáCestaDialógov.

dialógOtvoriť
```
public static String dialógOtvoriť(String titulok)
```
Otvorí používateľský dialóg na otvorenie súboru, ktorý vráti reťazec s úplnou cestou a názvom súboru zvoleného v dialógu používateľom. Ak používateľ dialóg zruší, návratová hodnota je null. Programátor zadáva titulok dialógu, s ktorým bude dialóg otvorený používateľovi.

Parametre:

titulok – titulok dialógu

Návratová hodnota:

úplná cesta a názov súboru alebo null

dialogOtvorit

public static String dialogOtvorit(String titulok)

Alias pre dialógOtvoriť.

dialógOtvoriť
```
public static String dialógOtvoriť(String titulok,
                                   String predvolenýNázovSúboru,
                                   String... filtre)
```
Otvorí používateľský dialóg na otvorenie súboru, ktorý vráti reťazec s úplnou cestou a názvom súboru zvoleného v dialógu používateľom. Ak používateľ dialóg zruší, návratová hodnota je null. Programátor zadáva titulok dialógu, predvolený názov súboru, s ktorými bude dialóg otvorený používateľovi a prípadne aj jeden alebo viacero filtrov obsahujúcich šablóny masiek, ktoré určia súbory, ktoré sú v dialógu buď viditeľné (v OS Windows), alebo dovolené zvoliť (v macOS, predtým OS X a Mac OS – v tomto systéme sú vždy viditeľné všetky bežne zobrazované súbory, ale tie, ktoré nevyhovujú kritériám filtra sú „šedé“ – používateľovi nie je umožnené ich zvoliť). Filtre sú zadávané vo forme reťazca, ktorý bude k dispozícii na výber v dialógu, a ktorý musí obsahovať aspoň jeden reťazec v tvare *.«prípona»«oddeľovač», pričom platnými oddeľovačmi sú bodkočiarka (;), čiarka (,), zvislá čiara (|), koncová zátvorka ()) a elipsa (…), inak bude filter ignorovaný. Príkladom platného filtra môže byť: "Obrázky vo formátoch GIF, PNG a JPEG (*.gif, *.png, *.jpeg…)"

Poznámka: Filtre sú dostupné iba pri tejto verzii metódy z dôvodu rozlíšiteľnosti dvoch verzií metódy. Ide o principiálne obmedzenie jazyka Java. Ak si neželáte zadať predvolený názov súboru, použite hodnotu null. Z dôvodu použitia filtrov otvára táto verzia metódy principiálne iný typ dialógu ako jej staršia verzia.

Parametre:

titulok – titulok dialógu

predvolenýNázovSúboru – predvolený názov súboru poskytovaný dialógom, ktorý je v niektorých operačných systémoch (konkrétne macOS – predtým OS X a Mac OS) žiaľ aj tak ignorovaný (pri dialógu slúžiacom na voľbu súboru na uloženie to neplatí)

filtre – jeden alebo viac nepovinných reťazcov filtrov (obsahujúcich masky) určujúcich, ktoré súbory majú byť v dialógu zobrazené (v OS Windows) alebo dovolené vybrať (v macOS – predtým OS X a Mac OS)

Návratová hodnota:

úplná cesta a názov súboru alebo null

dialogOtvorit

public static String dialogOtvorit(String titulok,
                                   String predvolenýNázovSúboru,
                                   String... filtre)

Alias pre dialógOtvoriť.

dialógUložiť
```
public static String dialógUložiť(String titulok)
```
Otvorí používateľský dialóg na uloženie súboru, ktorý vráti reťazec s úplnou cestou a názvom súboru zvoleného v dialógu používateľom. Ak používateľ dialóg zruší, návratová hodnota je null. Programátor zadáva titulok dialógu, s ktorým bude dialóg otvorený používateľovi.

Parametre:

titulok – titulok dialógu

Návratová hodnota:

úplná cesta a názov súboru alebo null

dialogUlozit

public static String dialogUlozit(String titulok)

Alias pre dialógUložiť.

dialógUložiť
```
public static String dialógUložiť(String titulok,
                                  String predvolenýNázovSúboru,
                                  String... filtre)
```
Otvorí používateľský dialóg na uloženie súboru, ktorý vráti reťazec s úplnou cestou a názvom súboru zvoleného v dialógu používateľom. Ak používateľ dialóg zruší, návratová hodnota je null. Programátor zadáva titulok dialógu, predvolený názov súboru, s ktorými bude dialóg otvorený používateľovi a prípadne aj jeden alebo viacero filtrov obsahujúcich šablóny masiek, ktoré určia súbory, ktoré sú v dialógu buď viditeľné (v OS Windows), alebo dovolené zvoliť (v macOS, predtým OS X a Mac OS – v tomto systéme sú vždy viditeľné všetky bežne zobrazované súbory, ale tie, ktoré nevyhovujú kritériám filtra sú „šedé“ – používateľovi nie je umožnené ich zvoliť). Filtre sú zadávané vo forme reťazca, ktorý bude k dispozícii na výber v dialógu, a ktorý musí obsahovať aspoň jeden reťazec v tvare *.«prípona»«oddeľovač», pričom platnými oddeľovačmi sú bodkočiarka (;), čiarka (,), zvislá čiara (|), koncová zátvorka ()) a elipsa (…), inak bude filter ignorovaný. Príkladom platného filtra môže byť: "Obrázky vo formátoch GIF, PNG a JPEG (*.gif, *.png, *.jpeg…)"

Poznámka: Filtre sú dostupné iba pri tejto verzii metódy z dôvodu rozlíšiteľnosti dvoch verzií metódy. Ide o principiálne obmedzenie jazyka Java. Ak si neželáte zadať predvolený názov súboru, použite hodnotu null. Z dôvodu použitia filtrov otvára táto verzia metódy principiálne iný typ dialógu ako jej staršia verzia.

Parametre:

titulok – titulok dialógu

predvolenýNázovSúboru – predvolený názov súboru poskytovaný dialógom

filtre – jeden alebo viac nepovinných reťazcov filtrov (obsahujúcich masky) určujúcich, ktoré súbory majú byť v dialógu zobrazené (v OS Windows) alebo dovolené vybrať (v macOS – predtým OS X a Mac OS)

Návratová hodnota:

úplná cesta a názov súboru alebo null

dialogUlozit

public static String dialogUlozit(String titulok,
                                  String predvolenýNázovSúboru,
                                  String... filtre)

Alias pre dialógUložiť.

kdeJeSúbor
```
public static String kdeJeSúbor(String názovSúboru)
```
Vyhľadá skutočné umiestnenie súboru určeného na čítanie alebo vráti hodnotu null, ak súbor nebol nájdený. Súbor je prednostne vyhľadaný v rámci aktuálneho umiestnenia (cesty) určeného na čítanie (a zápis) súborov. Ak nie je nájdený, tak je prehľadaný zoznam ciest classpath. Ak i tak nie je nájdený, tak je nakoniec prehľadaný aktuálny balíček .jar. Ak súbor nie je nájdený ani tam, tak je vrátená hodnota null. V prípade, že sa súbor nachádza v .jar súbore, tak je vrátená cesta v nasledujúcom tvare:

jar:file:«úplná cesta k .jar súboru»!«cesta a názov súboru v rámci .jar súboru»

Poznámka: Pre používateľov OS Windows môže byť neštandardné, že obe cesty súvisiace s .jar súborom budú v úlohe oddeľovačov priečinkov lomky (/) obsahovať namiesto spätných lomiek (\) a zároveň sa budú lomkou aj začínať (a to aj napriek tomu, že za touto prvou lomkou bude uvedená jednotka, na ktorej je .jar súbor umiestnený).

Parametre:

názovSúboru – názov súboru (určeného na čítanie)

Návratová hodnota:

skutočné umiestnenie súboru alebo null, ak súbor nebol nájdený na žiadnej z prehľadávaných lokalít

Pozri tiež:

jestvuje(String)

kdeJeSubor

public String kdeJeSubor(String názovSúboru)

Alias pre kdeJeSúbor.

pripojArchív
```
public void pripojArchív(Archív archív)
```
Priradí k tomuto súboru zadanú inštanciu archívu. Používanie inštancie sa nezmení, ale najbližšie volanie metód otvorNa… (čítanie alebo zápis; všetky verzie) neotvorí súbor na disku (alebo inom zdroji), ale vyhľadá alebo vytvorí položku v archíve. Archív musí byť buď vopred otvorený na čítanie alebo zápis (podľa toho, čo chceme vykonať), alebo musí byť povolené automatické otvorenie archívu. Inak vznikne pri pokuse o otvorenie súboru (v tomto prípade prenesene položky archívu) výnimka (GRobotException; archiveNotOpenForReading alebo archiveNotOpenForWriting).

Hodnota null parametra archív znamená, že prípadný pripojený archív má byť od tohto súboru odpojený a súbor má opäť fungovať samostatne (zapisujúc a čítajúc údaje priamo z pevného disku, prípadne zo zdrojov).

Poznámka: Ak je dôsledkom volania tejto metódy zmena (t. j. je pripojený nový/odlišný archív alebo je jestvujúci archív odpojený), tak metóda automaticky zavrie prípadný otvorený súbor alebo položku archívu.

Pripojenie archívu uľahčuje prácu s textovými (potenciálne konfiguračnými) súbormi uloženými v archíve, má to viacero výhodných dôsledkov, ale sú tu aj určité obmedzenia:
1. Nie je možné otvoriť položku v archíve na pripojenie: ~~otvorNaZápis("názov.txt",true)~~. Toto obmedzenie súvisí s ďalším bodom…
2. Nie je možné vytvoriť duplicitnú položku v archíve – pokus o otvorenie jestvujúcej položky v archíve otvorenom na zápis vrhne výnimku GRobotException s jazykovým identifikátorom duplicateEntry (Položka „názov položky“ už v archíve jestvuje.)
Uvedené obmedzenia súvisia s princípom práce s archívom. Archív otvorený na zápis je vždy prázdny, pripravený prijímať (a baliť) nové položky. Nedá sa otvoriť jestvujúci archív na zápis a v ňom upravovať jestvujúce položky. To by sme museli najprv archív rozbaliť do dočasného priečinka, vykonať želané zmeny a archív opätovne zbaliť. Ak jestvuje v archíve otvorenom na zápis určitá položka, znamená to, že bola v tomto cykle zápisu už zbalená a nedá sa meniť.
Parametre:

archív – inštancia archívu na pripojenie

Pozri tiež:

archívPriradený(), otvorNaZápis(String), otvorNaZápis(String, boolean), otvorNaZápis(String, String, boolean), otvorNaČítanie(String), otvorNaČítanie(String, String), zavri(), close()

pripojArchiv

public void pripojArchiv(Archív archív)

Alias pre pripojArchív.

archívPriradený
```
public boolean archívPriradený()
```
Zistí, či je k tomuto súboru pripojený archív.

Návratová hodnota:

true ak je archív priradený, false v opačnom prípade

Pozri tiež:

pripojArchív(Archív)

archivPriradeny
```
public boolean archivPriradeny()
```
Alias pre archívPriradený.

otvorNaZápis
```
public void otvorNaZápis(String názovSúboru)
                  throws IOException
```
Otvorí zadaný súbor na zápis. Ak súbor jestvuje, bude prepísaný. Metóda použije kódovanie UTF-8.

Poznámka: V prípade, že plánujete používať mechanizmus vlastností, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!

Poznámka: Pozrite si aj informácie uvedené v opise metódy pripojArchív.

Poznámka: Ak bude súbor, ktorý zapisujete čítaný iným softvérom, zvážte uloženie značky BOM (byte order mark) na začiatok súboru. Pozri metódu zapíšBOM, ktorá túto možnosť poskytuje. Niektoré softvéry sa bez prítomnosti tejto značky na začiatku súboru nevedia orientovať (takže v podstate jej prítomnosť vyžadujú).

Parametre:

názovSúboru – názov súboru, ktorý má byť otvorený na zápis

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak je meno súboru zamlčané (null)

Pozri tiež:

otvorNaČítanie(String), otvorNaČítanie(String, String), otvorNaZápis(String, boolean), otvorNaZápis(String, String, boolean), zavri(), close()

otvorNaZapis

public void otvorNaZapis(String názovSúboru)
                  throws IOException

Alias pre otvorNaZápis.

Výnimky:: IOException

otvorNaZápis
```
public void otvorNaZápis(String názovSúboru,
                         boolean pripojiť)
                  throws IOException
```
Otvorí zadaný súbor na zápis. Ak je druhý parameter true, zapisovaný obsah bude pripojený k obsahu jestvujúceho súboru, inak bude obsah súboru prepísaný. Metóda použije kódovanie UTF-8.

Poznámka: Pozrite si aj informácie uvedené v opise metódy pripojArchív.

Upozornenie: V prípade, že plánujete používať mechanizmus vlastností, nepoužívajte túto metódu so zadanou hodnotou true druhého argumentu!

Pozor! Pripájanie (pozri parameter pripojiť) nesmie byť použité s konfiguračnými súbormi, pretože tieto by sa stali pri ďalšom otvorení nečitateľné!

Poznámka: Ak bude súbor, ktorý zapisujete čítaný iným softvérom, zvážte uloženie značky BOM (byte order mark) na začiatok súboru. Pozri metódu zapíšBOM, ktorá túto možnosť poskytuje. Niektoré softvéry sa bez prítomnosti tejto značky na začiatku súboru nevedia orientovať (takže v podstate jej prítomnosť vyžadujú).

Parametre:

názovSúboru – názov súboru, ktorý má byť otvorený na zápis

pripojiť – ak je hodnota tohto parametra true, zapisovaný obsah bude pripojený na koniec jestvujúceho súboru (nesmie byť použité s konfiguračnými súbormi‼)

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak je meno súboru zamlčané (null)

Pozri tiež:

otvorNaČítanie(String), otvorNaČítanie(String, String), otvorNaZápis(String), otvorNaZápis(String, boolean), otvorNaZápis(String, String, boolean), zavri(), close()

otvorNaZapis

public void otvorNaZapis(String názovSúboru,
                         boolean pripojiť)
                  throws IOException

Alias pre otvorNaZápis.

Výnimky:: IOException

otvorNaZápis
```
public void otvorNaZápis(String názovSúboru,
                         String kódovanie,
                         boolean pripojiť)
                  throws IOException
```
Otvorí zadaný súbor na zápis. Ak je druhý parameter true, zapisovaný obsah bude pripojený k obsahu jestvujúceho súboru, inak bude obsah súboru prepísaný.

Poznámka: Pozrite si aj informácie uvedené v opise metódy pripojArchív.

Upozornenie: V prípade, že plánujete používať mechanizmus vlastností, nepoužívajte túto metódu so zadanou hodnotou true druhého argumentu!

Pozor! Pripájanie (pozri parameter pripojiť) nesmie byť použité s konfiguračnými súbormi, pretože tieto by sa stali pri ďalšom otvorení nečitateľné!

Poznámka: Ak bude súbor, ktorý zapisujete čítaný iným softvérom, zvážte uloženie značky BOM (byte order mark) na začiatok súboru. Pozri metódu zapíšBOM, ktorá túto možnosť poskytuje. Niektoré softvéry sa bez prítomnosti tejto značky na začiatku súboru nevedia orientovať (takže v podstate jej prítomnosť vyžadujú).

Parametre:

názovSúboru – názov súboru, ktorý má byť otvorený na zápis

kódovanie – typ kódovania, ktorý má byť použitý na uloženie textového súboru

pripojiť – ak je hodnota tohto parametra true, zapisovaný obsah bude pripojený na koniec jestvujúceho súboru (nesmie byť použité s konfiguračnými súbormi‼)

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak je meno súboru zamlčané (null)

Pozri tiež:

otvorNaČítanie(String), otvorNaČítanie(String, String), otvorNaZápis(String), otvorNaZápis(String, boolean), otvorNaZápis(String, String, boolean), zavri(), close()

otvorNaZapis

public void otvorNaZapis(String názovSúboru,
                         String kódovanie,
                         boolean pripojiť)
                  throws IOException

Alias pre otvorNaZápis.

Výnimky:: IOException

otvorNaČítanie
```
public void otvorNaČítanie(String názovSúboru)
                    throws IOException
```
Otvorí zadaný súbor s kódovaním UTF-8 na čítanie. Ak súbor nejestvuje, vznikne výnimka. Ďalšie informácie sú v opise verzie tejto metódy prijímajúcej dva parametre: otvorNaČítanie.

Parametre:

názovSúboru – názov súboru, ktorý má byť otvorený na čítanie

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak je meno súboru zamlčané (null) alebo súbor nejestvuje

Pozri tiež:

otvorNaZápis(String), otvorNaZápis(String, boolean), otvorNaZápis(String, String, boolean), otvorNaČítanie(String, String), zavri(), close()

otvorNaCitanie

public void otvorNaCitanie(String názovSúboru)
                    throws IOException

Alias pre otvorNaČítanie.

Výnimky:: IOException

otvorNaČítanie
```
public void otvorNaČítanie(String názovSúboru,
                           String kódovanie)
                    throws IOException
```
Otvorí zadaný súbor na čítanie. Ak súbor nejestvuje, vznikne výnimka.

Poznámky a upozornenia: Ak bol z projektu vytvorený .jar súbor (spustiteľný balíček), tak sa v prípade spustenia projektu cez tento súbor pokúsi metóda hľadať požadovaný súbor aj v .jar balíčku. Prednosť však majú súbory umiestnené mimo balíčka. So súbormi na zápis to neplatí – tie nie je možné zapisovať do .jar balíčkov.

V súčasnej verzii rámca metóda hľadá súbory na čítanie aj v rámci zoznamu ciest classpath. To znamená, že súbor, ktorý ste prvý raz prečítali, nemusí byť tým istým súborom ako ten, do ktorého budete zapisovať. Na overenie prítomnosti súboru v aktuálnom umiestnení na zápis môžete použiť metódu jestvuje a na zistenie umiestnenia súboru na čítanie môžete použiť metódu kdeJeSúbor.

Parametre:

názovSúboru – názov súboru, ktorý má byť otvorený na čítanie

kódovanie – typ kódovania textového súboru

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak je meno súboru zamlčané (null) alebo súbor nejestvuje

Pozri tiež:

otvorNaZápis(String), otvorNaZápis(String, boolean), otvorNaZápis(String, String, boolean), otvorNaČítanie(String), zavri(), close()

otvorNaCitanie

public void otvorNaCitanie(String názovSúboru,
                           String kódovanie)
                    throws IOException

Alias pre otvorNaČítanie.

Výnimky:: IOException

zavri
```
public void zavri()
           throws IOException
```
Zavrie súbor, ktorý bol predtým otvorený na čítanie alebo zápis.

Poznámka: Pozrite si aj informácie uvedené v opise metódy pripojArchív.

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

Pozri tiež:

otvorNaZápis(String), otvorNaZápis(String, boolean), otvorNaZápis(String, String, boolean), otvorNaČítanie(String), otvorNaČítanie(String, String), close()

close
```
public void close()
           throws IOException
```
Zavrie súbor, ktorý bol predtým otvorený na čítanie alebo zápis. Táto metóda je definovaná ako súčasť implementácie rozhrania Closeable. Vnútorne volá metódu zavri.

Definované:

close v rozhraní Closeable

Definované:

close v rozhraní AutoCloseable

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

Pozri tiež:

otvorNaZápis(String), otvorNaZápis(String, boolean), otvorNaZápis(String, String, boolean), otvorNaČítanie(String), otvorNaČítanie(String, String), zavri()

vlastnosťJestvuje
```
public boolean vlastnosťJestvuje(String názov)
                          throws IOException
```
Zistí, či je v súbore otvorenom na čítanie (vlastností) definovaná zadaná vlastnosť. Táto metóda slúži na rozlíšenie špeciálnych prípadov pri čítaní konfigurácie. Každá metóda slúžiaca na čítanie vlastností musí mať určenú predvolenú hodnotu, ktorá je použitá v prípade, že vlastnosť v súbore nejestvuje, avšak niekedy môže nedefinovaná vlastnosť určovať špeciálny prípad konfigurácie, ktorý je potrebné rozlíšiť.

Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!

Parametre:

názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku, hranatú zátvorku alebo rovná sa)

Návratová hodnota:

true alebo false podľa toho, či je vlastnosť súbore definovaná alebo nie

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak názov vlastnosti nespĺňa niektorú požiadavku alebo súbor nie je otvorený na čítanie, prípadne súbor obsahuje chybu

vlastnostJestvuje

public boolean vlastnostJestvuje(String názov)
                          throws IOException

Alias pre vlastnosťJestvuje.

Výnimky:: IOException

vlastnosťExistuje

public boolean vlastnosťExistuje(String názov)
                          throws IOException

Alias pre vlastnosťJestvuje.

Výnimky:: IOException

vlastnostExistuje

public boolean vlastnostExistuje(String názov)
                          throws IOException

Alias pre vlastnosťJestvuje.

Výnimky:: IOException

čítajVlastnosť
```
public String čítajVlastnosť(String názov,
                             String predvolenáHodnota)
                      throws IOException
```
Číta hodnotu vlastnosti v tvare reťazca.

Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!

Parametre:

názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku, hranatú zátvorku alebo rovná sa)

predvolenáHodnota – predvolená hodnota vlastnosti, ktorá je vrátená v prípade, že vlastnosť s uvedeným názvom nebola v textovom súbore nájdená

Návratová hodnota:

hodnota vlastnosti v objekte typu String

Výnimky:

IOException – ak vznikla chyba vo vstupno-výstupnej operácii

GRobotException – ak názov vlastnosti nespĺňa niektorú požiadavku alebo súbor nie je otvorený na čítanie, prípadne súbor obsahuje chybu

citajVlastnost

public String citajVlastnost(String názov,
                             String predvolenáHodnota)
                      throws IOException

index	význam
`0`	zdrojový reťazec – používaný v rámci programovacieho rámca
`1`	cieľový reťazec – zapisovaný do súboru
`2`	spôsob vyhľadávania – `"Z"` – výskyt na začiatku reťazca, `"K"` – výskyt na konci reťazca, `"S"` – výskyt v ľubovoľnej časti reťazca, `"P"` – presná zhoda reťazca; pri inej hodnote je záznam ignorovaný

Trieda Súbor

Prehľad konštruktorov

Prehľad metód

Metódy zdedené z triedy java.lang.Object

Podrobnosti konštruktorov

Súbor

Podrobnosti metód

aktívnaSekcia

aktivnaSekcia

aktivujSekciu

vymažSekciu

vymazSekciu

premenujSekciu

zoznamSekcií

zoznamSekcii

zoznamSúborov

zoznamSuborov

zoznamPriečinkov

zoznamPriecinkov

zoznamSúborovAPriečinkov

zoznamSuborovAPriecinkov

zoznam

existuje

jestvuje

vytvorPriečinok

vytvorPriecinok

novýPriečinok

novyPriecinok

vytvorPriečinok

vytvorPriecinok

novýPriečinok

novyPriecinok

jeSúbor

jeSubor

jePriečinok

jePriecinok

porovnaj

kopíruj

kopiruj

kopíruj

kopiruj

pripoj

premenuj

presuň

presun

vymaž

vymaz

dátumNaReťazec

datumNaRetazec

dátumNaReťazec

datumNaRetazec

reťazecNaDátum

retazecNaDatum

reťazecNaDátum

retazecNaDatum

naposledyUpravený

naposledyUpraveny

naposledyUpravený

naposledyUpraveny

veľkosť

velkost

kontrolnýSúčet

kontrolnySucet

súčtySúZhodné

suctySuZhodne

mennýPriestorVlastností

mennyPriestorVlastnosti

mennýPriestorVlastností

mennyPriestorVlastnosti

vnorMennýPriestorVlastností

vnorMennyPriestorVlastnosti

vnorMennýPriestorVlastností

vnorMennyPriestorVlastnosti

vynorMennýPriestorVlastností

vynorMennyPriestorVlastnosti

predvolenáCestaDialógov

predvolenaCestaDialogov

predvolenáCestaDialógov

predvolenaCestaDialogov

dialógOtvoriť