NAME

       get-hash -  (hash)

PURPOSE

       Get usage specifics for a hash.

SYNTAX

           get-hash  <hash > \
               ( length <length> ) \
               | ( hash-size <hash size> ) \
               | ( average-reads <reads> )

DESCRIPTION

       get-hash provides usage specifics of a <hash> (created by new-hash).

       Use "length" clause to obtain its <length> (i.e. the number of elements stored in it), "hash-size" clause
       to  obtain  its  <hash size> (i.e. the number of "buckets", or possible hash codes in the underlying hash
       table).

       "average-reads" clause will obtain in  <reads>  the  average  number  of  reads  (i.e.  how  many  string
       comparisons  are needed on average to find a key) multiplied by 100 (so if an average number of reads was
       1.5, it will be 150).

       This information may be useful in determining the performance of  a  hash,  and  whether  resize-hash  is
       indicated.

EXAMPLES

           get-hash h length l hash-size s average-reads r

SEE ALSO

        Hash

       get-hash new-hash purge-hash read-hash resize-hash write-hash See all documentation

$DATE                                               $VERSION                                           GOLF(2gg)