NAME

DiaColloDB::Timer - diachronic collocation db, timer

SYNOPSIS

##========================================================================
## PRELIMINARIES

use DiaColloDB::Timer;

##========================================================================
## Constructors etc.

$timer = $CLASS_OR_OBJECT->new(%args);

##========================================================================
## Timing

$timer = $CLASS_OR_OBJECT->start();
$timer = $timer->stop();
$timer = $timer->reset();
$elapsed = $timer->elapsed();
$hms     = $timer->hms($sfmt?);
$timestr = $timer->timestr($sfmt?);

DESCRIPTION

DiaColloDB::Timer provides a simple object-oriented high resolution timer used e.g. for measuring query processing time in the command-line utilities.

Constructors etc.

new

$timer = CLASS_OR_OBJECT->new(%args);

%args, object structure:

started => $t0,      ##-- time last operation started
elapsed => $elapsed, ##-- elapsed time (after stop())

Timing

start

$timer = CLASS_OR_OBJECT->start();

(re-)starts timer

stop

$timer = $timer->stop();

stops timer and adds current interval to {elapsed}

reset

$timer = $timer->reset();

stops and re-sets timer

elapsed

$elapsed = $timer->elapsed();

get total elapsed time for this timer

hms

$hms = $timer->hms($sfmt?);
($h,$m,$s) = $timer->hms($sfmt?);

parses and optionally formats elapsed time as HH:MM:SS.SSS

timestr

$timestr = $timer->timestr($sfmt?);

parses and formats elapsed time as Hh?Mm?Ss

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2015-2020 by Bryan Jurish

This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.

SEE ALSO

DiaColloDB(3pm), perl(1), ...