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á hodnota out nebo err, 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í tisky
    static void pr​(int printLevel, java.lang.String text)
    Je-li DEBUG_LEVEL >= hladina, vytiskne zadaný text bez závěrečného odřádkování.
    static void pr​(java.lang.String text)
    Je-li DEBUG_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-li DEBUG_LEVEL >= hladina, vytiskne zadaný text v zadaném formátu.
    static void prf​(java.lang.String format, java.lang.Object... parameters)
    Je-li DEBUG_LEVEL > 0, vytiskne zadaný text v zadaném formátu.
    static void prln​(int printLevel, java.lang.String text)
    Je-li DEBUG_LEVEL >= printLevel, vytiskne zadaný text a odřádkuje.
    static void prln​(java.lang.String text)
    Je-li DEBUG_LEVEL > 0, vytiskne zadaný text a odřádkuje.
    static void prNln​(int printLevel, java.lang.String header, java.lang.Object[] array)
    Je-li DEBUG_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-li DEBUG_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-li DEBUG_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-li DEBUG_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-li DEBUG_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-li DEBUG_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.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • DEBUG_LEVEL

      public static int DEBUG_LEVEL
      Promě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á hodnota out nebo err, 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-li DEBUG_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-li DEBUG_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 tisknout
      text - Text určený k vytištění
    • prf

      public static void prf​(java.lang.String format, java.lang.Object... parameters)
      Je-li DEBUG_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-li DEBUG_LEVEL >= hladina, vytiskne zadaný text v zadaném formátu.
      Parameters:
      printLevel - Hladina významnosti určující, zda se bude tisknout
      format - Formát tisku následujících parametrů
      parameters - Tištěné parametry
    • prln

      public static void prln​(java.lang.String text)
      Je-li DEBUG_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-li DEBUG_LEVEL >= printLevel, vytiskne zadaný text a odřádkuje.
      Parameters:
      printLevel - Hladina významnosti určující, zda se bude tisknout
      text - Text určený k vytištění
    • prNln

      public static void prNln​(java.lang.String header, java.lang.Object[] array)
      Je-li DEBUG_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 pole
      array - Pole objektů, jejichž podpisy se budou tisknout
    • prNln

      public static void prNln​(int printLevel, java.lang.String header, java.lang.Object[] array)
      Je-li DEBUG_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 tisknout
      header - Záhlaví vytištěného pole
      array - Pole objektů, jejichž podpisy se budou tisknout
    • prNln

      public static void prNln​(java.lang.String header, java.util.Collection<?> collection)
      Je-li DEBUG_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é kolekce
      collection - Kolekce objektů, jejichž podpisy se budou tisknout
    • prNln

      public static void prNln​(int printLevel, java.lang.String header, java.util.Collection<?> collection)
      Je-li DEBUG_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 tisknout
      header - Záhlaví vytištěné kolekce
      collection - Kolekce objektů, jejichž podpisy se budou tisknout
    • prNln

      public static void prNln​(java.lang.String header, java.util.stream.Stream<?> stream)
      Je-li DEBUG_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 pole
      stream - Pole objektů, jejichž podpisy se budou tisknout
    • prNln

      public static void prNln​(int printLevel, java.lang.String header, java.util.stream.Stream<?> stream)
      Je-li DEBUG_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 tisknout
      header - Záhlaví vytištěného pole
      stream - 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.