The Progress library.

Introduction

This library provides an easy way for C programs to keep their users informed of how long a task is going to take. It provides the regular accoutrements: a text bar chart, a percentage completion display, and a calculation of the estimated time remaining. Each PInfo structure is logically separate, allowing you to have one object for each type of process you may be working with (as well as being thread safe). It also comes with a wide variety of added extras to make displaying time information easy.

Requirements

The following libraries are required for Progress:

Features

Progress bars have the following features:

Notes

Progress bars cannot keep track of ranges that are floating point numbers. This has yet to be a problem - casting to integer will usually have the same effect.

Progress bars keep their own internal value of what iteration they're up to. This means that you can use a progress bar to step through a loop that's counting down - as long as you set the minimum to be numerically lower than the maximum, the effect will be exactly the same.

Progress bars can also write extensive debugging output to a separate file; this is useful when adding features to the Progressor library. If you need to debug a progress bar on the fly, you can use the P_set_debugging() and P_clear_debugging() calls to turn debugging on and off. It also detects the 'PROGRESS_DEBUG' environment variable being set when the program using the progress bar is activated.


Generated on Fri Jan 23 11:58:35 2009 for Progress by  doxygen 1.4.7