Add a caveat to hash_seq_init_with_hash_value() header comment

The typical use-case for hash_seq_init_with_hash_value() is syscache
callback.  Add a caveat that the default hash function doesn't match syscache
hash function.  So, one needs to define a custom hash function.

Reported-by: Pavel Stehule
Discussion: https://postgr.es/m/CAFj8pRAXmv6eyYx%3DE_BTfyK%3DO_%2ByOF8sXB%3D0bn9eOBt90EgWRA%40mail.gmail.com
Reviewed-by: Pavel Stehule
pull/174/head
Alexander Korotkov 1 year ago
parent 49dc191bd1
commit d0c8cf2a56
  1. 5
      src/backend/utils/hash/dynahash.c

@ -1395,6 +1395,11 @@ hash_seq_init(HASH_SEQ_STATUS *status, HTAB *hashp)
/*
* Same as above but scan by the given hash value.
* See also hash_seq_search().
*
* NOTE: the default hash function doesn't match syscache hash function.
* Thus, if you're going to use this function in syscache callback, make sure
* you're using custom hash function. See relatt_cache_syshash()
* for example.
*/
void
hash_seq_init_with_hash_value(HASH_SEQ_STATUS *status, HTAB *hashp,

Loading…
Cancel
Save