File: MoniTool_Stat.hxx

package info (click to toggle)
oce 0.18.3-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 301,548 kB
  • sloc: cpp: 1,190,609; ansic: 67,225; sh: 11,630; tcl: 7,954; cs: 5,221; python: 2,867; java: 1,522; makefile: 342; xml: 292; perl: 37
file content (125 lines) | stat: -rw-r--r-- 3,770 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
// This file is generated by WOK (CPPExt).
// Please do not edit this file; modify original file instead.
// The copyright and license terms as defined for the original file apply to 
// this header file considered to be the "object code" form of the original source.

#ifndef _MoniTool_Stat_HeaderFile
#define _MoniTool_Stat_HeaderFile

#include <Standard.hxx>
#include <Standard_DefineAlloc.hxx>
#include <Standard_Macro.hxx>

#include <Handle_TCollection_HAsciiString.hxx>
#include <Standard_Integer.hxx>
#include <Handle_TColStd_HArray1OfInteger.hxx>
#include <Standard_CString.hxx>
#include <Standard_Real.hxx>
class TCollection_HAsciiString;
class TColStd_HArray1OfInteger;


//! This class manages Statistics to be queried asynchronously.
//!
//! It is organized as a stack of counters, identified by their
//! levels, from one to ... . Each one has a total account of
//! items to be counted, a count of already passed items, plus a
//! count of "current items". The counters of higher level play on
//! these current items.
//! For instance, if a counter has been opened for 100 items, 40
//! already passed, 20 current, its own percent is 40, but there
//! is the contribution of higher level counters, rated for 20 %
//! of this counter.
//!
//! Hence, a counter is opened, items are added. Also items can be
//! add for sub-counter (of higher level), they will be added
//! definitively when the sub-counter will be closed. When the
//! count has ended, this counter is closed, the counter of
//! lower level cumulates it and goes on. As follows :
//!
//! Way of use :
//! Open(nbitems);
//! Add(..)  :  direct adding
//! Add(..)
//! AddSub (nsub)  :  for sub-counter
//! Open (nbsubs)  :  nbsubs for this sub-counter
//! Add (..)
//! Close        : the sub-counter
//! AddEnd()
//! etc...
//! Close          : the starting counter
//!
//! This means that a counter can be opened in a Stat, regardless
//! to the already opened ones :: this will be cumulated
//!
//! A Current Stat is available, but it is possible to have others
class MoniTool_Stat 
{
public:

  DEFINE_STANDARD_ALLOC

  
  //! Creates a Stat form. At start, one default phase is defined,
  //! with one default step. Then, it suffises to start with a
  //! count of items (and cycles if several) then record items,
  //! to have a queryable report.
  Standard_EXPORT MoniTool_Stat(const Standard_CString title = "");
  
  //! used when starting
  Standard_EXPORT MoniTool_Stat(const MoniTool_Stat& other);
  
  Standard_EXPORT static   MoniTool_Stat& Current() ;
  
  //! Opens a new counter with a starting count of items
  Standard_EXPORT   Standard_Integer Open (const Standard_Integer nb = 100) ;
  
  //! Adds more items to be counted by Add... on current level
  Standard_EXPORT   void OpenMore (const Standard_Integer id, const Standard_Integer nb) ;
  
  //! Directly addes items
  Standard_EXPORT   void Add (const Standard_Integer nb = 1) ;
  
  //! Declares a count of items to be added later. If a sub-counter
  //! is opened, its percentage multiplies this sub-count to compute
  //! the percent of current level
  Standard_EXPORT   void AddSub (const Standard_Integer nb = 1) ;
  
  //! Ends the AddSub and cumulates the sub-count to current level
  Standard_EXPORT   void AddEnd() ;
  
  Standard_EXPORT   void Close (const Standard_Integer id) ;
  
  Standard_EXPORT   Standard_Integer Level()  const;
  
  Standard_EXPORT   Standard_Real Percent (const Standard_Integer fromlev = 0)  const;




protected:





private:



  Handle(TCollection_HAsciiString) thetit;
  Standard_Integer thelev;
  Handle(TColStd_HArray1OfInteger) thetot;
  Handle(TColStd_HArray1OfInteger) thedone;
  Handle(TColStd_HArray1OfInteger) thecurr;


};







#endif // _MoniTool_Stat_HeaderFile