Prty::Array - Operationen auf Arrays
Prty::Object
Ein Objekt der Klasse repräsentiert ein Array.
$arr = $class->new; $arr = $class->new(\@arr);
Instantiiere ein Array-Objekt und liefere eine Referenz auf dieses Objekt zurück. Ohne Angabe einer Array-Referenz wird ein leeres Array-Objekt instantiiert.
Jede der folgenden Methode kann sowohl auf ein Objekt der Klasse als auch per Aufruf als Klassenmethode auf ein "normales" Perl-Array angewendet werden.
Aufruf als Objektmethode:
$arr->$meth(...);
Aufruf als Klassenmethode:
$class->$meth(\@arr, ...);
$val = $arr->extractKeyVal($key); $val = $class->extractKeyVal(\@arr,$key);
Durchsuche @arr paarweise nach Element $key und liefere das folgende Element $val. Beide Elemente werden aus @arr entfernt. Kommt $key in @arr nicht vor, liefere undef und lasse @arr unverändert. Vergleichsoperator ist eq.
$val = $arr->findPairValue($key); $val = $class->findPairValue(\@arr,$key);
Durchsuche $arr paarweise nach Element $key. Kommt es vor, liefere dessen Wert. Kommt es nicht vor, liefere undef. Vergleichsoperator ist eq.
Wert oder undef
undef
$i = $arr->index($val); $i = $class->index(\@arr,$val);
Durchsuche @arr vom Anfang her nach Element $val und liefere dessen Index zurück. Kommt $str in @arr nicht vor, liefere -1. Vergleichsoperator ist eq.
$e = $arr->last; $e = $class->last(\@arr);
$l = $arr->maxLength; $l = $class>maxLength(\@arr);
Ermittele die Länge des längsten Arrayelements und liefere diese zurück.
$arr->push($e); $class->push(\@arr,$e);
$arr2|@arr2 = $arr->select($test); $arr2|@arr2 = $class->select(\@arr,$test);
Wende Test $test auf alle Arrayelemente an und liefere ein Array mit den Elementen zurück, die den Test erfüllen.
Folgende Arten von Tests sind möglich:
Wende Regex-Test auf jedes Element an.
Wende Subroutine-Test auf jedes Element an. Als erster Parameter wird das zu testende Element übergeben. Die Subroutine muss einen boolschen Wert liefern.
$arr->shuffle; $arr->shuffle($factor); $class->shuffle(\@arr); $class->shuffle(\@arr,$factor);
Mische die Elemente des Array @arr, d.h. bringe sie in eine zufällige Reihenfolge. Die Operation wird in-place ausgeführt.
Die Methode liefert keinen Wert zurück.
Das zu mischende Array.
Faktor für die Anzahl der Vertauschungsoperationen. Es werden Arraygröße * $factor Vertauschungsoperationen ausgeführt.
$arr | @arr = $arr->sort; $arr | @arr = $class->sort(\@arr);
Sortiere die Elemente des Array alphanumerisch.
Im Skalar-Kontext sortiere die Elemente "in place" und liefere die Array-Referenz zurück (Method-Chaining).
Im List-Kontext liefere die Elemente sortiert zurück, ohne den Inhalt des Array zu verändern.
$gcd = $arr->%METHOD; $gcd = $class->gcd(\@arr);
Berechne den größten gemeinsamen Teiler (greatest common divisor) der natürlichen Zahlen in Array @$arr bzw. @arr und liefere diesen zurück. Ist das Array leer, wird undef geliefert. Enthält das Array nur ein Element, wird dessen Wert geliefert.
$min = $arr->min; $min = $class->min(\@arr);
Ermittele die kleinste Zahl und liefere diese zurück. Enthält $arr keine Elemente, liefere undef.
$max = $arr->max; $max = $class->max(\@arr);
Ermittele die größte Zahl und liefere diese zurück. Enthält $arr keine Elemente, liefere undef.
($min,$max) = $arr->minMax; ($min,$max) = $class->minMax(\@arr);
Ermittele die kleinste und die größte Zahl und liefere die beiden Werte zurück. Enthält $arr keine Elemente, wird jeweils undef geliefert.
$x = $arr->meanValue; $x = $class->meanValue(\@arr);
Berechne das Arithmetische Mittel und liefere dieses zurück. Enthält $arr keine Elemente, liefere undef.
$x = $arr->standardDeviation; $x = $class->standardDeviation(\@arr);
Berechne die Standardabweichung und liefere diese zurück. Enthält $arr keine Elemente, liefere undef.
$x = $arr->variance; $x = $class->variance(\@arr);
Berechne die Varianz und liefere diese zurück. Enthält das Array keine Elemente, liefere undef.
$x = $arr->median; $x = $class->median(\@arr);
Ermittele den Median und liefere diesen zurück. Enthält das Array keine Elemente, liefere undef.
$str = $arr->dump; $str = $arr->dump($colSep); $str = $class->dump(\@arr); $str = $class->dump(\@arr,$colSep);
Liefere eine einzeilige, externe Repräsentation für Array $arr bzw. @arr im Format
elem0|elem1|...|elemN
Die Array-Elemente werden durch "|" (bzw. $colSep) getrennt. In den Elementen werden folgende Wandlungen vorgenommen:
undef -> '' (undef wird zu Leerstring) \ -> \\ (Backslash wird verdoppelt) $colSep -> \! LF -> \n CR -> \r
$arr = $class->restore($str); $arr = $class->restore($str,$colSep);
Wandele einzeilige, externe Array-Repräsentation (siehe Methode dump()) in ein Array-Objekt und liefere dieses zurück.
1.106
Frank Seitz, http://fseitz.de/
Copyright (C) 2017 Frank Seitz
This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Prty, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Prty
CPAN shell
perl -MCPAN -e shell install Prty
For more information on module installation, please visit the detailed CPAN module installation guide.