Divides a numerator Duration by a denominator Duration, returning the quotient and remainder. The remainder always has the same sign as the numerator. The returned quotient and remainder respect the identity:
Declared in <absl/time/time.h>
int64_t
IDivDuration(
Duration num,
Duration den,
Duration* rem);numerator = denominator * quotient + remainder
Returned quotients are capped to the range of int64_t, with the difference spilling into the remainder to uphold the above identity. This means that the remainder returned could differ from the remainder returned by Duration::operator% for huge quotients.
See also the notes on InfiniteDuration() below regarding the behavior of division involving zero and infinite durations.
Example:
constexpr absl::Duration a = absl::Seconds(std::numeric_limits<int64_t>::max()); // big constexpr absl::Duration b = absl::Nanoseconds(1); // small
absl::Duration rem = a % b; // rem == absl::ZeroDuration()
// Here, q would overflow int64_t, so rem accounts for the difference. int64_t q = absl::IDivDuration(a, b, &rem); // q == std::numeric_limits<int64_t>::max(), rem == a - b * q
The integer quotient of num divided by den.
| Name | Description |
|---|---|
| num | The numerator duration. |
| den | The denominator duration. |
| rem | Output parameter receiving the remainder. |