File: ExcimerProfiler.php

package info (click to toggle)
php-excimer 1.2.5-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 348 kB
  • sloc: ansic: 2,513; xml: 233; php: 82; makefile: 2
file content (111 lines) | stat: -rw-r--r-- 2,832 bytes parent folder | download | duplicates (4)
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
<?php

/**
 * A sampling profiler.
 *
 * Collects a stack trace every time a timer event fires.
 */
class ExcimerProfiler {
	/**
	 * Set the period.
	 *
	 * This will take effect the next time start() is called.
	 *
	 * If this method is not called, the default period of 0.1 seconds
	 * will be used.
	 *
	 * @param float $period The period in seconds
	 */
	public function setPeriod( $period ) {
	}

	/**
	 * Set the event type. May be either EXCIMER_REAL, for real (wall-clock)
	 * time, or EXCIMER_CPU, for CPU time. The default is EXCIMER_REAL.
	 *
	 * This will take effect the next time start() is called.
	 *
	 * @param int $eventType
	 */
	public function setEventType( $eventType ) {
	}

	/**
	 * Set the maximum depth of stack trace collection. If this depth is
	 * exceeded, the traversal up the stack will be terminated, so the function
	 * will appear to have no caller.
	 *
	 * By default, there is no limit. If this is called with a depth of zero,
	 * the limit is disabled.
	 *
	 * This will take effect immediately.
	 *
	 * @param int $maxDepth
	 */
	public function setMaxDepth( $maxDepth ) {
	}

	/**
	 * Set a callback which will be called once the specified number of samples
	 * has been collected.
	 *
	 * When the ExcimerProfiler object is destroyed, the callback will also
	 * be called, unless no samples have been collected.
	 *
	 * The callback will be called with a single argument: the ExcimerLog
	 * object containing the samples. Before the callback is called, a new
	 * ExcimerLog object will be created and registered with the
	 * ExcimerProfiler. So ExcimerProfiler::getLog() should not be used from
	 * the callback, since it will not return the samples.
	 *
	 * @param callable $callback
	 * @param int $maxSamples
	 */
	public function setFlushCallback( $callback, $maxSamples ) {
	}

	/**
	 * Clear the flush callback. No callback will be called regardless of
	 * how many samples are collected.
	 */
	public function clearFlushCallback() {
	}

	/**
	 * Start the profiler. If the profiler was already running, it will be
	 * stopped and restarted with new options.
	 */
	public function start() {
	}

	/**
	 * Stop the profiler.
	 */
	public function stop() {
	}

	/**
	 * Get the current ExcimerLog object.
	 *
	 * Note that if the profiler is running, the object thus returned may be
	 * modified by a timer event at any time, potentially invalidating your
	 * analysis. Instead, the profiler should be stopped first, or flush()
	 * should be used.
	 *
	 * @return ExcimerLog
	 */
	public function getLog() {
	}

	/**
	 * Create and register a new ExcimerLog object, and return the old
	 * ExcimerLog object.
	 *
	 * This will return all accumulated events to this point, and reset the
	 * log with a new log of zero length.
	 *
	 * @return ExcimerLog
	 */
	public function flush() {
	}
}