+
Point of view
All features
expanded class MICROSECOND_TIME
Summary
Date and time facilities (like TIME) plus an extra microsecond information.
Direct parents
Insert list: COMPARABLE, HASHABLE, TIME_HANDLER
Class invariant
Overview
Features
{ANY}
{ANY}
{}
{ANY}
  • infix "<=" (other: MICROSECOND_TIME): BOOLEAN
    Is Current less than or equal other?
  • infix ">" (other: MICROSECOND_TIME): BOOLEAN
    Is Current strictly greater than other?
  • infix ">=" (other: MICROSECOND_TIME): BOOLEAN
    Is Current greater than or equal than other?
  • in_range (lower: MICROSECOND_TIME, upper: MICROSECOND_TIME): BOOLEAN
    Return True if Current is in range [lower..upper]
    See also min, max, compare.
  • compare (other: MICROSECOND_TIME): INTEGER_32
    If current object equal to other, 0 if smaller, -1; if greater, 1.
  • three_way_comparison (other: MICROSECOND_TIME): INTEGER_32
    If current object equal to other, 0 if smaller, -1; if greater, 1.
  • min (other: MICROSECOND_TIME): MICROSECOND_TIME
    Minimum of Current and other.
  • max (other: MICROSECOND_TIME): MICROSECOND_TIME
    Maximum of Current and other.
  • bounded_by (a_min: MICROSECOND_TIME, a_max: MICROSECOND_TIME): MICROSECOND_TIME
    A value that is equal to Current if it is between the limits set by a_min and a_max.
time: TIME
writable attribute
{ANY}
The normal TIME with second accuracy.
microsecond: INTEGER_32
writable attribute
{ANY}
Extra information in number of microseconds in range 0 ..
999999. Note that the accuracy is system dependant.
update
effective procedure
{ANY}
Update Current with the current system clock.
set_time (t: TIME)
effective procedure
{ANY}
ensure
set_microsecond (microsec: INTEGER_32)
effective procedure
{ANY}
To set microsecond in range 0 ..
999 999.
require
  • microsec.in_range(0, 999999)
ensure
infix "+" (s: REAL_64): MICROSECOND_TIME
effective function
{ANY}
Add s seconds (2.476 is 2 seconds and 476 milliseconds)
require
  • s >= 0.0
add_second (s: INTEGER_32)
effective procedure
{ANY}
Add s seconds to Current.
require
  • s >= 0
ensure
  • Current >= old Current
add_millisecond (millisecond: INTEGER_32)
effective procedure
{ANY}
Add millisecond milliseconds.
require
  • millisecond.in_range(0, 999)
ensure
  • Current >= old Current
add_microsecond (microsec: INTEGER_32)
effective procedure
{ANY}
Add microsec microseconds
require
  • microsec.in_range(0, 999999)
ensure
  • Current >= old Current
elapsed_seconds (other: MICROSECOND_TIME): REAL_64
effective function
{ANY}
Elapsed time in seconds from Current to other with sub-second precision.
is_equal (other: MICROSECOND_TIME): BOOLEAN
effective function
{ANY}
Is other attached to an object considered equal to current object?
require
    • other /= Void
    • other /= Void
ensure
  • Result implies hash_code = other.hash_code
  • commutative: generating_type = other.generating_type implies Result = other.is_equal(Current)
  • trichotomy: Result = not Current < other and not other < Current
infix "<" (other: MICROSECOND_TIME): BOOLEAN
effective function
{ANY}
Is Current strictly less than other?
See also >, <=, >=, min, max.
require
  • other_exists: other /= Void
ensure
  • Result implies elapsed_seconds(other) > 0
  • asymmetric: Result implies not other < Current
hash_code: INTEGER_32
effective function
{ANY}
The hash-code value of Current.
ensure
  • good_hash_value: Result >= 0
out: STRING
effective function
{ANY}
Create a new string containing terse printable representation of current object.
timestamp: INTEGER_64
effective function
{ANY}
basic_microsecond_time: INTEGER_64
{}
basic_microsecond_microsecond: INTEGER_32
{}
basic_microsecond_update
{}
infix "<=" (other: MICROSECOND_TIME): BOOLEAN
effective function
{ANY}
Is Current less than or equal other?
See also >=, <, >, min, max.
require
  • other_exists: other /= Void
ensure
  • definition: Result = Current < other or is_equal(other)
infix ">" (other: MICROSECOND_TIME): BOOLEAN
effective function
{ANY}
Is Current strictly greater than other?
See also <, >=, <=, min, max.
require
  • other_exists: other /= Void
ensure
  • definition: Result = other < Current
infix ">=" (other: MICROSECOND_TIME): BOOLEAN
effective function
{ANY}
Is Current greater than or equal than other?
See also <=, >, <, min, max.
require
  • other_exists: other /= Void
ensure
  • definition: Result = other <= Current
in_range (lower: MICROSECOND_TIME, upper: MICROSECOND_TIME): BOOLEAN
effective function
{ANY}
Return True if Current is in range [lower..upper]
See also min, max, compare.
ensure
  • Result = Current >= lower and Current <= upper
compare (other: MICROSECOND_TIME): INTEGER_32
effective function
{ANY}
If current object equal to other, 0 if smaller, -1; if greater, 1.
See also min, max, in_range.
require
  • other_exists: other /= Void
ensure
  • equal_zero: Result = 0 = is_equal(other)
  • smaller_negative: Result = -1 = Current < other
  • greater_positive: Result = 1 = Current > other
three_way_comparison (other: MICROSECOND_TIME): INTEGER_32
effective function
{ANY}
If current object equal to other, 0 if smaller, -1; if greater, 1.
See also min, max, in_range.
require
  • other_exists: other /= Void
ensure
  • equal_zero: Result = 0 = is_equal(other)
  • smaller_negative: Result = -1 = Current < other
  • greater_positive: Result = 1 = Current > other
min (other: MICROSECOND_TIME): MICROSECOND_TIME
effective function
{ANY}
Minimum of Current and other.
See also max, in_range.
require
  • other /= Void
ensure
  • Result <= Current and then Result <= other
  • compare(Result) = 0 or else other.compare(Result) = 0
max (other: MICROSECOND_TIME): MICROSECOND_TIME
effective function
{ANY}
Maximum of Current and other.
See also min, in_range.
require
  • other /= Void
ensure
  • Result >= Current and then Result >= other
  • compare(Result) = 0 or else other.compare(Result) = 0
bounded_by (a_min: MICROSECOND_TIME, a_max: MICROSECOND_TIME): MICROSECOND_TIME
effective function
{ANY}
A value that is equal to Current if it is between the limits set by a_min and a_max.
Otherwise it's a_min if Current is smaller or a_max if Current is greater It's a shortcut for Current.min(a_max).max(a_min) also known as "clamp" in the widespread C library Glib
ensure
  • correctness: Result.in_range(a_min, a_max)