Package eu.pedu.lib20s.dbg
Class Printer
java.lang.Object
eu.pedu.lib20s.dbg.Printer
public final class Printer
extends java.lang.Object
Knihovní třída
Printer
poskytuje metody pro podmíněný výstup
ladicích tisků do předem zadaného proudu, kterým muže byt standardní výstup,
standardní chybový výstup, libovolný proud typu PrintStream
nebo soubor, který se v případě potřeby nejprve vytvoří.-
Field Summary
Fields Modifier and Type Field Description static int
DEBUG_LEVEL
Proměnná, jejiž hodnota ovlivňuje, zda se budou požadované tisky provádět nebo ne. -
Method Summary
Modifier and Type Method Description static boolean
addOutputStream(java.io.OutputStream outputStream)
Přidá zadaný tiskový proud mezi proudy, do nichž se zapisuje a vrátí informaci o tom, jestli se tím seznam změnil, tj. jestli nebyl zadaný proud před žádostí o přidání již v seznamu.static void
addOutputStream(java.lang.String path)
Je-li jako parametr zadaná hodnotaout
neboerr
, přidá do seznamu příslušný standardní proud; jiná podoba řetězce definuje cestu k souboru, který má být přidán do seznamu výstupních proudů Pokud tento soubor neexistuje, metoda se jej pokusí vytvořit.static int
getDEBUG_LEVEL()
Vrátí aktuální hodnotu proměnné ovlivňující hladinu kontrolních tisků.static java.util.Collection<java.io.OutputStream>
getOutputStreams()
Vrátí proud, do nějž odcházejí ladící tiskystatic void
pr(int printLevel, java.lang.String text)
Je-liDEBUG_LEVEL >= hladina
, vytiskne zadaný text bez závěrečného odřádkování.static void
pr(java.lang.String text)
Je-liDEBUG_LEVEL > 0
, vytiskne zadaný text bez závěrečného odřádkování.static void
prf(int printLevel, java.lang.String format, java.lang.Object... parameters)
Je-liDEBUG_LEVEL >= hladina
, vytiskne zadaný text v zadaném formátu.static void
prf(java.lang.String format, java.lang.Object... parameters)
Je-liDEBUG_LEVEL > 0
, vytiskne zadaný text v zadaném formátu.static void
prln(int printLevel, java.lang.String text)
Je-liDEBUG_LEVEL >= printLevel
, vytiskne zadaný text a odřádkuje.static void
prln(java.lang.String text)
Je-liDEBUG_LEVEL > 0
, vytiskne zadaný text a odřádkuje.static void
prNln(int printLevel, java.lang.String header, java.lang.Object[] array)
Je-liDEBUG_LEVEL > printLevel
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadaného pole každý na samostatný řádek odsazený proti záhlaví.static void
prNln(int printLevel, java.lang.String header, java.util.Collection<?> collection)
Je-liDEBUG_LEVEL > printLevel
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadané kolekce každý na samostatný řádek odsazený proti záhlaví.static void
prNln(int printLevel, java.lang.String header, java.util.stream.Stream<?> stream)
Je-liDEBUG_LEVEL > printLevel
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadaného pole každý na samostatný řádek odsazený proti záhlaví.static void
prNln(java.lang.String header, java.lang.Object[] array)
Je-liDEBUG_LEVEL > 0
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadaného pole každý na samostatný řádek odsazený proti záhlaví.static void
prNln(java.lang.String header, java.util.Collection<?> collection)
Je-liDEBUG_LEVEL > 0
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadané kolekce každý na samostatný řádek odsazený proti záhlaví.static void
prNln(java.lang.String header, java.util.stream.Stream<?> stream)
Je-liDEBUG_LEVEL > 0
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadaného proudu každý na samostatný řádek odsazený proti záhlaví.static boolean
removeOutputStream(java.io.OutputStream outputStream)
Odebere zadaný tiskový proud ze seznamu proudů, do nichž se zapisuje a vrátí informaci o tom, jestli se tím seznam změnil, tj. jestli byl zadaný proud před žádostí o odebrání v seznamu.static void
setDEBUG_LEVEL(int newLevel)
Nastaví aktuální hodnotu proměnné ovlivňující hladinu kontrolních tisků.static void
wait(int milliseconds)
Počká zadaný počet milisekund.
-
Field Details
-
DEBUG_LEVEL
public static int DEBUG_LEVELProměnná, jejiž hodnota ovlivňuje, zda se budou požadované tisky provádět nebo ne. Čím vyšší hodnota, tím víc bude realizovaných kontrolních tisků.
-
-
Method Details
-
getDEBUG_LEVEL
public static int getDEBUG_LEVEL()Vrátí aktuální hodnotu proměnné ovlivňující hladinu kontrolních tisků.- Returns:
- Aktuální hodnota proměnné ovlivňující hladinu kontrolních tisků; čím vyšší hodnota, tím víc bude realizovaných kontrolních tisků
-
setDEBUG_LEVEL
public static void setDEBUG_LEVEL(int newLevel)Nastaví aktuální hodnotu proměnné ovlivňující hladinu kontrolních tisků.- Parameters:
newLevel
- Požadovaná nová hladina; čím vyšší hodnota, tím víc bude realizovaných kontrolních tisků, 0 = prakticky se netiskne
-
getOutputStreams
public static java.util.Collection<java.io.OutputStream> getOutputStreams()Vrátí proud, do nějž odcházejí ladící tisky- Returns:
- Proud, do nějž odcházejí ladící tisky
-
addOutputStream
public static boolean addOutputStream(java.io.OutputStream outputStream)Přidá zadaný tiskový proud mezi proudy, do nichž se zapisuje a vrátí informaci o tom, jestli se tím seznam změnil, tj. jestli nebyl zadaný proud před žádostí o přidání již v seznamu.- Parameters:
outputStream
- Přidávaný tiskový proud- Returns:
- Byl-li proud v seznamu, vrátí
true
, jinak vrátífalse
-
addOutputStream
public static void addOutputStream(java.lang.String path)Je-li jako parametr zadaná hodnotaout
neboerr
, přidá do seznamu příslušný standardní proud; jiná podoba řetězce definuje cestu k souboru, který má být přidán do seznamu výstupních proudů Pokud tento soubor neexistuje, metoda se jej pokusí vytvořit.- Parameters:
path
- Název / cesta k proudu přidávanému do seznamu
-
removeOutputStream
public static boolean removeOutputStream(java.io.OutputStream outputStream)Odebere zadaný tiskový proud ze seznamu proudů, do nichž se zapisuje a vrátí informaci o tom, jestli se tím seznam změnil, tj. jestli byl zadaný proud před žádostí o odebrání v seznamu.- Parameters:
outputStream
- Odebíraný tiskový proud- Returns:
- Byl-li proud v seznamu, vrátí
true
, jinak vrátífalse
-
pr
public static void pr(java.lang.String text)Je-liDEBUG_LEVEL > 0
, vytiskne zadaný text bez závěrečného odřádkování.- Parameters:
text
- Tištěný text
-
pr
public static void pr(int printLevel, java.lang.String text)Je-liDEBUG_LEVEL >= hladina
, vytiskne zadaný text bez závěrečného odřádkování.- Parameters:
printLevel
- Hladina významnosti určující, zda se bude tisknouttext
- Text určený k vytištění
-
prf
public static void prf(java.lang.String format, java.lang.Object... parameters)Je-liDEBUG_LEVEL > 0
, vytiskne zadaný text v zadaném formátu.- Parameters:
format
- Formát specifikující způsob tisku následujících parametrůparameters
- Tištěné parametry
-
prf
public static void prf(int printLevel, java.lang.String format, java.lang.Object... parameters)Je-liDEBUG_LEVEL >= hladina
, vytiskne zadaný text v zadaném formátu.- Parameters:
printLevel
- Hladina významnosti určující, zda se bude tisknoutformat
- Formát tisku následujících parametrůparameters
- Tištěné parametry
-
prln
public static void prln(java.lang.String text)Je-liDEBUG_LEVEL > 0
, vytiskne zadaný text a odřádkuje.- Parameters:
text
- Text určený k vytištění
-
prln
public static void prln(int printLevel, java.lang.String text)Je-liDEBUG_LEVEL >= printLevel
, vytiskne zadaný text a odřádkuje.- Parameters:
printLevel
- Hladina významnosti určující, zda se bude tisknouttext
- Text určený k vytištění
-
prNln
public static void prNln(java.lang.String header, java.lang.Object[] array)Je-liDEBUG_LEVEL > 0
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadaného pole každý na samostatný řádek odsazený proti záhlaví.- Parameters:
header
- Záhlaví vytištěného polearray
- Pole objektů, jejichž podpisy se budou tisknout
-
prNln
public static void prNln(int printLevel, java.lang.String header, java.lang.Object[] array)Je-liDEBUG_LEVEL > printLevel
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadaného pole každý na samostatný řádek odsazený proti záhlaví.- Parameters:
printLevel
- Hladina významnosti určující, zda se bude tisknoutheader
- Záhlaví vytištěného polearray
- Pole objektů, jejichž podpisy se budou tisknout
-
prNln
public static void prNln(java.lang.String header, java.util.Collection<?> collection)Je-liDEBUG_LEVEL > 0
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadané kolekce každý na samostatný řádek odsazený proti záhlaví.- Parameters:
header
- Záhlaví vytištěné kolekcecollection
- Kolekce objektů, jejichž podpisy se budou tisknout
-
prNln
public static void prNln(int printLevel, java.lang.String header, java.util.Collection<?> collection)Je-liDEBUG_LEVEL > printLevel
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadané kolekce každý na samostatný řádek odsazený proti záhlaví.- Parameters:
printLevel
- Hladina významnosti určující, zda se bude tisknoutheader
- Záhlaví vytištěné kolekcecollection
- Kolekce objektů, jejichž podpisy se budou tisknout
-
prNln
public static void prNln(java.lang.String header, java.util.stream.Stream<?> stream)Je-liDEBUG_LEVEL > 0
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadaného proudu každý na samostatný řádek odsazený proti záhlaví.- Parameters:
header
- Záhlaví vytištěného polestream
- Pole objektů, jejichž podpisy se budou tisknout
-
prNln
public static void prNln(int printLevel, java.lang.String header, java.util.stream.Stream<?> stream)Je-liDEBUG_LEVEL > printLevel
, vytiskne zadané záhlaví a pod ním podpisy jednotlivých prvků zadaného pole každý na samostatný řádek odsazený proti záhlaví.- Parameters:
printLevel
- Hladina významnosti určující, zda se bude tisknoutheader
- Záhlaví vytištěného polestream
- Pole objektů, jejichž podpisy se budou tisknout
-
wait
public static void wait(int milliseconds)Počká zadaný počet milisekund. Při přerusení jednoduše skonči s nastaveným příkazem přerušení, aby na ně mohl volající program zareagovat.- Parameters:
milliseconds
- Počet milisekund, po něž se má čekat.
-