libzypp
10.5.0
|
Maintain [min,max]
and counter (value)
for progress counting.
More...
#include <ProgressData.h>
Classes | |
class | Data |
Public Types | |
typedef long long | value_type |
typedef function< bool(const ProgressData &)> | ReceiverFnc |
Most simple version of progress reporting The percentage in most cases. | |
Public Member Functions | |
ProgressData () | |
Ctor no range [0,0](0) . | |
ProgressData (value_type max_r) | |
Ctor [0,max](0) . | |
ProgressData (value_type min_r, value_type max_r) | |
Ctor [min,max](min) . | |
ProgressData (value_type min_r, value_type max_r, value_type val_r) | |
Ctor [min,max](val) . | |
~ProgressData () | |
void | min (value_type min_r) |
Set new min value. | |
void | max (value_type max_r) |
Set new max value. | |
void | noRange () |
Set no range [0,0] . | |
void | range (value_type max_r) |
Set new [0,max] . | |
void | range (value_type min_r, value_type max_r) |
Set new [min,max] . | |
void | name (const std::string &name_r) |
Set counter name. | |
void | sendTo (const ReceiverFnc &fnc_r) |
Set ReceiverFnc. | |
void | noSend () |
Set no ReceiverFnc. | |
Progress reporting. | |
These methods may actually cause a progress report to be sent. All methods return | |
bool | set (value_type val_r) |
Set new counter value . | |
bool | incr (value_type val_r=1) |
Increment counter value (default by 1). | |
bool | decr (value_type val_r=1) |
Decrement counter value (default by 1). | |
bool | toMin () |
Set counter value to current min value. | |
bool | toMax () |
Set counter value to current max value (unless no range). | |
bool | tick () |
Leave counter value unchanged (still alive). | |
Progress receiving. | |
value_type | min () const |
value_type | max () const |
value_type | val () const |
bool | hasRange () const |
bool | reportPercent () const |
bool | reportAlive () const |
value_type | reportValue () const |
const std::string & | name () const |
const ReceiverFnc & | receiver () const |
bool | finalReport () const |
Private Types | |
enum | State { INIT, RUN, END } |
Private Member Functions | |
bool | report () |
Send report if necessary. | |
Private Attributes | |
RWCOW_pointer< Data > | _d |
Pointer to data. | |
Related Functions | |
(Note that these are not member functions.) | |
std::ostream & | operator<< (std::ostream &str, const ProgressData &obj) |
ProgressData | makeProgressData (const InputStream &input_r) |
Maintain [min,max]
and counter (value)
for progress counting.
This class should provide everything the producer of progress data needs. As a convention, a zero sizes range indicates that you are just able to send 'still alive' triggers.
The counter should be updated in reasonable intervals. Don't mind wheter the counter value actually increased or not. ProgressData will recognize your triggers and knows when to actually send notification to a consumer.
Each ProgressData object provides a unique numeric id and you may assign it a name.
bool exampleReceiver( ProgressData::value_type v ) { DBG << "got ->" << v << endl; return( v <= 100 ); // Abort if ( v > 100 ) } class Example { public: Example( const ProgressData::ReceiverFnc & fnc_r = ProgressData::ReceiverFnc() ) : _fnc( fnc_r ) {} void SendTo( const ProgressData::ReceiverFnc & fnc_r ) { _fnc = fnc_r; } public: void action() { ProgressData tics( 10 ); // Expect range 0 -> 10 tics.name( "test ticks" ); // Some arbitrary name tics.sendTo( _fnc ); // Send reports to _fnc tics.toMin(); // start sending min (0) for ( int i = 0; i < 10; ++i ) { if ( ! tics.set( i ) ) return; // user requested abort } tics.toMax(); // take care 100% are reported on success } void action2() { ProgressData tics; // Just send 'still alive' messages tics.name( "test ticks" ); // Some arbitrary name tics.sendTo( _fnc ); // Send reports to _fnc tics.toMin(); // start sending min (0) for ( int i = 0; i < 10; ++i ) { if ( ! tics.set( i ) ) return; // user requested abort } tics.toMax(); // } private: ProgressData::ReceiverFnc _fnc; };
Example t( exampleReceiver ); DBG << "Reporting %:" << endl; t.action(); DBG << "Reporting 'still alive':" << endl; t.action2();
Reporting %:
got ->0
got ->10
got ->20
got ->30
got ->40
got ->50
got ->60
got ->70
got ->80
got ->90
got ->100
got ->100
Reporting 'still alive':
got ->0
got ->9
The different ammount of triggers is due to different rules for sending percent or 'still alive' messages.
Complete the progess sending.
Tell recipient whether percentage or keepalive is sent, the id and name might be helpfull, and maybe tell whether task is abortable or not; i.e extend the ReceiverFnc signature.
Definition at line 135 of file ProgressData.h.
typedef long long zypp::ProgressData::value_type |
Definition at line 138 of file ProgressData.h.
typedef function<bool( const ProgressData & )> zypp::ProgressData::ReceiverFnc |
Most simple version of progress reporting The percentage in most cases.
Sometimes just keepalive. sender
ProgressData object who sends the progress info
Definition at line 144 of file ProgressData.h.
enum zypp::ProgressData::State [private] |
Definition at line 147 of file ProgressData.h.
zypp::ProgressData::ProgressData | ( | ) | [inline] |
Ctor no range [0,0](0)
.
Definition at line 176 of file ProgressData.h.
zypp::ProgressData::ProgressData | ( | value_type | max_r | ) | [inline] |
Ctor [0,max](0)
.
Definition at line 181 of file ProgressData.h.
zypp::ProgressData::ProgressData | ( | value_type | min_r, |
value_type | max_r | ||
) | [inline] |
Ctor [min,max](min)
.
Definition at line 186 of file ProgressData.h.
zypp::ProgressData::ProgressData | ( | value_type | min_r, |
value_type | max_r, | ||
value_type | val_r | ||
) | [inline] |
Ctor [min,max](val)
.
Definition at line 191 of file ProgressData.h.
zypp::ProgressData::~ProgressData | ( | ) | [inline] |
Definition at line 195 of file ProgressData.h.
void zypp::ProgressData::min | ( | value_type | min_r | ) | [inline] |
Set new min
value.
Definition at line 206 of file ProgressData.h.
void zypp::ProgressData::max | ( | value_type | max_r | ) | [inline] |
Set new max
value.
Definition at line 210 of file ProgressData.h.
void zypp::ProgressData::noRange | ( | ) | [inline] |
Set no range [0,0]
.
Definition at line 214 of file ProgressData.h.
void zypp::ProgressData::range | ( | value_type | max_r | ) | [inline] |
Set new [0,max]
.
Definition at line 218 of file ProgressData.h.
void zypp::ProgressData::range | ( | value_type | min_r, |
value_type | max_r | ||
) | [inline] |
Set new [min,max]
.
Definition at line 222 of file ProgressData.h.
void zypp::ProgressData::name | ( | const std::string & | name_r | ) | [inline] |
Set counter name.
Definition at line 227 of file ProgressData.h.
void zypp::ProgressData::sendTo | ( | const ReceiverFnc & | fnc_r | ) | [inline] |
Set ReceiverFnc.
Definition at line 231 of file ProgressData.h.
void zypp::ProgressData::noSend | ( | ) | [inline] |
Set no ReceiverFnc.
Definition at line 235 of file ProgressData.h.
bool zypp::ProgressData::set | ( | value_type | val_r | ) | [inline] |
Set new counter value
.
Definition at line 251 of file ProgressData.h.
bool zypp::ProgressData::incr | ( | value_type | val_r = 1 | ) | [inline] |
Increment counter value
(default by 1).
Definition at line 258 of file ProgressData.h.
bool zypp::ProgressData::decr | ( | value_type | val_r = 1 | ) | [inline] |
Decrement counter value
(default by 1).
Definition at line 262 of file ProgressData.h.
bool zypp::ProgressData::toMin | ( | ) | [inline] |
Set counter value to current min
value.
Definition at line 266 of file ProgressData.h.
bool zypp::ProgressData::toMax | ( | ) | [inline] |
Set counter value to current max
value (unless no range).
Definition at line 270 of file ProgressData.h.
bool zypp::ProgressData::tick | ( | ) | [inline] |
Leave counter value unchanged (still alive).
Definition at line 274 of file ProgressData.h.
value_type zypp::ProgressData::min | ( | ) | const [inline] |
min
value. Definition at line 284 of file ProgressData.h.
value_type zypp::ProgressData::max | ( | ) | const [inline] |
max
value. Definition at line 288 of file ProgressData.h.
value_type zypp::ProgressData::val | ( | ) | const [inline] |
value
. Definition at line 292 of file ProgressData.h.
bool zypp::ProgressData::hasRange | ( | ) | const [inline] |
[min,max]
defines a nonempty range. Definition at line 296 of file ProgressData.h.
bool zypp::ProgressData::reportPercent | ( | ) | const [inline] |
Definition at line 303 of file ProgressData.h.
bool zypp::ProgressData::reportAlive | ( | ) | const [inline] |
false
. Definition at line 310 of file ProgressData.h.
value_type zypp::ProgressData::reportValue | ( | ) | const [inline] |
Definition at line 316 of file ProgressData.h.
const std::string& zypp::ProgressData::name | ( | ) | const [inline] |
Definition at line 320 of file ProgressData.h.
const ReceiverFnc& zypp::ProgressData::receiver | ( | ) | const [inline] |
Definition at line 324 of file ProgressData.h.
bool zypp::ProgressData::finalReport | ( | ) | const [inline] |
true
if this the final report sent by the ProgressData dtor. Definition at line 330 of file ProgressData.h.
bool zypp::ProgressData::report | ( | ) | [private] |
Send report if necessary.
Definition at line 33 of file ProgressData.cc.
std::ostream & operator<< | ( | std::ostream & | str, |
const ProgressData & | obj | ||
) | [related] |
Stream output
Definition at line 107 of file ProgressData.cc.
ProgressData makeProgressData | ( | const InputStream & | input_r | ) | [related] |
Setup from InputStream.
Definition at line 125 of file ProgressData.cc.
RWCOW_pointer<Data> zypp::ProgressData::_d [private] |
Pointer to data.
Definition at line 340 of file ProgressData.h.