API reference / @evolu/common / Number / computeBalancedBuckets

Function: computeBalancedBuckets()

function computeBalancedBuckets(
  numberOfItems,
  numberOfBuckets,
  minNumberOfItemsPerBucket,
): Result<
  readonly [
    number & Brand<"Int"> & Brand<"NonNegative"> & Brand<"Positive">,
    number & Brand<"Int"> & Brand<"NonNegative"> & Brand<"Positive">,
  ],
  number & Brand<"Int"> & Brand<"NonNegative"> & Brand<"Positive">
>;

Defined in: packages/common/src/Number.ts:58

Divides items into buckets as evenly as possible, ensuring each bucket has at least the minimum number of items. Returns a success result if the minimum is met, or an error result with the required number of items if not.

Example

computeBalancedBuckets(10, 3, 2); // Returns ok([4, 7, 10])
computeBalancedBuckets(5, 3, 2); // Returns err(6)

Parameters

Returns

Result<readonly [number & Brand<"Int"> & Brand<"NonNegative"> & Brand<"Positive">, number & Brand<"Int"> & Brand<"NonNegative"> & Brand<"Positive">], number & Brand<"Int"> & Brand<"NonNegative"> & Brand<"Positive">>