Klasse NumFeld

java.lang.Object
gdv.xport.feld.Feld
gdv.xport.feld.NumFeld
Alle implementierten Schnittstellen:
Serializable, Cloneable, Comparable<Feld>
Bekannte direkte Unterklassen:
Betrag, Datum

public class NumFeld extends Feld
Klasse fuer numerische Zeichen. Die Default-Einstellung fuer die Darstellung ist rechtsbuendig.

Siehe Broschuere_gdv-datensatz_vu-vermittler.pdf, Seite 16 ("Datenfelder/Feldformate").

Autor:
oliver
Siehe auch:
  • Konstruktordetails

    • NumFeld

      @Deprecated public NumFeld(String name, String s)
      Veraltet.
      bitte anderen Constructor verwenden (TODO: wird mit v8 entsorgt)
      Parameter:
      name - Feld-Bezeichner (z.B. "Anzahl Saetze")
      s - z.B. "4"
    • NumFeld

      @Deprecated public NumFeld(Bezeichner bezeichner, int length, int start)
      Veraltet.
      durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
      Legt ein neues numerisches Feld an.
      Parameter:
      bezeichner - Feld-Bezeichner (z.B. "Anzahl Saetze")
      length - Anzahl Bytes
      start - Start-Byte (beginnend bei 1)
      Seit:
      1.0
    • NumFeld

      public NumFeld(Bezeichner bezeichner, int length, ByteAdresse start)
      Legt ein neues numerisches Feld an.
      Parameter:
      bezeichner - Feld-Bezeichner (z.B. "Anzahl Saetze")
      length - Anzahl Bytes
      start - Start-Adresse
      Seit:
      7.0 (07-Jan-2024)
    • NumFeld

      @Deprecated public NumFeld(Bezeichner bezeichner, int length, int start, int value)
      Veraltet.
      durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
      Legt ein neues numerisches Feld an.
      Parameter:
      bezeichner - Feld-Bezeichner (z.B. "Anzahl Saetze")
      length - Anzahl Bytes
      start - Start-Byte (beginnend bei 1)
      value - z.B. "01"
      Seit:
      1.0
    • NumFeld

      public NumFeld(Bezeichner bezeichner, int length, ByteAdresse start, int value)
      Legt ein neues numerisches Feld an.
      Parameter:
      bezeichner - Feld-Bezeichner (z.B. "Anzahl Saetze")
      length - Anzahl Bytes
      start - Start-Byte (beginnend bei 1)
      value - z.B. "01"
      Seit:
      7.0 (07-Jan-2024)
    • NumFeld

      @Deprecated public NumFeld(String name, int start, String value)
      Veraltet.
      durch entsprechenden Constructor mit Bezeichner und ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
      Parameter:
      name - Feld-Bezeichner (z.B. "Anzahl Saetze")
      start - Start-Byte (beginnend bei 1)
      value - z.B. "01"
      Seit:
      0.4
    • NumFeld

      @Deprecated public NumFeld(String name, String s, int nachkommastellen)
      Veraltet.
      durch entsprechenden Constructor mit Bezeichner ersetzt (TODO: wird mit v8 entsorgt)
      Parameter:
      name - Feld-Bezeichner (z.B. "pi")
      s - der Inhalt (z.B. "314")
      nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)
      Seit:
      0.4
    • NumFeld

      @Deprecated public NumFeld(Bezeichner name, int start, String value, int nachkommastellen)
      Veraltet.
      durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
      Instantiiert ein neues numerisches Feld.
      Parameter:
      name - Feld-Bezeichner (z.B. "pi")
      start - Start-Byte (beginnend ab 1)
      value - der Inhalt (z.B. "314")
      nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)
      Seit:
      4.0
    • NumFeld

      public NumFeld(Bezeichner name, ByteAdresse start, String value, int nachkommastellen)
      Instantiiert ein neues numerisches Feld.
      Parameter:
      name - Feld-Bezeichner (z.B. "pi")
      start - Start-Byte (beginnend ab 1)
      value - der Inhalt (z.B. "314")
      nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)
      Seit:
      7.0 (07-Jan-2024)
    • NumFeld

      @Deprecated public NumFeld(Bezeichner name, int length, int start, int value, int nachkommastellen)
      Veraltet.
      durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
      Legt ein neues numerisches Feld an.
      Parameter:
      name - Feld-Bezeichner (z.B. "pi")
      length - Gesamtlaenge
      start - Start-Byte (beginnend ab 1)
      value - der Inhalt (z.B. 314)
      nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)
      Seit:
      1.0
    • NumFeld

      public NumFeld(Bezeichner name, int length, ByteAdresse start, int value, int nachkommastellen)
      Legt ein neues numerisches Feld an.
      Parameter:
      name - Feld-Bezeichner (z.B. "pi")
      length - Gesamtlaenge
      start - Start-Byte (beginnend ab 1)
      value - der Inhalt (z.B. 314)
      nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)
      Seit:
      7.0 (07-Jan-2024)
    • NumFeld

      @Deprecated protected NumFeld(Bezeichner name, int length, int start, int nachkommastellen, Config config)
      Veraltet.
    • NumFeld

      protected NumFeld(Bezeichner name, int length, ByteAdresse start, int nachkommastellen, Config config)
    • NumFeld

      public NumFeld(Feld other)
      Dies ist der Copy-Constructor, mit dem man ein bestehendes Feld kopieren kann.
      Parameter:
      other - das originale Feld
    • NumFeld

      protected NumFeld(Feld other, Config config)
  • Methodendetails

    • mitNachkommastellen

      public NumFeld mitNachkommastellen(int n)
      Liefert ein neues NumFeld mit der gewuenschten Anzahl von Nachkommastellen zurueck.
      Parameter:
      n - Anzahl der Nachkommastellen
      Gibt zurück:
      neues NumFeld mit n Nachkommastellen
      Seit:
      0.4
    • mitConfig

      public NumFeld mitConfig(Config c)
      Liefert eine neues NumFeld mit neuer Konfiguration
      Setzt außer Kraft:
      mitConfig in Klasse Feld
      Parameter:
      c - neue Konfiguration
      Gibt zurück:
      neues NumFeld
      Seit:
      5.3
    • getNachkommastellen

      public int getNachkommastellen()
      Liefert die Anzahl der Nachkommastellen.
      Gibt zurück:
      Anzahl der Nachkommastellen
    • setInhalt

      public void setInhalt(char c)
      Setzt den Inhalt mit der uebergebenen Ziffer.
      Setzt außer Kraft:
      setInhalt in Klasse Feld
      Parameter:
      c - neuer Inhalt
    • setInhalt

      public void setInhalt(long n)
      Setzt den Inhalt mit der uebergebenen Zahl unter Beruecksichtigung der Nachkommastellen.

      ACHTUNG: Ab 5.1 werden hier die Nachkommastellen beruecksichtigt.

      Setzt außer Kraft:
      setInhalt in Klasse Feld
      Parameter:
      n - neuer Inhalt
      Löst aus:
      IllegalArgumentException - wenn n < 0
    • setInhalt

      public void setInhalt(BigInteger n)
      Setzt den Inhalt mit der uebergebenen Zahl unter Beruecksichtigung der Nachkommastellen.

      ACHTUNG: Ab 5.1 werden hier die Nachkommastellen beruecksichtigt.

      Setzt außer Kraft:
      setInhalt in Klasse Feld
      Parameter:
      n - neuer Inhalt
      Löst aus:
      IllegalArgumentException - wenn n < 0
    • setInhalt

      public void setInhalt(BigDecimal n)
      Setzt den Inhalt mit der uebergebenen Zahl.
      Setzt außer Kraft:
      setInhalt in Klasse Feld
      Parameter:
      n - Zahl
      Löst aus:
      IllegalArgumentException - wenn n < 0
      Seit:
      5.0
    • setInhalt

      public void setInhalt(double x)
      Setzt den Inhalt eines Feldes als Double. Nach Moeglichkeit soll setInhalt(BigDecimal) verwendet werden, da die interne Darstellung von double-Werten nie exakt sind.
      Parameter:
      x - der neue Inhalt
      Löst aus:
      IllegalArgumentException - wenn n < 0
      Seit:
      6.1
    • pack

      protected String pack(String s)
      Setzt außer Kraft:
      pack in Klasse Feld
    • getInhalt

      public String getInhalt()
      Beschreibung aus Klasse kopiert: Feld
      Liefert den Inhalt, so wie er im Record steht (ungetrimm't).
      Setzt außer Kraft:
      getInhalt in Klasse Feld
      Gibt zurück:
      den Inhalt
    • resetInhalt

      public void resetInhalt()
      Beschreibung aus Klasse kopiert: Feld
      Reset inhalt.
      Setzt außer Kraft:
      resetInhalt in Klasse Feld
    • truncate

      protected String truncate(String s)
      Beschreibung aus Klasse kopiert: Feld
      Schneidet einen zu langen String unabhaengig vom Alignment rechts ab.
      Setzt außer Kraft:
      truncate in Klasse Feld
      Parameter:
      s - String, der evtl. gekuerzt wird
      Gibt zurück:
      String der Laenge Feld.getAnzahlBytes()
    • toInt

      public int toInt()
      Wandelt den Inhalt in einen Integer (ohne Beruecksichtigung etwaiger Nachkommastellen).
      Gibt zurück:
      den Inhalt als int
    • toLong

      public long toLong()
      Wandelt den Inhalt in einen Long (ohne Beruecksichtigung etwaiger Nachkommastellen).
      Gibt zurück:
      den Inhalt als long
    • toDouble

      public double toDouble()
      Wenn eine Zahl Nachkommastellen hat, sollte sie auch als Double ausgegeben werden koennen.
      Gibt zurück:
      die Zahl als Double
      Seit:
      0.4
    • toBigInteger

      public BigInteger toBigInteger()
      Fuer grosse Zahlen kann auch schon mal ein BigInteger noetig sein.
      Gibt zurück:
      die Zahl als BigInteger
      Seit:
      5.4
    • toBigDecimal

      public BigDecimal toBigDecimal()
      Wenn eine Zahl Nachkommastellen hat, sollte sie auch als BigDecimal ausgegeben werden koennen.
      Gibt zurück:
      die Zahl als BigDecimal
      Seit:
      5.0
    • add

      public BigDecimal add(BigDecimal summand)
      Addiert den Summand auf und liefert die Summe zurueck.
      Parameter:
      summand - der aufaddiert wird
      Gibt zurück:
      Summe
      Seit:
      5.0
    • hasValue

      public boolean hasValue()
      Dient zum Ermittel, ob ein Werte schon gesetzt wurde. Dabei werden typische Initialisierungswerte wie "0" als "nicht gesetzt" interpretiert.
      Setzt außer Kraft:
      hasValue in Klasse Feld
      Gibt zurück:
      true, falls Feld mit einem Wert belegt ist
      Seit:
      3.1
    • format

      public String format()
      Beschreibung aus Klasse kopiert: Feld
      Diese Methode ist dafuer vorgesehen, das Feld als normalen String ausgeben zu koennen. Zahlen koennen so z.B. in der Form "123,45" ausgegeben werden, unter Beruecksichtigung der eingestellten "Locale".
      Setzt außer Kraft:
      format in Klasse Feld
      Gibt zurück:
      Inhalt des Feldes
    • clone

      public Object clone()
      Beschreibung aus Klasse kopiert: Feld
      Die clone-Methode hat gegenueber dem CopyConstructor Feld(Feld) den Vorteil, dass es den richtigen Typ fuer die abgeleiteten Klassen zurueckliefert.
      Setzt außer Kraft:
      clone in Klasse Feld
      Gibt zurück:
      eine Kopie