Name

SPVM::Hash - Hash (Associative Array)

Description

The Hash class of SPVM has methods to manipulate hashes(associative arrays).

Usage

use Hash;

my $book = Hash->new;
my $book = Hash->new({id => 4, name => "Perl", price => 3000.0});

$book->set_int(id => 4);
$book->set_string(name => "Perl");
$book->set_double(price => 3000.0);
$book->set(point => Point->new(1, 2));

my $id = $book->get_int("id");
my $name = $book->get_string("name");
my $price = $book->get_double("price");
my $point = (Point)$book->get("point");

Details

The hash function is siphash-1-3.

Interfaces

Cloneable

Fields

keys_length

has keys_length : ro int;

The length of the keys in the hash.

Class Methods

new

static method new : Hash ($key_values : object[] = undef);

Creates a new Hash object given key-value pairs $key_values.

Examples:

my $book = Hash->new;
my $book = Hash->new({});
my $book = Hash->new({id => 4, name => "Perl"});

Instance Methods

copy

method copy : Hash ();

Creates a new Hash object, and copies the keys and values of the current hash to the new hash, and returns it.

This is not deep copy. The keys are got by the "keys" method. The values are got by the "get" method.

clone

method clone : Hash ();

The alias for the "copy" method.

delete

method delete : object ($key : string);

Deletes the key and value given by the key $key.

The deleted value is returned.

Exceptions:

$key must be defined. Otherwise an exception is thrown.

exists

method exists : int ($key : string);

Checks if the value specified by the key $key exists. If it exists, returns 1. Otherwise returns 0.

keys

method keys : string[] ();

Gets the keys in the hash. This method does not copy the strings.

values

method values : object[] ();

Gets all the values in the hash.

get

method get : object ($key : string);

Gets a value specifed by the key $key, and returns it.

Exceptions:

$key must be defined. Otherwise an exception is thrown.

get_byte

method get_byte : int ($key : string);

Gets the value specifed by the key $key using the "get" method, and casts it to the byte type, and casts it to the int type, and returns it.

Exceptions:

The value of $key must be a Byte object. Otherwise an exception is thrown.

get_short

method get_short : int ($key : string);

Gets the value specifed by the key $key using the "get" method, and casts it to the short type, and casts it to the int type, and returns it.

Exceptions:

The value of $key must be a Short object. Otherwise an exception is thrown.

get_string

method get_string : string ($key : string)

Gets the value specifed by the key $key using the "get" method, and casts it to the string type, and returns it.

Exceptions:

The value of $key must be a string. Otherwise an exception is thrown.

get_int

method get_int : int ($key : string);

Gets the value specifed by the key $key using the "get" method, and casts it to the int type, and returns it.

Exceptions:

The value of $key must be a Int object. Otherwise an exception is thrown.

get_long

method get_long : long ($key : string);

Gets the value specifed by the key $key using the "get" method, and casts it to the long type, and returns it.

Exceptions:

The value of $key must be a Long object. Otherwise an exception is thrown.

get_float

method get_float : float ($key : string);

Gets the value specifed by the key $key using the "get" method, and casts it to the float type, and returns it.

Exceptions:

The value of $key must be a Float object. Otherwise an exception is thrown.

get_double

method get_double : double ($key : string);

Gets the value specifed by the key $key using the "get" method, and casts it to the double type, and returns it.

Exceptions:

The value of $key must be a Double object. Otherwise an exception is thrown.

set

method set : void ($key : string, $value : object);

Sets $value to the hash by the key $key.

Exceptions:

$key must be defined. Otherwise an exception is thrown.

set_byte

method set_byte : void ($key : string, $value : int);

The value $value is converted to a Byte object, and sets it to the hash by the key $key using the "set" method.

set_short

method set_short : void ($key : string, $value : int);

The value $value is converted to a Short object, and sets it to the hash by the key $key using the "set" method.

set_int

method set_int : void ($key : string, $value : int);

The value $value is converted to an Int object, and sets it to the hash by the key $key using the "set" method.

set_long

method set_long : void ($key : string, $value : long);

The value $value is converted to a Long object, and sets it to the hash by the key $key using the "set" method.

set_float

method set_float : void ($key : string, $value : float);

The value $value is converted to a Float object, and sets it to the hash by the key $key using the "set" method.

set_double

method set_double : void ($key : string, $value : double);

The value $value is converted to a Double object, and sets it to the hash by the key $key using the "set" method.

set_string

method set_string : void ($key : string, $value : string);

Sets the string $value to the hash by the key $key using the "set" method.

to_array

method to_array : object[] ($sort : int = 0);

Converts all the key-value pairs in the hash to an array, and returns it.

If the option $sort is a positive value, the keys are sorted by ascendant order.

If the option $sort is a negative value, the keys are sorted by decendant order.

delete_or_default_byte

method delete_or_default_byte : int ($key : string, $default : int;

If the value specified by the key $key exists, this method calls the "get_byte" method and the "delete" method, and returns the return value of the the "get_byte" method.