Quiq::Properties - Eigenschaften einer Menge von skalaren Werten
Quiq::Object
Ein Objekt der Klasse ist Träger von Information über eine Menge von skalaren Werten (Integer, Float, String). Die Information ist nützlich, wenn die Menge der Werte tabellarisch dargestellt werden soll.
Typ der Wertemenge: s (Text), f (Float), d (Integer).
Breite des breitesten Werts der Wertemenge.
Maximale Anzahl an Zeichen einer Fließkommazahl vor und einschließlich dem Punkt. Dieses Attribut wird nur intern gebraucht, um die maximale Breite einer Fließkommazahl zu bestimmen.
Maximale Anzahl an Nachkommastellen im Falle einer Wertemenge vom Typ f (Float).
Ausrichtung der Werte der Wertemenge: l (left), r (right).
Erzeuge eine formatierte Liste von Float-Werten:
my @values = ( 234.567, 5.45, 92345.6, 42.56739, ); my $prp = Quiq::Properties->new(\@values); my $text; for (@values) { $text .= $prp->format('text',$_)."\n"; } print $text; __END__ 234.56700 5.45000 92345.60000 42.56739
$prp = $class->new(@opt); $prp = $class->new(\@values,@opt);
Array von skalaren Werten (Integers, Floats, Strings)
Entferne bei Floats nach dem Dezimalpunkt 0-en am Ende.
Objekt
Instantiiere ein Objekt der Klasse und liefere eine Referenz auf dieses Objekt zurück. Ist als Parameter eine Referenz auf ein Array angegeben, werden dessen Werte analysiert.
$align = $prp->align; $align = $prp->align($align);
Ausrichtung (Zeichen)
Setze/Liefere die Ausrichtung der Werte, falls sie tabellarisch angezeigt werden sollen.
Eine Wertemenge vom Typ d oder f hat die Ausrichtung r.
Eine Wertemenge vom Typ s hat per Default die Ausrichtung l, die aber auf r geändert werden werden kann.
$scale = $prp->scale;
Integer
Liefere die Maximale Anzahl an Nachkommastellen. Diese Information hat nur im Falle des Typs f (Float) eine Bedeutung.
$type = $prp->type; $type = $prp->type($type);
Typbezeichner (Zeichen)
Liefere den Typ der Kolumne.
Eine Wertmenge hat den Typ d, wenn sie ausschließlich aus Integern (und Leerstrings) besteht.
Eine Wertmenge hat den Typ f, wenn sie ausschließlich aus numerischen Werten (und Leerstrings) besteht und wenigstens ein numerischer Wert einen Dezimalpunkt enthält, also Nachkommastellen besitzt.
Eine Wertmenge hat den Typ s, wenn sie leer ist, nur aus Leerstrings besteht oder wenigsténs einen nichtnumerischen Wert enthält.
$width = $prp->width;
Liefere die Länge des längsten Werts.
Die Breite einer Wertemenge des Typs d oder s ist die Länge des längsten Werts.
Die Breite einer Wertemenge des Typs f ist die Summe aus der maximalen Anzahl an Nachkommastellen plus der maximalen Anzahl an Zeichen vor und einschließlich des Kommas.
$prp->analyze($value);
Skalarer Wert (Integer, Float, String)
Analysiere Wert $value hinsichtlich seiner Eigenschaften und passe die Eigenschaften der Menge entsprechend an. Ein leerer Wert (undef oder Leerstring) ändert die Eigenschaften nicht.
$str = $prp->format($format,$val);
Formatierung, die auf den Wert angewendet wird. Mögliche Werte: 'text', 'html'.
Skalarer Wert (Integer, Float, String) aus der Wertemenge.
Formatiere Wert $val gemäß Format $format und liefere das Resultat zurück.
$prp->set($type,$align);
Typ der Wertemenge: s (Text)
1.144
Frank Seitz, http://fseitz.de/
Copyright (C) 2019 Frank Seitz
This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Quiq, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Quiq
CPAN shell
perl -MCPAN -e shell install Quiq
For more information on module installation, please visit the detailed CPAN module installation guide.