e0a524b5e0
0 is natural default value for types that can be accumulated Having default constructor simplify usage of these types in templated code. Bug: None Change-Id: If005c69018a2a11011bc789502fdbc600cad3278 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/369440 Reviewed-by: Per Kjellander <perkj@webrtc.org> Commit-Queue: Danil Chapovalov <danilchap@webrtc.org> Commit-Queue: Per Kjellander <perkj@webrtc.org> Reviewed-by: Mirko Bonadei <mbonadei@webrtc.org> Cr-Commit-Position: refs/heads/main@{#43460}
106 lines
3.1 KiB
C++
106 lines
3.1 KiB
C++
/*
|
|
* Copyright (c) 2018 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef API_UNITS_TIME_DELTA_H_
|
|
#define API_UNITS_TIME_DELTA_H_
|
|
|
|
#include <cstdint>
|
|
#include <cstdlib>
|
|
#include <string>
|
|
#include <type_traits>
|
|
|
|
#include "rtc_base/system/rtc_export.h"
|
|
#include "rtc_base/units/unit_base.h" // IWYU pragma: export
|
|
|
|
namespace webrtc {
|
|
|
|
// TimeDelta represents the difference between two timestamps. Commonly this can
|
|
// be a duration. However since two Timestamps are not guaranteed to have the
|
|
// same epoch (they might come from different computers, making exact
|
|
// synchronisation infeasible), the duration covered by a TimeDelta can be
|
|
// undefined. To simplify usage, it can be constructed and converted to
|
|
// different units, specifically seconds (s), milliseconds (ms) and
|
|
// microseconds (us).
|
|
class TimeDelta final : public rtc_units_impl::RelativeUnit<TimeDelta> {
|
|
public:
|
|
template <typename T>
|
|
static constexpr TimeDelta Minutes(T value) {
|
|
static_assert(std::is_arithmetic<T>::value, "");
|
|
return Seconds(value * 60);
|
|
}
|
|
template <typename T>
|
|
static constexpr TimeDelta Seconds(T value) {
|
|
static_assert(std::is_arithmetic<T>::value, "");
|
|
return FromFraction(1'000'000, value);
|
|
}
|
|
template <typename T>
|
|
static constexpr TimeDelta Millis(T value) {
|
|
static_assert(std::is_arithmetic<T>::value, "");
|
|
return FromFraction(1'000, value);
|
|
}
|
|
template <typename T>
|
|
static constexpr TimeDelta Micros(T value) {
|
|
static_assert(std::is_arithmetic<T>::value, "");
|
|
return FromValue(value);
|
|
}
|
|
|
|
constexpr TimeDelta() = default;
|
|
|
|
template <typename Sink>
|
|
friend void AbslStringify(Sink& sink, TimeDelta value);
|
|
|
|
template <typename T = int64_t>
|
|
constexpr T seconds() const {
|
|
return ToFraction<1000000, T>();
|
|
}
|
|
template <typename T = int64_t>
|
|
constexpr T ms() const {
|
|
return ToFraction<1000, T>();
|
|
}
|
|
template <typename T = int64_t>
|
|
constexpr T us() const {
|
|
return ToValue<T>();
|
|
}
|
|
template <typename T = int64_t>
|
|
constexpr T ns() const {
|
|
return ToMultiple<1000, T>();
|
|
}
|
|
|
|
constexpr int64_t seconds_or(int64_t fallback_value) const {
|
|
return ToFractionOr<1000000>(fallback_value);
|
|
}
|
|
constexpr int64_t ms_or(int64_t fallback_value) const {
|
|
return ToFractionOr<1000>(fallback_value);
|
|
}
|
|
constexpr int64_t us_or(int64_t fallback_value) const {
|
|
return ToValueOr(fallback_value);
|
|
}
|
|
|
|
constexpr TimeDelta Abs() const {
|
|
return us() < 0 ? TimeDelta::Micros(-us()) : *this;
|
|
}
|
|
|
|
private:
|
|
friend class rtc_units_impl::UnitBase<TimeDelta>;
|
|
using RelativeUnit::RelativeUnit;
|
|
static constexpr bool one_sided = false;
|
|
};
|
|
|
|
RTC_EXPORT std::string ToString(TimeDelta value);
|
|
|
|
template <typename Sink>
|
|
void AbslStringify(Sink& sink, TimeDelta value) {
|
|
sink.Append(ToString(value));
|
|
}
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // API_UNITS_TIME_DELTA_H_
|