PHP Classes

File: StopWatchClass.php.pseudo.txt

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in Bookmark in
  Classes of Bob Wedwick  >  PHP StopWatch Timer  >  StopWatchClass.php.pseudo.txt  >  Download  
File: StopWatchClass.php.pseudo.txt
Role: Documentation
Content type: text/plain
Description: Documentation for Stop Watch
Class: PHP StopWatch Timer
Measure the time PHP scripts take to execute
Author: By
Last change:
Date: 1 year ago
Size: 3,866 bytes


Class file image Download
	Useful in determining time to complete various tasks inside a php script.
	Keeps track of time intervals in either milliseconds (by default) or microseconds from the Start to the Stop
	with an unlimited number of intermediate, named intervals.
	Start, stop, and interval entries may be given optional unique names.
	When a start, stop, or interval name is not given, the class assigns a name beginning with ~.
	To run the stop watch you need, as a minimum, to create the object and then call the Stop function.
	You can create intervals anywhere the stopwatch object is visible in your script.
	Individual intervals can be retrieved by name.
	The array of intervals can be retrieved at any time.
	Stop automatically returns the entire interval array.
	The increments between intervals are saved in a name-value-pair (NvP) array
	and are not deleted when the timer stops, so intervals and the entire array can be retrieved
	after the timer is stopped and before another start is issued.
	You need to have the following in your script.
	include_once [path.] "StopWatchClass.php";
	$watch = new stopwatch();
	Copyright (C) 2014 Software Installation Services, Inc.
	Author: Bob Wedwick, Phoenix, AZ 602-449-8552  bob at wedwick dot com.
	This program is free software: you can redistribute it or modify it under the terms
	of the GNU General Public License as published by the Free Software Foundation,
	either version 3 of the License or any later version.
	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	GNU General Public License for more details.
	See for a copy of the GNU General Public License.
	An example test php script for the stop watch class is in the script named TestStopWatch.php.
	The output for the test script is in TestStopWatchOutput.txt
	Script logic in the form of pseudocode is in StopWatchClass.php.pseudo.txt
### class name is stopwatch
	# initialize properties
	# NvP array of time intervals
	# elapsed microtime for the latest entry
	# microtime when the stopwatch started
### constructor
	# start the timer by default
# end function
### make one entry with an ID name in the interval array - AddInterval($id, $oneTime= 0)
	# enter the time for the named interval
# end function
### return all the intervals so far - AllIntervals()
	# return the complete NvP interval array
# end function
### get the time for one named interval or the latest interval - GetNamedInterval($id = null)
	# if $id name is null
		# return the latest interval
	# else if there is a $id name
		# return the named interval
	# else return 'no value'
# end function
### record the duration for one interval - Interval($id = null)
	# get the current microtime
	# if no $id name is given for the interval
		# give it a counter interval name
	# ....
	# if starting the stop watch
		# set start time interval to zero
		# note the starting time
	# else
		# compute time since the prior interval
		# if calling for microseconds round the time to microseconds otherwise to milliseconds
	# ....
	# add it to the interval array
	# update the last interval time
# end function
### start or restart the interval timer - Start($id = null, $microseconds=false )
	# reset the interval array
	# if no $id name is sent call it '~start'
	# set or clear the microsecond flag
	# make the starting entry in the interval array
# end function
### stop timing and return the interval array - Stop($id = null)
	# if no $id name is sent call it '~stopped'
	# enter a stop interval time
	# sum all intervals
	# make a total time entry in the array
	# return the complete array
# end function
# end class