
Hash can be thought of as an associative array binding unique keys to values. Only difference is that you can use any string as an index instead of just using a number as index.
There are two ways to construct a Hash instance −
To create an empty hash you call any of the constructor methods without arguments, too.
Following is the example showing how to create hash, setting values and getting values in a simple way −
// Creating Hash
var myhash = new Hash();
var yourhash = new Hash( {fruit: 'apple'} );
var hishash = $H( {drink: 'pepsi'} );
// Set values in terms of key and values.
myhash.set('name', 'Bob');
// Get value of key 'name' as follows.
myhash.get('name');
yourhash.get('fruit');
hishash.get('drink');
// Unset a key & value
myhash.unset('name');
yourhash.unset('fruit');
hishash.unset('drink');
Prototype provides a wide range of methods to evaluate Hash with ease. This tutorial will explain every method in detail with suitable examples.
Here is a complete list of all the methods related to Hash.
NOTE − Make sure at least have the version 1.6 of prototype.js.
| S.No. | Method & Description |
|---|---|
| 1. | clone()
Returns a clone of hash. |
| 2. | each()
Iterates over the name/value pairs in the hash. |
| 3. | get()
Returns the value of the hash key's property. |
| 4. | inspect()
Returns the debug-oriented string representation of the hash. |
| 5. | keys()
Provides an Array of keys (that is, property names) for the hash. |
| 6. | merge()
Merges object to hash and returns the result of that merge. |
| 7. | remove()
Removes keys from a hash and returns their values. This method has been deprecated in version 1.6. |
| 8. | set()
Sets the hash key's property to value and returns value. |
| 9. | toJSON()
Returns a JSON string. |
| 10. | toObject()
Returns a cloned, vanilla object. |
| 11. | toQueryString()
Turns a hash into its URL-encoded query string representation. |
| 12. | unset()
Deletes the hash key's property and returns its value. |
| 13. | update()
Updates hash with the key/value pairs of object. The original hash will be modified. |
| 14. | values()
Collects the values of a hash and returns them in an array. |