Removes all key-value pairs from a hash

clear removes all key-values from a hash.

Usage

clear(x)

Arguments

x

A hash object.

Details

Currently clear removes (rm) the key-value pairs on the hash. For large hashes it might be faster to reinitialize the hash, though this might cause memory leaks.

Value

None. Method clear exists entirely for its side effects.

Note

clear should be called prior to removing a hash. This ensures that the memory from the environment is freed.

Author

Christopher Brown

See also

del to remove specific key-values from the hash. hash.

Examples

  h <- hash( letters, 1:26 )
  h # An object of type 'hash' containing 26 key-value pairs.
#> <hash> containing 26 key-value pair(s).
#>   a : 1
#>   b : 2
#>   c : 3
#>   d : 4
#>   e : 5
#>   f : 6
#>   g : 7
#>   h : 8
#>   i : 9
#>   j : 10
#>   k : 11
#>   l : 12
#>   m : 13
#>   n : 14
#>   o : 15
#>   p : 16
#>   q : 17
#>   r : 18
#>   s : 19
#>   t : 20
#>   u : 21
#>   v : 22
#>   w : 23
#>   x : 24
#>   y : 25
#>   z : 26
  clear(h)  
  h # An object of type 'hash' containing 0 key-value pairs.
#> <hash> containing 0 key-value pair(s).
#>   NA : NULL