[time.traits] - C++14 → C++17

Files changed (1) hide show

tmp/tmp_il2ws3r/{from.md → to.md} +30 -23

tmp/tmp_il2ws3r/{from.md → to.md} RENAMED Viewed

@@ -7,19 +7,21 @@ template <class Rep> struct treat_as_floating_point
   : is_floating_point<Rep> { };
 ```
 The `duration` template uses the `treat_as_floating_point` trait to help
 determine if a `duration` object can be converted to another `duration`
-with a different tick `period`. If `treat_as_floating_point<Rep>::value`
-is true, then implicit conversions are allowed among `duration`s.
 Otherwise, the implicit convertibility depends on the tick `period`s of
-the `duration`s. The intention of this trait is to indicate whether a
-given class behaves like a floating-point type, and thus allows division
-of one value by another with acceptable loss of precision. If
-`treat_as_floating_point<Rep>::value` is `false`, `Rep` will be treated
-as if it behaved like an integral type for the purpose of these
-conversions.
 #### `duration_values` <a id="time.traits.duration_values">[[time.traits.duration_values]]</a>
 ``` cpp
 template <class Rep>
@@ -40,57 +42,62 @@ that case, the author of that class type should specialize
 ``` cpp
 static constexpr Rep zero();
 ```
-*Returns:* `Rep(0)`. `Rep(0)` is specified instead of `Rep()` because
-`Rep()` may have some other meaning, such as an uninitialized value.
-The value returned shall be the additive identity.
 ``` cpp
 static constexpr Rep min();
 ```
 *Returns:* `numeric_limits<Rep>::lowest()`.
-The value returned shall compare less than or equal to `zero()`.
 ``` cpp
 static constexpr Rep max();
 ```
 *Returns:* `numeric_limits<Rep>::max()`.
-The value returned shall compare greater than `zero()`.
 #### Specializations of `common_type` <a id="time.traits.specializations">[[time.traits.specializations]]</a>
 ``` cpp
 template <class Rep1, class Period1, class Rep2, class Period2>
 struct common_type<chrono::duration<Rep1, Period1>, chrono::duration<Rep2, Period2>> {
- typedef chrono::duration<common_type_t<Rep1, Rep2>, see below> type;
 };
 ```
 The `period` of the `duration` indicated by this specialization of
 `common_type` shall be the greatest common divisor of `Period1` and
-`Period2`. This can be computed by forming a ratio of the greatest
 common divisor of `Period1::num` and `Period2::num` and the least common
-multiple of `Period1::den` and `Period2::den`.
-The `typedef` name `type` is a synonym for the `duration` with the
-largest tick `period` possible where both `duration` arguments will
-convert to it without requiring a division operation. The representation
-of this type is intended to be able to hold any value resulting from
-this conversion with no truncation error, although floating-point
-durations may have round-off errors.
 ``` cpp
 template <class Clock, class Duration1, class Duration2>
 struct common_type<chrono::time_point<Clock, Duration1>, chrono::time_point<Clock, Duration2>> {
- typedef chrono::time_point<Clock, common_type_t<Duration1, Duration2>> type;
 };
 ```
 The common type of two `time_point` types is a `time_point` with the
 same clock as the two types and the common type of their two

   : is_floating_point<Rep> { };
 ```
 The `duration` template uses the `treat_as_floating_point` trait to help
 determine if a `duration` object can be converted to another `duration`
+with a different tick `period`. If `treat_as_floating_point_v<Rep>` is
+`true`, then implicit conversions are allowed among `duration`s.
 Otherwise, the implicit convertibility depends on the tick `period`s of
+the `duration`s.
+[*Note 1*: The intention of this trait is to indicate whether a given
+class behaves like a floating-point type, and thus allows division of
+one value by another with acceptable loss of precision. If
+`treat_as_floating_point_v<Rep>` is `false`, `Rep` will be treated as if
+it behaved like an integral type for the purpose of these
+conversions. — *end note*]
 #### `duration_values` <a id="time.traits.duration_values">[[time.traits.duration_values]]</a>
 ``` cpp
 template <class Rep>
 ``` cpp
 static constexpr Rep zero();
 ```
+*Returns:* `Rep(0)`.
+[*Note 1*: `Rep(0)` is specified instead of `Rep()` because `Rep()` may
+have some other meaning, such as an uninitialized value. — *end note*]
+*Remarks:* The value returned shall be the additive identity.
 ``` cpp
 static constexpr Rep min();
 ```
 *Returns:* `numeric_limits<Rep>::lowest()`.
+*Remarks:* The value returned shall compare less than or equal to
+`zero()`.
 ``` cpp
 static constexpr Rep max();
 ```
 *Returns:* `numeric_limits<Rep>::max()`.
+*Remarks:* The value returned shall compare greater than `zero()`.
 #### Specializations of `common_type` <a id="time.traits.specializations">[[time.traits.specializations]]</a>
 ``` cpp
 template <class Rep1, class Period1, class Rep2, class Period2>
 struct common_type<chrono::duration<Rep1, Period1>, chrono::duration<Rep2, Period2>> {
+ using type = chrono::duration<common_type_t<Rep1, Rep2>, see below>;
 };
 ```
 The `period` of the `duration` indicated by this specialization of
 `common_type` shall be the greatest common divisor of `Period1` and
+`Period2`.
+[*Note 1*: This can be computed by forming a ratio of the greatest
 common divisor of `Period1::num` and `Period2::num` and the least common
+multiple of `Period1::den` and `Period2::den`. — *end note*]
+[*Note 2*: The `typedef` name `type` is a synonym for the `duration`
+with the largest tick `period` possible where both `duration` arguments
+will convert to it without requiring a division operation. The
+representation of this type is intended to be able to hold any value
+resulting from this conversion with no truncation error, although
+floating-point durations may have round-off errors. — *end note*]
 ``` cpp
 template <class Clock, class Duration1, class Duration2>
 struct common_type<chrono::time_point<Clock, Duration1>, chrono::time_point<Clock, Duration2>> {
+ using type = chrono::time_point<Clock, common_type_t<Duration1, Duration2>>;
 };
 ```
 The common type of two `time_point` types is a `time_point` with the
 same clock as the two types and the common type of their two

Diff to HTML by rtfpessoa