Header: mruby/hash.h

Overview

Hash class

Function Summary

• mrb_value mrb_hash_new_capa(mrb_state*, mrb_int)
• mrb_value mrb_hash_new(mrb_state *)

  Initializes a new hash.

• void mrb_hash_set(mrb_state *, mrb_value, mrb_value, mrb_value)

  Sets a keys and values to hashes.

• mrb_value mrb_hash_get(mrb_state *, mrb_value, mrb_value)

  Gets a value from a key.

• mrb_value mrb_hash_fetch(mrb_state *, mrb_value, mrb_value, mrb_value)

  Gets a value from a key.

• mrb_value mrb_hash_delete_key(mrb_state *, mrb_value, mrb_value)

  Deletes hash key and value pair.

• mrb_value mrb_hash_keys(mrb_state *, mrb_value)

  Gets an array of keys.

• mrb_value mrb_check_hash_type(mrb_state *, mrb_value)
• mrb_value mrb_hash_empty_p(mrb_state *, mrb_value)

  Check if the hash is empty.

• mrb_value mrb_hash_values(mrb_state *, mrb_value)

  Gets an array of values.

• mrb_value mrb_hash_clear(mrb_state *, mrb_value)

  Clears the hash.

• struct kh_ht * mrb_hash_tbl(mrb_state *, mrb_value)

Define Summary

#define MRUBY_HASH_H

#define mrb_hash_ptr

#define mrb_hash_value

#define RHASH

RHASH_TBL allocates st_table if not available.

#define RHASH_TBL

#define RHASH_IFNONE

#define RHASH_PROCDEFAULT

#define MRB_HASH_DEFAULT

#define MRB_HASH_PROC_DEFAULT

#define MRB_RHASH_DEFAULT_P

#define MRB_RHASH_PROCDEFAULT_P

Function Details

mrb_value mrb_hash_new_capa(mrb_state* , mrb_int )

mrb_value mrb_hash_new(mrb_state * mrb)

Initializes a new hash.

Equivalent to:

 Hash.new

Parameters:

• mrb —

  The mruby state reference.

Returns:

• The initialized hash.

void mrb_hash_set(mrb_state * mrb, mrb_value hash, mrb_value key, mrb_value val)

Sets a keys and values to hashes.

Equivalent to:

 hash[key] = val

Parameters:

• mrb —

  The mruby state reference.

• hash —

  The target hash.

• key —

  The key to set.

• val —

  The value to set.

Returns:

• The value.

mrb_value mrb_hash_get(mrb_state * mrb, mrb_value hash, mrb_value key)

Gets a value from a key. If the key is not found, the default of the hash is used.

Equivalent to:

hash[key]

Parameters:

• mrb —

  The mruby state reference.

• hash —

  The target hash.

• key —

  The key to get.

Returns:

• The found value.

mrb_value mrb_hash_fetch(mrb_state * mrb, mrb_value hash, mrb_value key, mrb_value def)

Gets a value from a key. If the key is not found, the default parameter is used.

Equivalent to:

hash.hash_key?(key) ? hash[key] : def

Parameters:

• mrb —

  The mruby state reference.

• hash —

  The target hash.

• key —

  The key to get.

• def —

  The default value.

Returns:

• The found value.

mrb_value mrb_hash_delete_key(mrb_state * mrb, mrb_value hash, mrb_value key)

Deletes hash key and value pair.

Equivalent to:

hash.delete(key)

Parameters:

• mrb —

  The mruby state reference.

• hash —

  The target hash.

• key —

  The key to delete.

Returns:

• The deleted value.

mrb_value mrb_hash_keys(mrb_state * mrb, mrb_value hash)

Gets an array of keys.

Equivalent to:

hash.keys

Parameters:

• mrb —

  The mruby state reference.

• hash —

  The target hash.

Returns:

• An array with the keys of the hash.

mrb_value mrb_check_hash_type(mrb_state * mrb, mrb_value hash)

mrb_value mrb_hash_empty_p(mrb_state * mrb, mrb_value self)

Check if the hash is empty

Equivalent to:

hash.empty?

Parameters:

• mrb —

  The mruby state reference.

• self —

  The target hash.

Returns:

• True if the hash is empty, false otherwise.

mrb_value mrb_hash_values(mrb_state * mrb, mrb_value hash)

Gets an array of values.

Equivalent to:

hash.values

Parameters:

• mrb —

  The mruby state reference.

• hash —

  The target hash.

Returns:

• An array with the values of the hash.

mrb_value mrb_hash_clear(mrb_state * mrb, mrb_value hash)

Clears the hash.

Equivalent to:

hash.clear

Parameters:

• mrb —

  The mruby state reference.

• hash —

  The target hash.

Returns:

• The hash

struct kh_ht * mrb_hash_tbl(mrb_state * mrb, mrb_value hash)