Audio::MPD::Common::Time - class representing time of current song



NAME

Audio::MPD::Common::Time - class representing time of current song


VERSION

version 1.100430


DESCRIPTION

the Audio::MPD::Common::Status manpage returns some time information with the time() accessor. This information relates to the elapsed time of the current song, as well as the remaining and total time. This information is encapsulated in an the Audio::MPD::Common::Time manpage object.

An the Audio::MPD::Common::Time manpage object does not update itself regularly, and thus should be used immediately.

Note: one should never ever instantiate an the Audio::MPD::Common::Time manpage object directly - use the mpd modules instead.


ATTRIBUTES

$time->time;

The time passed to the constructor, used to compute all others values (see methods). It is the time value (on the "time" line) of what the MPD server returns to the status command. Defaults to 0:0.


METHODS

my $str = $time->sofar;

Return elapsed $time (minutes:seconds format).

my $str = $time->left;

Return remaining $time (minutes:seconds format).

my $str = $time->left;

Return total $time (minutes:seconds format).

my $percent = $time->percent;

Return elapsed $time (percentage, 1 digit).

my $secs = $time->seconds_sofar;

Return elapsed $time in seconds.

my $secs = $time->seconds_left;

Return remaining $time in seconds.

my $secs = $time->seconds_total;

Return total $time in seconds.

my $mins = $time->sofar_mins;

Return minutes part of elapsed $time.

my $secs = $time->sofar_secs;

Return seconds part of elapsed $time.

my $mins = $time->left_mins;

Return minutes part of remaining $time.

my $secs = $time->left_secs;

Return seconds part of remaining $time.

my $mins = $time->total_mins;

Return minutes part of total $time.

my $mins = $time->total_secs;

Return seconds part of total $time.


AUTHOR

  Jerome Quelin


COPYRIGHT AND LICENSE

This software is copyright (c) 2007 by Jerome Quelin.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

 Audio::MPD::Common::Time - class representing time of current song