
  ============================================
  --------- C/C++ Program Perfometer ---------
  ---------------- Version-2.2 ---------------
  ============================================

  The algorithm has been written by Alex Vinokur.
  The perfometer enables 
    to get C/C++ program performance
    for any metrics.
  Programming Language : C++.
  Any and all comments would be appreciated.

  DISCLAIMER

    Copyright (c) 2002 by Alex Vinokur.

    This work and all works derived from it may be copied and modified 
    without any restrictions other than that 
    a copy of this copyright notice must be included in any copy 
    of this work or any derived work.

    The Author assume no responsibility for damage or loss of system
    performance as a direct or indirect result of the use of this
    software.

  =====================================
  AVAILABILITY

    -----------------------------------
    ### Web page ###
        http://alexvn.freeservers.com/s1/perfometer.html

       Content.
         1. Algorithm
         2. Classes
         3. Program Files
         4. Compiling
         5. Running (Log Files)
         6. Download

    -----------------------------------
    ### Download ###
        http://home.barak-online.net/alexvn/s2/pf/pmeter.zip
        http://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=3512&lngWId=3
        http://alexvn.freeservers.com/s1/perfometer.zip	(via http://alexvn.freeservers.com/s1/perfometer.html)

        Files:
	  0. README.txt	(this file)

             --- Program Files ---
	  1. version.h		Software Version 
	  2. macro.h		Various Macro 
	  3. common.h		Common Function etc
	  4. user.h		User-Specialized Function Declaration
	  5. pfmeter.h		Definition of Common Classes
	  6. pfmeter2.h		Implementation of Common Template Classes 
	  7. version.cpp	Software Version 
	  8. pfmeter.cpp	Implementation of Common (Non-Template) Classes 
	  9. adapt.h		Definition of User-Related Classes 
	 10. adapt.cpp 		Implementation of User-Related Classes
	 11. demo.h		Declaration of Measured/Compared Functions 
	 12. demo.cpp		Implementation of Measured/Compared functions 
	 13. demo2.cpp 		Implementation of Measured/Compared functions
	 14. main.cpp		Main Program 

             --- Makefile ---
	 15. Makefile		Makefile 

             --- Batch file ---
	 16. compile.bat	Compilation 
	 17. run_demo.bat	Demo Invokation 


  =====================================
  ENVIRONMENT

    ### System & Compiler ###

	Windows-2000
	  Intel(R) Pentium
	  R(4) CPU 1.70GHz

	DJGPP 2.03
	gcc version 3.1
	  GNU CPP version 3.1 (cpplib) (80386, BSD syntax)
	  GNU C++ version 3.1 (djgpp) compiled by GNU C version 3.1


  =====================================
  USAGE

    ### Compiling & Running Tests ###

        --- Compilation ---
        %compile.bat

        --- Run Demo via batch file ---
        %run_demo.bat

        --- Run via command line ---
        %<perfometer-exe-file-name> [-h] [-v] [-s] [-m] [+m] [-d] [+d] [-t] [+t] [-i <number>] [-e <number>] [-p <number>] [-f <float-number>]


  =====================================
  NOTE

    Demo tests in files demo.cpp and demo2.cpp
      are using not uclock(), but clock()
      because there is a problem with uclock() on Windows2000.
    Details : http://groups.google.com/groups?th=f073ad9b3aca2a6a
    However, clock() has insufficient time accuracy.
    It seems that there is no problem with uclock() on Windows95/98.	


  =====================================
  APPLICATION

    #####################################
    ##### Performance measurements ######
    ####### performed with using ########
    ###  the C/C++ Program Perfometer ###
    #####################################

    1. for-loop vs. for_each algorithm in vector, string, list, set. 
       http://groups.google.com/groups?selm=3C8DD296.A7304148%40bigfoot.com 

    2. find() algorithm vs. find() method in vector, list, set, map 
       http://groups.google.com/groups?selm=3C8C7B97.E4B5CA9C%40bigfoot.com 

    3. Access to array, vector, basic_string 
       http://groups.google.com/groups?selm=3C8C619E.D3F557D5%40bigfoot.com 

    4. switch vs. dynamic_cast 
       http://groups.google.com/groups?selm=15eacd17.0204300451.209a527f%40posting.google.com 

    5. operator[] vs. at() 
       http://groups.google.com/groups?selm=aa8kpg%248oo15%241%40ID-79865.news.dfncis.de


=========================================================

	Alex Vinokur
		2002.08.13
	-----------------------------------
	mailto:alexvn@go.to
	mailto:alexv@hitechclub.com
        http://up.to/alexvn
        http://go.to/alexv_math
	-----------------------------------

=========================================================

