NAME

Clownfish::Hash - Hashtable.

SYNOPSIS

my $hash = Clownfish::Hash->new;
$hash->store($key, $value);
my $value = $hash->fetch($key);

DESCRIPTION

Values are stored by reference and may be any kind of Obj.

CONSTRUCTORS

new

my $hash = Clownfish::Hash->new(
    capacity => $capacity,  # default: 0
);

Return a new Hash.

  • capacity - The number of elements that the hash will be asked to hold initially.

METHODS

clear

$hash->clear();

Empty the hash of all key-value pairs.

store

$hash->store($key, $value);

Store a key-value pair.

fetch

my $obj = $hash->fetch($key);

Fetch the value associated with key.

Returns: the value, or undef if key is not present.

delete

my $obj = $hash->delete($key);

Attempt to delete a key-value pair from the hash.

Returns: the value if key exists and thus deletion succeeds; otherwise undef.

has_key

my $bool = $hash->has_key($key);

Indicate whether the supplied key is present.

keys

my $arrayref = $hash->keys();

Return the Hash’s keys.

values

my $arrayref = $hash->values();

Return the Hash’s values.

get_size

my $int = $hash->get_size();

Return the number of key-value pairs.

INHERITANCE

Clownfish::Hash isa Clownfish::Obj.