* scheme-data.texi (Hash Tables): Added docs for
authorMartin Grabmüller <mgrabmue@cs.tu-berlin.de>
Sat, 30 Jun 2001 06:58:04 +0000 (06:58 +0000)
committerMartin Grabmüller <mgrabmue@cs.tu-berlin.de>
Sat, 30 Jun 2001 06:58:04 +0000 (06:58 +0000)
`make-hash-table'.

doc/ChangeLog
doc/scheme-data.texi

index 2b8933f..a3ff0d3 100644 (file)
@@ -1,3 +1,8 @@
+2001-06-30  Martin Grabmueller  <mgrabmue@cs.tu-berlin.de>
+
+       * scheme-data.texi (Hash Tables): Added docs for
+       `make-hash-table'.
+
 2001-06-29  Martin Grabmueller  <mgrabmue@cs.tu-berlin.de>
 
        * misc-modules.texi: New file.
index 46bfb28..0aaf527 100755 (executable)
@@ -4331,8 +4331,8 @@ useful for organizing and indexing large bodies of information.
 
 @menu
 * Dictionary Types::            About dictionary types; what they're good for.
-* Association Lists::           
-* Hash Tables::                 
+* Association Lists::           List-based dictionaries.
+* Hash Tables::                 Table-based dictionaries.
 @end menu
 
 @node Dictionary Types
@@ -4794,6 +4794,15 @@ In each of the functions that follow, the @var{table} argument
 must be a vector.  The @var{key} and @var{value} arguments may be
 any Scheme object.
 
+@deffn procedure make-hash-table size
+Create a new hash table of @var{size} slots.  Note that the number of
+slots does not limit the size of the table, it just tells how large
+the underlying vector will be.  The @var{size} should be similar to
+the expected number of elements which will be added to the table, but
+they need not match.  For good performance, it might be a good idea to
+use a prime number as the @var{size}.
+@end deffn
+
 @deffn primitive hashq-ref table key [dflt]
 Look up @var{key} in the hash table @var{table}, and return the
 value (if any) associated with it.  If @var{key} is not found,