The CxProgress Class - Time, progress and rate estimations made easy

• Download source files - 1.95 Kb

Introduction

This article solves a simple yet tricky problem! Time estimations !

Did you ever create a function to download a file from the web but you couldn't calculate the transfer rate , estimate the time ...If you tried you got the Division By Zero fatal message! Well this class can do many great things just by a few function calls.

CxProgress

typedef unsigned long u_long;
typedef unsigned int u_int;

class CXProgress
{
public:
    CXProgress();
    void SetRange(u_long prgmin, u_long prgmax);
    const char * FormatLeftTime();
    const char * FormatElapsedTime();
    u_long ToComeSeconds();
    bool StepIt(u_long steps=1);
    bool SetStep(u_long step=1);
    u_long RatePerHour();
    u_long RatePerMinute();
    u_long RatePerSecond();
    u_long Rate(u_long milisecs=1000);
    u_long ElapsedMilisecs();
    u_long ElapsedDays();
    u_long ElapsedHours();
    u_long ElapsedMinutes();
    bool IsTimeElapsed();
    bool DecreaseMinPos(u_long num);
    bool EncreaseMinPos(u_long num);
    bool DecreaseMaxPos(u_long num);
    bool IncreaseMaxPos(u_long num);
    u_long ElapsedSeconds();
    u_int GetPercentLeft();
    u_int GetPercentElapsed();
    u_long GetLeftPos();
    u_long GetCurrentPos();
    bool Can();
    u_long LeftDays();
    u_long LeftHours();
    u_long LeftMinutes();
    u_long LeftSeconds();
    bool SetCurrentPos(u_long);
    CXProgress(u_long, u_long);
    virtual ~CXProgress();
private:
    // do not modify the variables below
    u_long startMom,nowMom;
    // they are private and by modifying them i don`t
    long startTime,nowTime;        
    // know how class will behave
    u_long prgMin;
    u_long prgMax;
    u_long curPos;
    u_long numStep;
    // interneal buffer for functions that return strings
    char buf[512];            
};
/*---------------------------------------------------------*/
/*CXProgress.cpp*/
// XProgress.cpp: implementation of the CXProgress class.
//
//////////////////////////////////////////////////////////////////////

Using the code

The code using method is most easy :

void main(void)
{
    CXProgress prg(0,100);
/*we create a prg with range 0-100*/
    int cur=0;
    while(cur<100)
    {
        cur++;
        prg.SetCurrentPos(cur);
/*we set it`s position to cur*/
        Sleep(1000);
        printf("%s -",prg.FormatElapsedTime());
        printf(" %s - Rate: %d\r",prg.FormatLeftTime(),prg.RatePerSecond());
/*run this example and see how it works*/
    }
}

As you see it's ideal for internet transfers , for getting rate ...

Documentations

How to use each function :

History

• Only release 6:31 AM 3/15/2003 (I think)

Last but not least

And if you did not understand anything look at the code. You can't miss it. You'll get it for sure! :~)

The source code will reveal its darkest secrets to your mortal eyes by only looking at it. And I'll let you in on another little secret of mine. You can use the very ancient but long forgotten copy-paste technique if the complexity of the source code overwhelms you. And if you need more information check the holy book of software engineers, the forbidden MSDN. Many words of wisdom will be discovered within its dirty and dusty pages.

And to find out the truth about our existence, humanity, universe and aliens mail me.