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. |