1 03/31/83  rehash_
 2 
 3 
 4 Entry points in rehash_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry: rehash_: 02/08/83 rehash_
 9 
10 
11 Function: (reformats into a different size) a hash table of the form
12 that is maintained by the hash_ subroutine.  In most cases, hash_
13 calls rehash_ automatically when a table becomes too full.  For hash
14 tables that are embedded in larger data bases, the data base
15 maintainer must monitor the density of the hash table and call rehash_
16 when necessary to maintain the optimal table size.  See the
17 description of the hash_ subroutine for more information.
18 
19 
20 Syntax:
21 declare rehash_ entry (ptr, fixed bin, fixed bin(35));
22 call rehash_ (table_ptr, size, code);
23 
24 
25 Arguments:
26 table_ptr
27    is a pointer to the table to be rehashed.  (Input)
28 size
29    is the new size of the hash table.  (Input).  See the description of
30    hash_$opt_size.
31 code
32    is a standard status code.  (Output).  It can be:
33    0
34       table rehashed successfully.
35    error_table_$invalid_elsize
36       size is too large.
37    error_table_$full_hashtbl
38       size is not large enough to hold all the entries in the current
39       hash table.