diff options
| -rw-r--r-- | hash.c | 6 | ||||
| -rw-r--r-- | include/ruby/internal/intern/hash.h | 11 |
2 files changed, 17 insertions, 0 deletions
@@ -1575,6 +1575,12 @@ rb_hash_new_with_size(st_index_t size) return ret; } +VALUE +rb_hash_new_capa(long capa) +{ + return rb_hash_new_with_size((st_index_t)capa); +} + static VALUE hash_copy(VALUE ret, VALUE hash) { diff --git a/include/ruby/internal/intern/hash.h b/include/ruby/internal/intern/hash.h index 3cce7f61c7..af8dfd5d8f 100644 --- a/include/ruby/internal/intern/hash.h +++ b/include/ruby/internal/intern/hash.h @@ -107,6 +107,17 @@ VALUE rb_hash(VALUE obj); VALUE rb_hash_new(void); /** + * Identical to rb_hash_new(), except it additionally specifies how many keys + * it is expected to contain. This way you can create a hash that is large enough + * for your need. For large hashes it means it won't need to be reallocated and + * rehashed as much, improving performance. + * + * @param[in] capa Designed capacity of the hash. + * @return An empty Hash, whose capacity is `capa`. + */ +VALUE rb_hash_new_capa(long capa); + +/** * Duplicates a hash. * * @param[in] hash An instance of ::rb_cHash. |