Vely logo install
examples
documentation

Vely 15.2.0 released on Jan 18, 2023
Articles updated Jan 17, 2023

resize-hash


Issues with this documentation page? Report here.

Purpose:


Resize hash table.

Syntax:



resize-hash <hash> size <new size>


Description:


resize-hash will resize hash table <hash> (created by new-hash) to size <newsize>, which refers to the number of "buckets", or possible hash codes derived from keys stored.

When a number of keys stored grows, the search performance may decline if hash table size remains the same. Consequently, if the number of keys shrinks, the memory allocated by the hash table may be wasted. Use get-hash to obtain its current size, its length (the number of elements currently stored in it) and the statistics (such as average reads) to determine if you need to resize it.

Resizing is generally expensive, so it should not be done too often. The goal is to amortize this expense through future gain of lookup performance. For that reason it may be better to resize proportionally (i.e. by a percentage), unless you have a specific application reason to do otherwise, or to avoid exponential growth.

Examples:



resize-hash h size 100000


See also:


Hash table ( get-hash   new-hash   purge-hash   read-hash   resize-hash   write-hash  )  SEE ALL (documentation)



Copyright (c) 2022 DaSoftver LLC. Vely is a trademark of Dasoftver LLC. The software and information herein are provided "AS IS" and without any warranties or guarantees of any kind. Vely elephant logo (c) 2022 DaSoftver LLC. This web page is licensed under CC-BY-SA-4.0.