Safe Haskell	Safe
Language	Haskell98

System.Clock

Description

High-resolution, realtime clock and timer functions for Posix

Synopsis

Documentation

data Clock Source #

Clock types. A clock may be system-wide (that is, visible to all processes) or per-process (measuring time that is meaningful only within a process). All implementations shall support CLOCK_REALTIME. (The only suspend-aware monotonic is CLOCK_BOOTTIME on Linux.)

Constructors

Monotonic	The identifier for the system-wide monotonic clock, which is defined as a clock measuring real time, whose value cannot be set via `clock_settime` and which cannot have negative clock jumps. The maximum possible clock jump shall be implementation defined. For this clock, the value returned by `getTime` represents the amount of time (in seconds and nanoseconds) since an unspecified point in the past (for example, system start-up time, or the Epoch). This point does not change after system start-up time. Note that the absolute value of the monotonic clock is meaningless (because its origin is arbitrary), and thus there is no need to set it. Furthermore, realtime applications can rely on the fact that the value of this clock is never set.
Realtime	The identifier of the system-wide clock measuring real time. For this clock, the value returned by `getTime` represents the amount of time (in seconds and nanoseconds) since the Epoch.
ProcessCPUTime	The identifier of the CPU-time clock associated with the calling process. For this clock, the value returned by `getTime` represents the amount of execution time of the current process.
ThreadCPUTime	The identifier of the CPU-time clock associated with the calling OS thread. For this clock, the value returned by `getTime` represents the amount of execution time of the current OS thread.

Instances

Enum Clock Source #
Methods succ :: Clock -> Clock # pred :: Clock -> Clock # toEnum :: Int -> Clock # fromEnum :: Clock -> Int # enumFrom :: Clock -> [Clock] # enumFromThen :: Clock -> Clock -> [Clock] # enumFromTo :: Clock -> Clock -> [Clock] # enumFromThenTo :: Clock -> Clock -> Clock -> [Clock] #
Eq Clock Source #
Methods (==) :: Clock -> Clock -> Bool # (/=) :: Clock -> Clock -> Bool #
Read Clock Source #
Methods readsPrec :: Int -> ReadS Clock # readList :: ReadS [Clock] # readPrec :: ReadPrec Clock # readListPrec :: ReadPrec [Clock] #
Show Clock Source #
Methods showsPrec :: Int -> Clock -> ShowS # show :: Clock -> String # showList :: [Clock] -> ShowS #
Generic Clock Source #
Associated Types type Rep Clock :: * -> * # Methods from :: Clock -> Rep Clock x # to :: Rep Clock x -> Clock #
type Rep Clock Source #
type Rep Clock = D1 (MetaData "Clock" "System.Clock" "clock-0.7.2-1F3tpzhSilhF4wqwyRWqgE" False) ((:+:) ((:+:) (C1 (MetaCons "Monotonic" PrefixI False) U1) (C1 (MetaCons "Realtime" PrefixI False) U1)) ((:+:) (C1 (MetaCons "ProcessCPUTime" PrefixI False) U1) (C1 (MetaCons "ThreadCPUTime" PrefixI False) U1)))

data TimeSpec Source #

TimeSpec structure

Constructors

TimeSpec
Fields sec :: !Int64 seconds nsec :: !Int64 nanoseconds

Instances

Eq TimeSpec Source #
Methods (==) :: TimeSpec -> TimeSpec -> Bool # (/=) :: TimeSpec -> TimeSpec -> Bool #
Num TimeSpec Source #
Methods (+) :: TimeSpec -> TimeSpec -> TimeSpec # (-) :: TimeSpec -> TimeSpec -> TimeSpec # (*) :: TimeSpec -> TimeSpec -> TimeSpec # negate :: TimeSpec -> TimeSpec # abs :: TimeSpec -> TimeSpec # signum :: TimeSpec -> TimeSpec # fromInteger :: Integer -> TimeSpec #
Ord TimeSpec Source #
Methods compare :: TimeSpec -> TimeSpec -> Ordering # (<) :: TimeSpec -> TimeSpec -> Bool # (<=) :: TimeSpec -> TimeSpec -> Bool # (>) :: TimeSpec -> TimeSpec -> Bool # (>=) :: TimeSpec -> TimeSpec -> Bool # max :: TimeSpec -> TimeSpec -> TimeSpec # min :: TimeSpec -> TimeSpec -> TimeSpec #
Read TimeSpec Source #
Methods readsPrec :: Int -> ReadS TimeSpec # readList :: ReadS [TimeSpec] # readPrec :: ReadPrec TimeSpec # readListPrec :: ReadPrec [TimeSpec] #
Show TimeSpec Source #
Methods showsPrec :: Int -> TimeSpec -> ShowS # show :: TimeSpec -> String # showList :: [TimeSpec] -> ShowS #
Generic TimeSpec Source #
Associated Types type Rep TimeSpec :: * -> * # Methods from :: TimeSpec -> Rep TimeSpec x # to :: Rep TimeSpec x -> TimeSpec #
Storable TimeSpec Source #
Methods sizeOf :: TimeSpec -> Int # alignment :: TimeSpec -> Int # peekElemOff :: Ptr TimeSpec -> Int -> IO TimeSpec # pokeElemOff :: Ptr TimeSpec -> Int -> TimeSpec -> IO () # peekByteOff :: Ptr b -> Int -> IO TimeSpec # pokeByteOff :: Ptr b -> Int -> TimeSpec -> IO () # peek :: Ptr TimeSpec -> IO TimeSpec # poke :: Ptr TimeSpec -> TimeSpec -> IO () #
type Rep TimeSpec Source #
type Rep TimeSpec = D1 (MetaData "TimeSpec" "System.Clock" "clock-0.7.2-1F3tpzhSilhF4wqwyRWqgE" False) (C1 (MetaCons "TimeSpec" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "sec") SourceUnpack SourceStrict DecidedUnpack) (Rec0 Int64)) (S1 (MetaSel (Just Symbol "nsec") SourceUnpack SourceStrict DecidedUnpack) (Rec0 Int64))))

getTime :: Clock -> IO TimeSpec Source #

The getTime function shall return the current value for the specified clock.

getRes :: Clock -> IO TimeSpec Source #

The getRes function shall return the resolution of any clock. Clock resolutions are implementation-defined and cannot be set by a process.

fromNanoSecs :: Integer -> TimeSpec Source #

TimeSpec from nano seconds.

toNanoSecs :: TimeSpec -> Integer Source #

TimeSpec to nano seconds.

diffTimeSpec :: TimeSpec -> TimeSpec -> TimeSpec Source #

Compute the absolute difference.

timeSpecAsNanoSecs :: TimeSpec -> Integer Source #

Deprecated: Use toNanoSecs instead! Replaced timeSpecAsNanoSecs with the same signature TimeSpec -> Integer

TimeSpec as nano seconds.