The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Quiq::OrderedHash - Hash mit geordneten Elementen

BASE CLASS

Quiq::Object

DESCRIPTION

Ein Objekt der Klasse repräsentiert einen geordneten Hash. Ein geordneter Hash ist ein Hash, bei dem die Schlüssel/Wert-Paare eine definierte Reihenfolge haben. Initial ist dies die Hinzufügereihenfolge.

METHODS

Konstruktor

new() - Konstruktor

Synopsis

    $oh = $class->new(@keyVal);

Description

Instantiiere einen geordneten Hash, setze die betreffenden Schlüssel/Wert-Paare und liefere eine Referenz auf dieses Objekt zurück.

Getter/Setter

get() - Liefere Werte

Synopsis

    @arr|$val = $oh->get(@keys);

Description

Liefere die Liste der Werte zu den angebenen Schlüsseln. Ist kein Schlüssel angegeben, liefere alle Werte. In Skalarkontext liefere keine Liste, sondern den Wert des ersten Schlüssels.

set() - Setze Schlüssel/Wert-Paare

Synopsis

    $oh->set(@keyVal);

Returns

nichts

Description

Setze die angegebenen Schlüssel/Wert-Paare.

setDelete() - Setze bzw. lösche Schlüssel/Wert-Paare

Synopsis

    $oh->setDelete(@keyVal);

Description

Setze die angegebenen Schlüssel auf die angegebenen Werte. Wenn $val undef ist, lösche den betreffenden Schlüssel. Die Methode liefert keinen Wert zurück.

Miscellaneous

clear() - Lösche Inhalt und setze Schlüssel/Wert-Paare

Synopsis

    $obj->clear(@keyVal);

Description

Lösche Inhalt und setze Schlüssel/Wert-Paare. Ist kein Schlüssel/Wert-Paar angegeben, wird nur der Inhalt gelöscht. Die Methode liefert keinen Wert zurück.

copy() - Kopiere Hash

Synopsis

    $oh2 = $oh->copy;

Description

Kopiere Hashobjekt und liefere eine Referenz auf die Kopie zurück.

delete() - Lösche Schlüssel

Synopsis

    $oh->delete(@keys);

Description

Lösche die angegebenen Schlüssel. Die Methode liefert keinen Wert zurück.

increment() - Inkrementiere Wert

Synopsis

    $n = $hash->increment($key);

Description

Inkrementiere Wert zu Schlüssel $key und liefere das Resultat zurück.

keys() - Liefere die Liste aller Schlüssel

Synopsis

    @keys|$keys = $oh->keys;

Description

Liefere die Liste der Schlüssel des Hash. In skalarem Kontext liefere eine Referenz auf die Liste.

hashSize() - Anzahl der Elemente

Synopsis

    $n = $oh->hashSize;

Description

Liefere die Anzahl der Elemente.

unshift() - Setze Schlüssel/Wert-Paar an den Anfang

Synopsis

    $oh->unshift($key=>$val);

Description

Setze das angegebene Schlüssel/Wert-Paar, sofern der Schlüssel noch nicht existiert, an den Anfang. Existiert der Schlüssel, wird der Wert ersetzt. Die Methode liefert keinen Wert zurück.

values() - Liefere die Liste der Werte

Synopsis

    @arr|$arr = $oh->values;

Description

Liefere die Liste der Werte in Schlüsselreihenfolge. In skalarem Kontext liefere eine Referenz auf die Liste.

Test Methods

exists() - Prüfe Existenz eines Schlüssels

Synopsis

    $oh->exists($key);

Description

Liefere "wahr", wenn der Hash den Schlüssel $key enthält, andernfalls "falsch".

VERSION

1.143

AUTHOR

Frank Seitz, http://fseitz.de/

COPYRIGHT

Copyright (C) 2019 Frank Seitz

LICENSE

This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.