GRobot.Súbor

java.lang.Object
- GRobot.Súbor

Známe priame odvodené triedy:: GRobot.Subor

Nadradená trieda:: GRobot

public static class GRobot.Súbor
extends Object

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:

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.*;
// alternatívne je možné použiť namiesto IOException všeobecný typ Exception
{
	// 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);
}

// 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ť riadky:

Toto
Je
Pokusný
Zápis
Do
Súboru

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 escape sekvencií vo svojich hodnotách. Na lepšie pochopenie práce s vlastnosťami poslúži nasledujúci príklad:

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…)
	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.*;
// alternatívne je možné použiť namiesto IOException všeobecný typ Exception,
// ale potom treba vymazať blok catch (IllegalArgumentException…
{
	// 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);
}
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

(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

All Metódy Static Metódy Instance Metódy Concrete Metódy
Modifikátor a typ	Metóda a opis
`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`.
`Boolean`	`citajVlastnost(String názov, Boolean predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`boolean[]`	`citajVlastnost(String názov, boolean[] 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ť`.
`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ť`.
`Long`	`citajVlastnost(String názov, Long predvolenáHodnota)` Alias pre `čítajVlastnosť`.
`long[]`	`citajVlastnost(String názov, long[] 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ť`.
`void`	`čí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 načí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`.
`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`.
`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`.
`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`.
`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`.
`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`.
`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 a 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`	`dialógUložiť(String titulok)` Otvorí používateľský dialóg na uloženie súboru a vráti reťazec s úplnou cestou a názvom súboru zvoleného v dialógu používateľom.
`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.
`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.
`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í.
`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 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`	`otvorNaČítanie(String názovSúboru)` 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.
`static boolean`	`porovnaj(String názov1, String názov2)` Porovná obsah dvoch súborov.
`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).
`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.
`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ť.
`static boolean`	`vymaz(String názov)` Alias pre `vymaž`.
`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žVlastnosť(String názov)` Odstráni zo súboru záznam o vlastnosti so zadaným menom.
`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`	`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`	`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íš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íš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 zápis alebo čítanie.
`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.
`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.

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
  - zoznamSúborov
```
public static String[] zoznamSúborov(String cesta)
							throws FileNotFoundException,
									IllegalArgumentException
```
    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:
    
    FileNotFoundException – ak cesta nebola nájdená
    
    IllegalArgumentException – ak je zadaná cesta neplatná
  - zoznamSuborov
```
public static String[] zoznamSuborov(String cesta)
							throws FileNotFoundException,
									IllegalArgumentException
```
    Alias pre zoznamSúborov.
    
    Výnimky:
    
    FileNotFoundException
    
    IllegalArgumentException
  - zoznamPriečinkov
```
public static String[] zoznamPriečinkov(String cesta)
								throws FileNotFoundException,
										IllegalArgumentException
```
    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:
    
    FileNotFoundException – ak cesta nebola nájdená
    
    IllegalArgumentException – ak je zadaná cesta neplatná
  - zoznamPriecinkov
```
public static String[] zoznamPriecinkov(String cesta)
								throws FileNotFoundException,
										IllegalArgumentException
```
    Alias pre zoznamPriečinkov.
    
    Výnimky:
    
    FileNotFoundException
    
    IllegalArgumentException
  - zoznamSúborovAPriečinkov
```
public static String[] zoznamSúborovAPriečinkov(String cesta)
										throws FileNotFoundException,
												IllegalArgumentException
```
    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:
    
    FileNotFoundException – ak cesta nebola nájdená
    
    IllegalArgumentException – ak je zadaná cesta neplatná
  - zoznamSuborovAPriecinkov
```
public static String[] zoznamSuborovAPriecinkov(String cesta)
										throws FileNotFoundException,
												IllegalArgumentException
```
    Alias pre zoznamSúborovAPriečinkov.
    
    Výnimky:
    
    FileNotFoundException
    
    IllegalArgumentException
  - zoznam
```
public static String[] zoznam(String cesta)
						throws FileNotFoundException,
							IllegalArgumentException
```
    Vytvorí zoznam všetkých položiek umiestnených na zadanej ceste. Je možné, že zoznam bude zhodný so zoznamom vytvoreným pomocou metódy zoznamSúborovAPriečinkov.
    
    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:
    
    FileNotFoundException – ak cesta nebola nájdená
    
    IllegalArgumentException – ak je zadaná cesta neplatná
  - existuje
```
public static boolean existuje(String názov)
```
    Overí, či súbor alebo priečinok so zadaným názvom jestvuje.
    
    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.
    
    Parametre:
    
    názov – názov súboru alebo priečinka
    
    Návratová hodnota:
    
    true – áno; false – nie
  - 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ú.
    (Pozri zoznam zmien.)
    
    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 FileNotFoundException,
								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.
    (Pozri zoznam zmien.)
    
    Parametre:
    
    zdroj – názov (a cesta) zdrojového súboru
    
    cieľ – názov (a cesta) cieľového súboru
    
    Návratová hodnota:
    
    true v prípade, že sú súbory zhodné, inak false
    
    Výnimky:
    
    FileNotFoundException
    
    IOException
  - kopíruj
```
public static void kopíruj(String zdroj,
							String cieľ,
							boolean prepísať)
					throws FileNotFoundException,
							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());
}
```
    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:
    
    FileNotFoundException
    
    IOException
  - kopiruj
```
public static void kopiruj(String zdroj,
							String cieľ,
							boolean prepísať)
					throws FileNotFoundException,
							IOException
```
    Alias pre kopíruj.
    
    Výnimky:
    
    FileNotFoundException
    
    IOException
  - kopíruj
```
public static void kopíruj(String zdroj,
							String cieľ)
					throws FileNotFoundException,
							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:
    
    FileNotFoundException
    
    IOException
  - kopiruj
```
public static void kopiruj(String zdroj,
							String cieľ)
					throws FileNotFoundException,
							IOException
```
    Alias pre kopíruj.
    
    Výnimky:
    
    FileNotFoundException
    
    IOException
  - pripoj
```
public static void pripoj(String zdroj,
						String cieľ)
					throws FileNotFoundException,
						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)…
    (Pozri zoznam zmien.)
    
    Parametre:
    
    zdroj – názov (a cesta) zdrojového súboru
    
    cieľ – názov (a cesta) cieľového súboru
    
    Výnimky:
    
    FileNotFoundException
    
    IOException
  - 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ž.
  - naposledyUpravený
```
public static long naposledyUpravený(String názov)
```
    Zistí dátum a čas poslednej úpravy zadaného súboru alebo priečinka.
    
    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 1. januára 1970, 00:00:00; ak súbor nejestvuje, návratová hodnota je 0
  - naposledyUpraveny
```
public long naposledyUpraveny(String názov)
```
    Alias pre naposledyUpravený.
  - mennýPriestorVlastností
```
public String mennýPriestorVlastností()
```
    Zistí aktuálne používaný menný priestor. 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.
    (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
  - mennyPriestorVlastnosti
```
public void mennyPriestorVlastnosti(String novýMennýPriestor)
```
    Alias pre mennýPriestorVlastností.
  - dialógOtvoriť
```
public static String dialógOtvoriť(String titulok)
```
    Otvorí používateľský dialóg na otvorenie súboru a 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.
    
    Návratová hodnota:
    
    úplná cesta a názov súboru alebo null
  - dialogOtvorit
```
public static String dialogOtvorit(String titulok)
```
    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 a 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.
    
    Návratová hodnota:
    
    úplná cesta a názov súboru alebo null
  - dialogUlozit
```
public static String dialogUlozit(String titulok)
```
    Alias pre dialógUložiť.
  - otvorNaZápis
```
public void otvorNaZápis(String názovSúboru)
				throws IOException,
						NullPointerException
```
    Otvorí zadaný súbor na zápis. Ak súbor jestvuje, bude prepísaný.
    (Poznámka: V prípade, že plánujete používať mechanizmus vlastností, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!)
    
    Parametre:
    
    názovSúboru – názov súboru, ktorý má byť otvorený na zápis
    
    Výnimky:
    
    IOException
    
    NullPointerException
  - otvorNaZapis
```
public void otvorNaZapis(String názovSúboru)
				throws IOException,
						NullPointerException
```
    Alias pre otvorNaZápis.
    
    Výnimky:
    
    IOException
    
    NullPointerException
  - otvorNaZápis
```
public void otvorNaZápis(String názovSúboru,
						boolean pripojiť)
				throws IOException,
						NullPointerException
```
    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ý.
    (Upozornenie: V prípade, že plánujete používať mechanizmus vlastností, nepoužívajte túto metódu so zadanou hodnotou true do druhého argumentu!)
    
    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
    
    Výnimky:
    
    IOException
    
    NullPointerException
  - otvorNaZapis
```
public void otvorNaZapis(String názovSúboru,
						boolean pripojiť)
				throws IOException,
						NullPointerException
```
    Alias pre otvorNaZápis.
    
    Výnimky:
    
    IOException
    
    NullPointerException
  - otvorNaČítanie
```
public void otvorNaČítanie(String názovSúboru)
					throws IOException,
							NullPointerException
```
    Otvorí zadaný súbor na čítanie. Ak súbor nejestvuje, vznikne výnimka.
    (Poznámka: 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…)
    
    Parametre:
    
    názovSúboru – názov súboru, ktorý má byť otvorený na čítanie
    
    Výnimky:
    
    IOException
    
    NullPointerException
  - otvorNaCitanie
```
public void otvorNaCitanie(String názovSúboru)
					throws IOException,
							NullPointerException
```
    Alias pre otvorNaČítanie.
    
    Výnimky:
    
    IOException
    
    NullPointerException
  - zavri
```
public void zavri()
			throws IOException
```
    Zavrie súbor, ktorý bol predtým otvorený na zápis alebo čítanie.
    
    Výnimky:
    
    IOException
  - vlastnosťJestvuje
```
public boolean vlastnosťJestvuje(String názov)
						throws IOException,
								IllegalArgumentException
```
    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ť!)
    (Pozri zoznam zmien.)
    
    Parametre:
    
    názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku alebo rovná sa)
    
    Návratová hodnota:
    
    true alebo false podľa toho, či je vlastnosť súbore definovaná alebo nie
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - vlastnostJestvuje
```
public boolean vlastnostJestvuje(String názov)
						throws IOException,
								IllegalArgumentException
```
    Alias pre vlastnosťJestvuje.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - vlastnosťExistuje
```
public boolean vlastnosťExistuje(String názov)
						throws IOException,
								IllegalArgumentException
```
    Alias pre vlastnosťJestvuje.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - vlastnostExistuje
```
public boolean vlastnostExistuje(String názov)
						throws IOException,
								IllegalArgumentException
```
    Alias pre vlastnosťJestvuje.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public String čítajVlastnosť(String názov,
							String predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Číta hodnotu vlastnosti v tvare reťazca.
    (Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!)
    (Pozri zoznam zmien.)
    
    Parametre:
    
    názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku 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
    
    IllegalArgumentException
  - citajVlastnost
```
public String citajVlastnost(String názov,
							String predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public StringBuffer čítajVlastnosť(String názov,
									StringBuffer predvolenáHodnota)
							throws IOException,
									IllegalArgumentException
```
    Číta hodnotu vlastnosti v tvare reťazca, pričom výsledok je vrátený v objekte typu StringBuffer.
    (Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!)
    (Pozri zoznam zmien.)
    
    Parametre:
    
    názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku 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 StringBuffer
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public StringBuffer citajVlastnost(String názov,
									StringBuffer predvolenáHodnota)
							throws IOException,
									IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public Long čítajVlastnosť(String názov,
							Long predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Číta hodnotu vlastnosti v tvare celého čísla.
    (Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!)
    (Pozri zoznam zmien.)
    
    Parametre:
    
    názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku 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á alebo došlo pri prevode textu na celé číslo ku chybe
    
    Návratová hodnota:
    
    hodnota vlastnosti v objekte typu Long
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public Long citajVlastnost(String názov,
							Long predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public Double čítajVlastnosť(String názov,
							Double predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Číta hodnotu vlastnosti v tvare reálneho čísla.
    (Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!)
    (Pozri zoznam zmien.)
    
    Parametre:
    
    názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku 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á alebo došlo pri prevode textu na reálne číslo ku chybe
    
    Návratová hodnota:
    
    hodnota vlastnosti v objekte typu Double
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public Double citajVlastnost(String názov,
							Double predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public Boolean čítajVlastnosť(String názov,
							Boolean predvolenáHodnota)
						throws IOException,
							IllegalArgumentException
```
    Číta hodnotu vlastnosti v tvare logickej hodnoty true / false.
    (Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!)
    (Pozri zoznam zmien.)
    
    Parametre:
    
    názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku 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 Boolean
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public Boolean citajVlastnost(String názov,
							Boolean predvolenáHodnota)
						throws IOException,
							IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public int[] čítajVlastnosť(String názov,
							int[] predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Číta hodnotu vlastnosti do celočíselného poľa typu int.
    (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 alebo rovná sa)
    
    predvolenáHodnota – pole, ktoré je použité na vytvorenie „predvolenej hodnoty“, čo je v tomto prípade nové pole, ktoré je kópiou tohto argumentu – čiže pole s rovnakou dĺžkou a rovnakými hodnotami jednotlivých prvkov; toto pole je vytvorené a vrátené v prípade, že vlastnosť s uvedeným názvom nebola v textovom súbore nájdená alebo je hodnota vlastnosti prázdna
    
    Návratová hodnota:
    
    nové pole prvkov typu int, ktoré obsahuje toľko prvkov, koľko celých čísiel sa z hodnoty vlastnosti podarilo úspešne previesť (proces prevodu textov na celé čísla sa zastavuje pri prvom neúspechu) alebo kópia poľa zadaného do predvolenej hodnoty
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public int[] citajVlastnost(String názov,
							int[] predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public float[] čítajVlastnosť(String názov,
							float[] predvolenáHodnota)
						throws IOException,
							IllegalArgumentException
```
    Číta hodnotu vlastnosti do poľa reálnych čísel typu float.
    (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 alebo rovná sa)
    
    predvolenáHodnota – pole, ktoré je použité na vytvorenie „predvolenej hodnoty“, čo je v tomto prípade nové pole, ktoré je kópiou tohto argumentu – čiže pole s rovnakou dĺžkou a rovnakými hodnotami jednotlivých prvkov; toto pole je vytvorené a vrátené v prípade, že vlastnosť s uvedeným názvom nebola v textovom súbore nájdená alebo je hodnota vlastnosti prázdna
    
    Návratová hodnota:
    
    nové pole prvkov typu float, ktoré obsahuje toľko prvkov, koľko reálnych čísiel sa z hodnoty vlastnosti podarilo úspešne previesť (proces prevodu textov na reálne čísla sa zastavuje pri prvom neúspechu) alebo kópia poľa zadaného do predvolenej hodnoty
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public float[] citajVlastnost(String názov,
							float[] predvolenáHodnota)
						throws IOException,
							IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public long[] čítajVlastnosť(String názov,
							long[] predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Číta hodnotu vlastnosti do celočíselného poľa typu long.
    (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 alebo rovná sa)
    
    predvolenáHodnota – pole, ktoré je použité na vytvorenie „predvolenej hodnoty“, čo je v tomto prípade nové pole, ktoré je kópiou tohto argumentu – čiže pole s rovnakou dĺžkou a rovnakými hodnotami jednotlivých prvkov; toto pole je vytvorené a vrátené v prípade, že vlastnosť s uvedeným názvom nebola v textovom súbore nájdená alebo je hodnota vlastnosti prázdna
    
    Návratová hodnota:
    
    nové pole prvkov typu long, ktoré obsahuje toľko prvkov, koľko celých čísiel sa z hodnoty vlastnosti podarilo úspešne previesť (proces prevodu textov na celé čísla sa zastavuje pri prvom neúspechu) alebo kópia poľa zadaného do predvolenej hodnoty
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public long[] citajVlastnost(String názov,
							long[] predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public double[] čítajVlastnosť(String názov,
								double[] predvolenáHodnota)
						throws IOException,
								IllegalArgumentException
```
    Číta hodnotu vlastnosti do poľa reálnych čísel typu double.
    (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 alebo rovná sa)
    
    predvolenáHodnota – pole, ktoré je použité na vytvorenie „predvolenej hodnoty“, čo je v tomto prípade nové pole, ktoré je kópiou tohto argumentu – čiže pole s rovnakou dĺžkou a rovnakými hodnotami jednotlivých prvkov; toto pole je vytvorené a vrátené v prípade, že vlastnosť s uvedeným názvom nebola v textovom súbore nájdená alebo je hodnota vlastnosti prázdna
    
    Návratová hodnota:
    
    nové pole prvkov typu double, ktoré obsahuje toľko prvkov, koľko reálnych čísiel sa z hodnoty vlastnosti podarilo úspešne previesť (proces prevodu textov na reálne čísla sa zastavuje pri prvom neúspechu) alebo kópia poľa zadaného do predvolenej hodnoty
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public double[] citajVlastnost(String názov,
								double[] predvolenáHodnota)
						throws IOException,
								IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public boolean[] čítajVlastnosť(String názov,
								boolean[] predvolenáHodnota)
						throws IOException,
								IllegalArgumentException
```
    Číta hodnotu vlastnosti do poľa logických hodnôt typu boolean.
    (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 alebo rovná sa)
    
    predvolenáHodnota – pole, ktoré je použité na vytvorenie „predvolenej hodnoty“, čo je v tomto prípade nové pole, ktoré je kópiou tohto argumentu – čiže pole s rovnakou dĺžkou a rovnakými hodnotami jednotlivých prvkov; toto pole je vytvorené a vrátené v prípade, že vlastnosť s uvedeným názvom nebola v textovom súbore nájdená alebo je hodnota vlastnosti prázdna
    
    Návratová hodnota:
    
    nové pole prvkov typu boolean, ktoré obsahuje toľko prvkov, koľko logických hodnôt sa podarilo z vlastnosti úspešne načítať alebo kópia poľa zadaného do predvolenej hodnoty
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public boolean[] citajVlastnost(String názov,
								boolean[] predvolenáHodnota)
						throws IOException,
								IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - čítajVlastnosť
```
public char[] čítajVlastnosť(String názov,
							char[] predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Číta hodnotu vlastnosti do poľa znakov (char[]). Metóda vracia nové pole znakov, ktorého prvky tvoria všetky znaky získané z hodnoty tejto vlastnosti.
    (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 alebo rovná sa)
    
    predvolenáHodnota – pole, ktoré je použité na vytvorenie „predvolenej hodnoty“, čo je v tomto prípade nové pole znakov, ktoré je kópiou tohto argumentu; toto pole je vytvorené a vrátené v prípade, že vlastnosť s uvedeným názvom nebola v textovom súbore nájdená
    
    Návratová hodnota:
    
    nové pole znakov (char[]), ktoré tvoria hodnotu tejto vlastnosti, prípadne kópia poľa zadaného do predvolenej hodnoty (ak vlastnosť v otvorenom súbore nejestvuje)
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citajVlastnost
```
public char[] citajVlastnost(String názov,
							char[] predvolenáHodnota)
					throws IOException,
							IllegalArgumentException
```
    Alias pre čítajVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - zachovávaNepoužitéVlastnosti
```
public boolean zachovávaNepoužitéVlastnosti()
```
    Zistí v akom režime sa nachádza táto inštancia triedy Súbor.
    
    Návratová hodnota:
    
    true – inštancia pri zápise zachováva nepoužité vlastnosti; false – inštancia odstraňuje nepoužité vlastnosti
    (Pozri zoznam zmien.)
    
    Pozri tiež:
    
    zachovajNepoužitéVlastnosti(), odstraňujNepoužitéVlastnosti(), vymažVlastnosť(String), zapíšVlastnosť(String, Object)
  - zachovavaNepouziteVlastnosti
```
public boolean zachovavaNepouziteVlastnosti()
```
    Alias pre zachovávaNepoužitéVlastnosti.
  - zachovajNepoužitéVlastnosti
```
public void zachovajNepoužitéVlastnosti()
```
    Prepne inštanciu do režimu zachovávania nepoužitých vlastností. V súbore zostanú po zápise zachované aj tie vlastnosti, ktoré z neho boli pôvodne prečítané, ale nedošlo k ich opätovnému zapísaniu. Toto je predvolené správanie triedy Súbor.
    (Pozri zoznam zmien.)
    
    Pozri tiež:
    
    zachovávaNepoužitéVlastnosti(), odstraňujNepoužitéVlastnosti(), vymažVlastnosť(String), zapíšVlastnosť(String, Object)
  - zachovajNepouziteVlastnosti
```
public void zachovajNepouziteVlastnosti()
```
    Alias pre zachovajNepoužitéVlastnosti.
  - odstraňujNepoužitéVlastnosti
```
public void odstraňujNepoužitéVlastnosti()
```
    Prepne inštanciu do režimu odstraňovania nepoužitých vlastností. Do súboru budú zapísané len tie vlastnosti, ktoré programátor prikázal zapísať. Zapisované vlastnosti, prázdne riadky a komentáre sa v súbore nemusia vyskytnúť v rovnakom poradí ako boli zapísané. Poradie zápisu vychádza z pôvodného poradia vlastností v čase čítania súboru. (Ak by to niekomu z ľubovoľného dôvodu prekážalo, nech pred zápisom otvorí a zavrie súbor na čítanie – v metóde otvorNaČítanie dochádza k vyčisteniu vnútornej pamäte vlastností. V takom prípade by v skutočnosti nebolo nevyhnutné použiť túto metódu (odstraňujNepoužitéVlastnosti), ktorej účelom je iba zariadiť to, aby sa do súboru zapísali len relevantné riadky v ľubovoľnom poradí.)
    (Odstraňovanie sa dotýka aj komentárov a prázdnych riadkov. Avšak, ak by bola rovnaká inštancia triedy Súbor použitá na zápis vlastností do viacerých súborov, zapisované vlastnosti by sa mohli premiešať, preto radšej nepoužívajte jednu inštanciu na zápis do viacerých súborov – pozri tiež poznámku pri metóde zapíšVlastnosť.)
    (Pozri zoznam zmien.)
    
    Pozri tiež:
    
    zachovávaNepoužitéVlastnosti(), zachovajNepoužitéVlastnosti(), vymažVlastnosť(String), zapíšVlastnosť(String, Object)
  - odstranujNepouziteVlastnosti
```
public void odstranujNepouziteVlastnosti()
```
    Alias pre odstraňujNepoužitéVlastnosti.
  - vymažVlastnosť
```
public void vymažVlastnosť(String názov)
					throws IOException,
							IllegalArgumentException
```
    Odstráni zo súboru záznam o vlastnosti so zadaným menom. Použitie tejto metódy môže byť zbytočné v prípade, že je zapnuté odstraňovanie nepoužitých vlastností. Naopak, v prípade, že je odstraňovanie nepoužitých vlastností vypnuté, môžu byť prostredníctvom tejto metódy odstránené individuálne nepotrebné záznamy.
    
    Parametre:
    
    názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku alebo rovná sa)
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
    
    Pozri tiež:
    
    zapíšVlastnosť(String, Object), zachovávaNepoužitéVlastnosti(), zachovajNepoužitéVlastnosti(), odstraňujNepoužitéVlastnosti()
  - vymazVlastnost
```
public void vymazVlastnost(String názov)
					throws IOException,
							IllegalArgumentException
```
    Alias pre vymažVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - zapíšVlastnosť
```
public void zapíšVlastnosť(String názov,
							Object hodnota)
					throws IOException,
							IllegalArgumentException
```
    Zapíše vlastnosť podporovaného údajového typu. Ak zavoláme túto metódu opakovane s rovnakým názvom vlastnosti, tak nastane prepísanie hodnoty tej istej vlastnosti. (V prípade kolízií odporúčame použiť menný priestor.)
    Dôležité upozornenie na prípadnú kolíziu pri práci so súbormi obsahujúcimi vlastnosti!
    Najskôr niekoľko faktov. Prostredie grafického robota umožňuje otvoriť viacero súborov naraz. (Za prvé každý robot smie pracovať s vlastným súborom, za druhé programátor smie vytvárať vlastné inštancie typu Súbor.) Metóda otvorNaZápis okamžite po svojom úspešnom vykonaní kompletne vymaže celý obsah otváraného súboru bez ohľadu na to, čo obsahoval. Ak bol súbor otvorený na čítanie a použijeme ľubovoľnú z metód slúžiacich na čítanie vlastností, okamžite sa do inštancie súboru načíta a spracuje celý obsah súboru predpokladajúc, že obsahuje údaje o vlastnostiach. Spracované údaje zostávajú v pamäti (v inštancii súboru) aj po zavretí súboru a sú opätovne použité pri zápise vlastností… Kolíziám a premiešavaniu obsahu rôznych súborov spracúvaných jednou inštanciou by sa za určitých okolností dalo zabrániť včasným zapnutím režimu nepoužitých vlastností (ktorý sa dotýka aj komentárov a prázdnych riadkov). Kolíziám spôsobeným spracovaním jedného súboru rôznymi inštanciami triedy Súbor sa zabrániť nedá.
    Aby ste sa vyhli prípadným problémom, používajte vždy na prácu s jedným súborom vlastností tú istú inštanciu triedy Súbor (buď inštanciu súboru v niektorom z robotov, alebo vlastnú vytvorenú inštanciu).
    
    Parametre:
    
    názov – názov vlastnosti; nesmie byť prázdny ani obsahovať nepovolené znaky (bodku alebo rovná sa)
    
    hodnota – hodnota vlastnosti podporovaných údajových typov, čo sú jednorozmerné polia primitívnych údajových typov a všetky objekty vyjadriteľné v textovej podobe
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
    
    Pozri tiež:
    
    vymažVlastnosť(String), zapíšKomentárVlastností(String), zapíšPrázdnyRiadokVlastností(), zachovávaNepoužitéVlastnosti(), zachovajNepoužitéVlastnosti(), odstraňujNepoužitéVlastnosti()
  - zapisVlastnost
```
public void zapisVlastnost(String názov,
							Object hodnota)
					throws IOException,
							IllegalArgumentException
```
    Alias pre zapíšVlastnosť.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - zapíšKomentárVlastností
```
public void zapíšKomentárVlastností(String komentár)
```
    Dovoľuje vkladať do textových súborov vlastností jednoriadkové komentáre. Ak s textovým súborom nebolo manipulované zvonka aplikácie a nebolo v ňom zmenené poradie zapísaných vlastností, nemali by sa v ňom vyskytnúť nežiaduce kópie komentárov.
    (Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!)
    
    Parametre:
    
    komentár – text komentára
    
    Pozri tiež:
    
    zapíšVlastnosť(String, Object), zapíšPrázdnyRiadokVlastností()
  - zapisKomentarVlastnosti
```
public void zapisKomentarVlastnosti(String komentár)
```
    Alias pre zapíšKomentárVlastností.
  - zapíšPrázdnyRiadokVlastností
```
public void zapíšPrázdnyRiadokVlastností()
```
    Dovoľuje vkladať do textových súborov vlastností prázdne riadky slúžiace ako oddeľovače. Ak s textovým súborom nebolo manipulované zvonka aplikácie a nebolo v ňom zmenené poradie zapísaných vlastností, nemali by sa v ňom vyskytnúť nežiaduce kópie prázdnych riadkov.
    (Poznámka: Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!)
    
    Pozri tiež:
    
    zapíšVlastnosť(String, Object), zapíšKomentárVlastností(String)
  - zapisPrazdnyRiadokVlastnosti
```
public void zapisPrazdnyRiadokVlastnosti()
```
    Alias pre zapíšPrázdnyRiadokVlastností.
  - čítajRiadok
```
public String čítajRiadok()
					throws IOException
```
    Prečíta zo súboru otvoreného na čítanie riadok textu a vráti ho v objekte typu String.
    
    Návratová hodnota:
    
    načítaný riadok textu
    
    Výnimky:
    
    IOException
  - citajRiadok
```
public String citajRiadok()
					throws IOException
```
    Alias pre čítajRiadok.
    
    Výnimky:
    
    IOException
  - čítajCeléČíslo
```
public Long čítajCeléČíslo()
					throws IOException
```
    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…
    
    Návratová hodnota:
    
    výsledok v objekte typu Long ak je načítaný text možné previesť na celé číslo alebo null v prípade zlyhania
    
    Výnimky:
    
    IOException
  - citajCeleCislo
```
public Long citajCeleCislo()
					throws IOException
```
    Alias pre čítajCeléČíslo.
    
    Výnimky:
    
    IOException
  - čítajReálneČíslo
```
public Double čítajReálneČíslo()
						throws IOException
```
    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…
    
    Návratová hodnota:
    
    výsledok v objekte typu Double ak je načítaný text možné previesť na rálne číslo alebo null v prípade zlyhania
    
    Výnimky:
    
    IOException
  - citajRealneCislo
```
public Double citajRealneCislo()
						throws IOException
```
    Alias pre čítajReálneČíslo.
    
    Výnimky:
    
    IOException
  - čítajBoolean
```
public Boolean čítajBoolean()
					throws IOException
```
    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. Platí, že ak bol nájdený text „true“ bez ohľadu na veľkosť písmen, bude hodnota objektu true, inak false.
    
    Návratová hodnota:
    
    výsledok v objekte typu Boolean alebo null v prípade zlyhania
    
    Výnimky:
    
    IOException
  - citajBoolean
```
public Boolean citajBoolean()
					throws IOException
```
    Alias pre čítajBoolean.
    
    Výnimky:
    
    IOException
  - čítaj
```
public void čítaj(Object... objekty)
			throws IOException,
				IllegalArgumentException
```
    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 načítaného textu je závislý od typu objektu. Sú povolené len niektoré údajové typy:
    StringBuffer – načíta riadok textu;
    int[], long[] – načíta toľko celých čísel, koľko prvkov má pole;
    float[], double[] – načíta toľko reálnych čísel, koľko prvkov má pole;
    boolean[] – načíta toľko pravdivostnýc h hodnôt, koľko prvkov má pole;
    char[] – načíta toľko znakov, koľko prvkov má pole.
    Ak metóda obdrží nepovolený údajový typ, vrhne výnimku IllegalArgumentException.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - citaj
```
public void citaj(Object... objekty)
			throws IOException,
				IllegalArgumentException
```
    Alias pre čítaj.
    
    Výnimky:
    
    IOException
    
    IllegalArgumentException
  - zapíšReťazec
```
public void zapíšReťazec(String text)
				throws IOException
```
    Zapíše do súboru otvoreného na zápis určený reťazec.
    
    Parametre:
    
    text – text, ktorý má byť zapísaný do súboru otvoreného na zápis
    
    Výnimky:
    
    IOException
  - zapisRetazec
```
public void zapisRetazec(String text)
				throws IOException
```
    Alias pre zapíšReťazec.
    
    Výnimky:
    
    IOException
  - zapíšRiadok
```
public void zapíšRiadok(String text)
				throws IOException
```
    Zapíše do súboru otvoreného na zápis riadok textu.
    
    Parametre:
    
    text – text, ktorý má byť zapísaný do samostatného riadka súboru otvoreného na zápis
    
    Výnimky:
    
    IOException
  - zapisRiadok
```
public void zapisRiadok(String text)
				throws IOException
```
    Alias pre zapíšRiadok.
    
    Výnimky:
    
    IOException
  - zapíšRiadok
```
public void zapíšRiadok()
				throws IOException
```
    Zapíše do súboru otvoreného na zápis prázdny riadok.
    (Pozri zoznam zmien.)
    
    Výnimky:
    
    IOException
  - zapisRiadok
```
public void zapisRiadok()
				throws IOException
```
    Alias pre zapíšRiadok.
    
    Výnimky:
    
    IOException
  - zapíš
```
public void zapíš(Object... objekty)
			throws IOException
```
    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). Táto metóda automaticky oddeľuje číselné argumenty medzerami (resp. argumenty, ktoré nie sú priamo objektami typu String ani StringBuffer), čo je výhodné pri čítaní údajov zo súboru.
    (Pozri zoznam zmien.)
    
    Parametre:
    
    objekty – séria objektov rôzneho údajového typu; objekt musí byť vyjadriteľný v textovej podobe
    
    Výnimky:
    
    IOException
  - zapis
```
public void zapis(Object... objekty)
			throws IOException
```
    Alias pre zapíš.
    
    Výnimky:
    
    IOException

Trieda GRobot.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

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

naposledyUpravený

naposledyUpraveny

mennýPriestorVlastností

mennyPriestorVlastnosti

mennýPriestorVlastností

mennyPriestorVlastnosti

dialógOtvoriť

dialogOtvorit

dialógUložiť

dialogUlozit

otvorNaZápis

otvorNaZapis

otvorNaZápis

otvorNaZapis

otvorNaČítanie

otvorNaCitanie

zavri

vlastnosťJestvuje

vlastnostJestvuje

vlastnosťExistuje

vlastnostExistuje

čítajVlastnosť

citajVlastnost

čítajVlastnosť

citajVlastnost

čítajVlastnosť

citajVlastnost

čítajVlastnosť

citajVlastnost

čítajVlastnosť

citajVlastnost

čítajVlastnosť

citajVlastnost

čítajVlastnosť

citajVlastnost

čítajVlastnosť

citajVlastnost

čítajVlastnosť

citajVlastnost

čítajVlastnosť

citajVlastnost