1 :Info: hash_table: ht:  2020-05-14  hash_table, ht
  2 
  3 Syntax as a command:  ht PATH {NB}
  4 
  5 
  6 Function: creates, modifies, or searches a hash table.  Enters an
  7 interactive request level to insert, delete, and search for entries
  8 in the table.  The hash_ subroutine manages the table.
  9 
 10 
 11 Arguments:
 12 PATH
 13    specifies the pathname of a segment, which is a new or existing
 14    hash table.
 15 NB
 16    is the (optional) number of buckets with which the hash table is to
 17    be created.  If you don't give nb or if it is out of range (0 < nb
 18    <= 6552), then a default is assigned to it.
 19 
 20 
 21 List of requests:
 22    The command operates in response to the following requests.  Each
 23    request name must be the first non-blank character of the line and
 24    followed by one or more arguments separated by any number of
 25    blanks.  A blank before the first argument is optional.  For help
 26    on any request, from command level type: help ht -info REQUEST_NAME
 27 
 28 a NAME1 VALUE1 ... NAMEn VALUEn
 29    add hash table entries.
 30 d NAMEs
 31    delete hash table entries.
 32 q
 33    quit the hash_table subsystem.
 34 s NAMEs
 35    search for hash table entries.
 36 
 37 
 38 Notes: If the hash table ever becomes full or inefficient, the number
 39 of buckets is doubled or assigned the maximum, the hash table is
 40 rehashed, and a message is printed.
 41 
 42 
 43 :[Info]: a:  2020-05-14  a
 44 
 45 
 46 Syntax:  a NAME1 VALUE1...NAMEn VALUEn
 47 
 48 
 49 Function: inserts an entry into the hash table for NAMEi and its
 50 corresponding VALUEi.
 51 
 52 
 53 Arguments:
 54 NAMEi
 55    is a character string less than, or equal to, 32 characters.
 56 VALUEi
 57    is a decimal number you associate with namei to indicate its
 58    location in the corresponding data table.  It can be array
 59    subscript.
 60 
 61 
 62 :[Info]: d:  2020-05-14  d
 63 
 64 
 65 Syntax:  d NAMEs
 66 
 67 
 68 Function: deletes the entry NAME from the hash table and prints the
 69 value it was associated with.
 70 
 71 
 72 Arguments:
 73 NAME
 74    is a character string less than, or equal to, 32 characters.
 75 
 76 
 77 :[Info]: q:  2020-05-14  q
 78 
 79 
 80 Syntax:  q
 81 
 82 
 83 Function: exits the hash_table subsystem.
 84 
 85 
 86 :[Info]: s:  2020-05-14  s
 87 
 88 
 89 Syntax:  s NAMEs
 90 
 91 
 92 Function: searches the hash table for NAME and prints its
 93 corresponding value.  You can then locate NAME in your data table by
 94 using the given value.
 95 
 96 
 97 Arguments:
 98 NAME
 99    is a character string less than, or equal to, 32 characters.
100 
101 
102 :hcom:
103 
104 
105 
106 /****^  HISTORY COMMENTS:
107   1) change(2020-05-14,GDixon), approve(2021-02-22,MCR10088),
108      audit(2021-05-27,Swenson), install(2021-05-27,MR12.6g-0056):
109       A) Restructure info segment as a command invoking a small subsystem
110          accepting four requests.
111       B) Since existing hash_table.pl1 code does not support its own help
112          request, and does not implement a .. COMMAND_LINE escape in its
113          request line processing, document method for displaying info block
114          for each request as a Multics command:  help ht -info REQUEST_NAME
115                                                    END HISTORY COMMENTS */
116 
117 
118