Upozornenie
Toto je pôvodné prvé vydanie dokumentácie pre verziu knižnice grafického robota 1.0 beta. V súčasnosti už nie je aktuálne.
Novšie vydanie dokumentácie pre verziu 1.50 je publikované na nasledujúcej adrese:
http://cec.truni.sk/horvath/GRobot/
protected static class Robot.Súbor extends Object
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 predošlom 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 nasledovný 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
Modifier | Konštruktor a opis |
---|---|
protected |
Robot.Súbor() |
Modifikátor a typ | Metóda a opis |
---|---|
void |
citaj(Object... objekty)
![]() čítaj . |
Boolean |
citajBoolean()
![]() čítajBoolean . |
Long |
citajCeleCislo()
![]() čítajCeléČíslo . |
Double |
citajRealneCislo()
![]() čítajReálneČíslo . |
String |
citajRiadok()
![]() čítajRiadok . |
Boolean |
citajVlastnost(String názov,
Boolean predvolenáHodnota)
![]() čítajVlastnosť . |
boolean[] |
citajVlastnost(String názov,
boolean[] predvolenáHodnota)
![]() čítajVlastnosť . |
Double |
citajVlastnost(String názov,
Double predvolenáHodnota)
![]() čítajVlastnosť . |
double[] |
citajVlastnost(String názov,
double[] predvolenáHodnota)
![]() čítajVlastnosť . |
float[] |
citajVlastnost(String názov,
float[] predvolenáHodnota)
![]() čítajVlastnosť . |
char[] |
citajVlastnost(String názov,
char[] predvolenáHodnota)
![]() čítajVlastnosť . |
int[] |
citajVlastnost(String názov,
int[] predvolenáHodnota)
![]() čítajVlastnosť . |
Long |
citajVlastnost(String názov,
Long predvolenáHodnota)
![]() čítajVlastnosť . |
long[] |
citajVlastnost(String názov,
long[] predvolenáHodnota)
![]() čítajVlastnosť . |
String |
citajVlastnost(String názov,
String predvolenáHodnota)
![]() čítajVlastnosť . |
StringBuffer |
citajVlastnost(String názov,
StringBuffer predvolenáHodnota)
![]() čí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 . |
String |
dialogOtvorit(String titulok)
![]() dialógOtvoriť . |
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.
|
String |
dialogUlozit(String titulok)
![]() dialógUložiť . |
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)
![]() 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)
![]() 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ľ)
![]() 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ť)
![]() 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()
![]() mennýPriestorVlastností . |
String |
mennýPriestorVlastností()
![]() |
void |
mennyPriestorVlastnosti(String novýMennýPriestor)
![]() mennýPriestorVlastností . |
void |
mennýPriestorVlastností(String novýMennýPriestor)
![]() |
static boolean |
novyPriecinok(String názov)
![]() vytvorPriečinok . |
static boolean |
novýPriečinok(String názov)
![]() vytvorPriečinok . |
void |
otvorNaCitanie(String názovSúboru)
![]() otvorNaČítanie . |
void |
otvorNaČítanie(String názovSúboru)
Otvorí zadaný súbor na čítanie.
|
void |
otvorNaZapis(String názovSúboru)
![]() otvorNaZápis . |
void |
otvorNaZápis(String názovSúboru)
Otvorí zadaný súbor na zápis.
|
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)
![]() presuň . |
static boolean |
presuň(String zdroj,
String cieľovýPriečinok)
Presunie zdrojový súbor alebo priečinok do cieľovej cesty.
|
static boolean |
vymaz(String názov)
![]() vymaž . |
static boolean |
vymaž(String názov)
Vymaže súbor alebo priečinok so zadaným názvom.
|
static boolean |
vytvorPriecinok(String názov)
![]() 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).
|
void |
zapis(Object... objekty)
![]() zapíš . |
void |
zapisKomentarVlastnosti(String komentár)
![]() zapíšKomentárVlastností . |
void |
zapisPrazdnyRiadokVlastnosti()
![]() zapíšPrázdnyRiadokVlastností . |
void |
zapisRetazec(String text)
![]() zapíšReťazec . |
void |
zapisRiadok(String text)
![]() zapíšRiadok . |
void |
zapisVlastnost(String názov,
Object hodnota)
![]() 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 daný reťazec.
|
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)
![]() zoznamPriečinkov . |
static String[] |
zoznamPriečinkov(String cesta)
Vytvorí zoznam priečinkov umiestnených na zadanej ceste.
|
static String[] |
zoznamSuborov(String cesta)
![]() zoznamSúborov . |
static String[] |
zoznamSúborov(String cesta)
Vytvorí zoznam súborov umiestnených v zadanom priečinku.
|
static String[] |
zoznamSuborovAPriecinkov(String cesta)
![]() zoznamSúborovAPriečinkov . |
static String[] |
zoznamSúborovAPriečinkov(String cesta)
Vytvorí zoznam súborov a priečinkov umiestnených v zadanom priečinku.
|
public static String[] zoznamSúborov(String cesta) throws FileNotFoundException, IllegalArgumentException
cesta
– cesta a názov priečinka, z obsahu ktorého má byť
vytvorený zoznamString
so zoznamom súborovFileNotFoundException
– ak cesta nebola nájdenáIllegalArgumentException
– ak je zadaná cesta neplatnápublic static String[] zoznamSuborov(String cesta) throws FileNotFoundException, IllegalArgumentException
zoznamSúborov
.public static String[] zoznamPriečinkov(String cesta) throws FileNotFoundException, IllegalArgumentException
cesta
– cesta na ktorej sa majú hľadať priečinkyString
so zoznamom
priečinkovFileNotFoundException
– ak cesta nebola nájdenáIllegalArgumentException
– ak je zadaná cesta neplatnápublic static String[] zoznamPriecinkov(String cesta) throws FileNotFoundException, IllegalArgumentException
zoznamPriečinkov
.public static String[] zoznamSúborovAPriečinkov(String cesta) throws FileNotFoundException, IllegalArgumentException
cesta
– cesta a názov priečinka, z obsahu ktorého má byť
vytvorený zoznamString
so zoznamom súborov
a priečinkovFileNotFoundException
– ak cesta nebola nájdenáIllegalArgumentException
– ak je zadaná cesta neplatnápublic static String[] zoznamSuborovAPriecinkov(String cesta) throws FileNotFoundException, IllegalArgumentException
zoznamSúborovAPriečinkov
.public static String[] zoznam(String cesta) throws FileNotFoundException, IllegalArgumentException
zoznamSúborovAPriečinkov
.cesta
– cesta a názov priečinka, z obsahu ktorého má byť
vytvorený zoznamString
so zoznamom
položiekFileNotFoundException
– ak cesta nebola nájdenáIllegalArgumentException
– ak je zadaná cesta neplatnápublic static boolean existuje(String názov)
názov
– názov súboru alebo priečinkatrue
– áno; false
– niepublic static boolean jestvuje(String názov)
názov
– názov súboru alebo priečinkatrue
– áno; false
– niepublic static boolean vytvorPriečinok(String názov)
názov
– názov súboru alebo priečinkatrue
vtedy a len vtedy, ak bol priečinok
úspešne vytvorený úspešne, inak false
public static boolean vytvorPriecinok(String názov)
vytvorPriečinok
.public static boolean novýPriečinok(String názov)
vytvorPriečinok
.public static boolean novyPriecinok(String názov)
vytvorPriečinok
.public static boolean jeSúbor(String názov)
názov
– názov súboru alebo priečinkatrue
v prípade, že súbor so zadaným názvom
jestvuje a ide o normálny súbor, inak false
public static boolean jePriečinok(String názov)
názov
– názov súboru alebo priečinkatrue
v prípade, že položka so zadaným názvom
jestvuje a je to priečinok, inak false
public static boolean jePriecinok(String názov)
jePriečinok
.public static void kopíruj(String zdroj, String cieľ, boolean prepísať) throws FileNotFoundException, IOException
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()); }
zdroj
– názov (a cesta) zdrojového súborucieľ
– názov (a cesta) cieľového súboruprepísať
– ak je true
, cieľový súbor bude
prepísaný (ak jestvuje)FileNotFoundException
IOException
public static void kopiruj(String zdroj, String cieľ, boolean prepísať) throws FileNotFoundException, IOException
kopíruj
.FileNotFoundException
IOException
public static void kopíruj(String zdroj, String cieľ) throws FileNotFoundException, IOException
kopíruj(zdroj, cieľ, prepísať
).zdroj
– názov (a cesta) zdrojového súborucieľ
– názov (a cesta) cieľového súboruFileNotFoundException
IOException
public static void kopiruj(String zdroj, String cieľ) throws FileNotFoundException, IOException
kopíruj
.FileNotFoundException
IOException
public static boolean premenuj(String zdroj, String cieľ)
zdroj
– názov (a cesta) zdrojového súboru alebo priečinkacieľ
– názov (a cesta) cieľového súboru alebo priečinkatrue
vtedy a len vtedy, ak operácia
premenovania prebehla úspešne, inak false
public static boolean presuň(String zdroj, String cieľovýPriečinok)
zdroj
– názov (a cesta) zdrojového súboru alebo priečinkacieľovýPriečinok
– cesta do cieľového priečinkatrue
vtedy a len vtedy, ak operácia presunu
prebehla úspešne, inak false
public static boolean vymaž(String názov)
názov
– názov súboru alebo priečinkatrue
vtedy a len vtedy, ak operácia vymazania
prebehla úspešne, inak false
public String mennýPriestorVlastností()
mennýPriestorVlastností(String)
.String
alebo null
ak nie je
používaný žiadny menný priestorpublic String mennyPriestorVlastnosti()
mennýPriestorVlastností
.public void mennýPriestorVlastností(String novýMennýPriestor)
null
.novýMennýPriestor
– názov nového menného priestoru alebo
null
na zrušenie používania menného priestorupublic void mennyPriestorVlastnosti(String novýMennýPriestor)
mennýPriestorVlastností
.public String dialógOtvoriť(String titulok)
null
.null
public String dialogOtvorit(String titulok)
dialógOtvoriť
.public String dialógUložiť(String titulok)
null
.null
public String dialogUlozit(String titulok)
dialógUložiť
.public void otvorNaZápis(String názovSúboru) throws IOException, NullPointerException
názovSúboru
– názov súboru, ktorý má byť otvorený na zápisIOException
NullPointerException
public void otvorNaZapis(String názovSúboru) throws IOException, NullPointerException
otvorNaZápis
.IOException
NullPointerException
public void otvorNaČítanie(String názovSúboru) throws IOException, NullPointerException
(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…)
názovSúboru
– názov súboru, ktorý má byť otvorený na čítanieIOException
NullPointerException
public void otvorNaCitanie(String názovSúboru) throws IOException, NullPointerException
otvorNaČítanie
.IOException
NullPointerException
public void zavri() throws IOException
IOException
public String čítajVlastnosť(String názov, String predvolenáHodnota) throws IOException, IllegalArgumentException
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áString
IOException
IllegalArgumentException
public String citajVlastnost(String názov, String predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public StringBuffer čítajVlastnosť(String názov, StringBuffer predvolenáHodnota) throws IOException, IllegalArgumentException
StringBuffer
.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áStringBuffer
IOException
IllegalArgumentException
public StringBuffer citajVlastnost(String názov, StringBuffer predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public Long čítajVlastnosť(String názov, Long predvolenáHodnota) throws IOException, IllegalArgumentException
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 chybeLong
IOException
IllegalArgumentException
public Long citajVlastnost(String názov, Long predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public Double čítajVlastnosť(String názov, Double predvolenáHodnota) throws IOException, IllegalArgumentException
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 chybeDouble
IOException
IllegalArgumentException
public Double citajVlastnost(String názov, Double predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public Boolean čítajVlastnosť(String názov, Boolean predvolenáHodnota) throws IOException, IllegalArgumentException
true
/
false
.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áBoolean
IOException
IllegalArgumentException
public Boolean citajVlastnost(String názov, Boolean predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public int[] čítajVlastnosť(String názov, int[] predvolenáHodnota) throws IOException, IllegalArgumentException
int
.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ázdnaint
, 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
hodnotyIOException
IllegalArgumentException
public int[] citajVlastnost(String názov, int[] predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public float[] čítajVlastnosť(String názov, float[] predvolenáHodnota) throws IOException, IllegalArgumentException
float
.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ázdnafloat
, 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 hodnotyIOException
IllegalArgumentException
public float[] citajVlastnost(String názov, float[] predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public long[] čítajVlastnosť(String názov, long[] predvolenáHodnota) throws IOException, IllegalArgumentException
long
.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ázdnalong
, 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
hodnotyIOException
IllegalArgumentException
public long[] citajVlastnost(String názov, long[] predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public double[] čítajVlastnosť(String názov, double[] predvolenáHodnota) throws IOException, IllegalArgumentException
double
.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ázdnadouble
, 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 hodnotyIOException
IllegalArgumentException
public double[] citajVlastnost(String názov, double[] predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public boolean[] čítajVlastnosť(String názov, boolean[] predvolenáHodnota) throws IOException, IllegalArgumentException
boolean
.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ázdnaboolean
, 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 hodnotyIOException
IllegalArgumentException
public boolean[] citajVlastnost(String názov, boolean[] predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public char[] čítajVlastnosť(String názov, char[] predvolenáHodnota) throws IOException, IllegalArgumentException
char[]
). Metóda
vracia nové pole znakov, ktorého prvky tvoria všetky znaky získané
z hodnoty tejto vlastnosti.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áchar[]
), ktoré tvoria hodnotu
tejto vlastnosti, prípadne kópia poľa zadaného do predvolenej
hodnoty (ak vlastnosť v otvorenom súbore nejestvuje)IOException
IllegalArgumentException
public char[] citajVlastnost(String názov, char[] predvolenáHodnota) throws IOException, IllegalArgumentException
čítajVlastnosť
.IOException
IllegalArgumentException
public void zapíšVlastnosť(String názov, Object hodnota) throws IOException, IllegalArgumentException
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 podobeIOException
IllegalArgumentException
public void zapisVlastnost(String názov, Object hodnota) throws IOException, IllegalArgumentException
zapíšVlastnosť
.IOException
IllegalArgumentException
public void zapíšKomentárVlastností(String komentár)
komentár
– text komentárapublic void zapisKomentarVlastnosti(String komentár)
zapíšKomentárVlastností
.public void zapíšPrázdnyRiadokVlastností()
public void zapisPrazdnyRiadokVlastnosti()
zapíšPrázdnyRiadokVlastností
.public String čítajRiadok() throws IOException
String
.IOException
public String citajRiadok() throws IOException
čítajRiadok
.IOException
public Long čítajCeléČíslo() throws IOException
Long
ak je
načítaný text možné previesť na celé číslo alebo null
v prípade zlyhaniaIOException
public Long citajCeleCislo() throws IOException
čítajCeléČíslo
.IOException
public Double čítajReálneČíslo() throws IOException
Double
ak je
načítaný text možné previesť na rálne číslo alebo null
v prípade zlyhaniaIOException
public Double citajRealneCislo() throws IOException
čítajReálneČíslo
.IOException
public Boolean čítajBoolean() throws IOException
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
.Boolean
,
alebo null
v prípade zlyhaniaIOException
public Boolean citajBoolean() throws IOException
čítajBoolean
.IOException
public void čítaj(Object... objekty) throws IOException, IllegalArgumentException
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ých 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
.
IOException
IllegalArgumentException
public void citaj(Object... objekty) throws IOException, IllegalArgumentException
čítaj
.IOException
IllegalArgumentException
public void zapíšReťazec(String text) throws IOException
text
– text, ktorý má byť zapísaný do súboru otvoreného na zápisIOException
public void zapisRetazec(String text) throws IOException
zapíšReťazec
.IOException
public void zapíšRiadok(String text) throws IOException
text
– text, ktorý má byť zapísaný do samostatného riadka
súboru otvoreného na zápisIOException
public void zapisRiadok(String text) throws IOException
zapíšRiadok
.IOException
public void zapíš(Object... objekty) throws IOException
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.objekty
– séria objektov rôzneho údajového typu; objekt musí byť
vyjadriteľný v textovej podobeIOException
public void zapis(Object... objekty) throws IOException
zapíš
.IOException