Specs

append_bucket(
  set :: Discord.SortedSet.t(),
  terms :: [Discord.SortedSet.Types.supported_term()]
) ::
  :ok
  | Discord.SortedSet.Types.nif_append_bucket_result()
  | Discord.SortedSet.Types.common_errors()

Appends a buckets worth of sorted terms to the SortedSet

This is mostly an internal implementation detail, it is used to implement the Discord.SortedSet.from_enumerable/2 and Discord.SortedSet.from_proper_enumerable/2 functions. The NIF will append a buckets worth of items without performing any checks on them. This is a very efficient way to build the SortedSet but care must be taken since the call circumvents the sorting and sanity checking logic. Use the constructors in Discord.ßSortedSet for a safer and more ergonomic experience, use great care when calling this function directly.