File: time.doc

package info (click to toggle)
hol-light 20120602-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 23,452 kB
  • sloc: ml: 348,797; cpp: 438; java: 279; makefile: 252; sh: 183; yacc: 108; perl: 78; ansic: 57; sed: 39
file content (31 lines) | stat: -rw-r--r-- 676 bytes parent folder | download | duplicates (2)
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
\DOC time

\TYPE {time : ('a -> 'b) -> 'a -> 'b}

\SYNOPSIS
Report CPU time taken by a function.

\DESCRIBE
A call {time f x} will evaluate {f x} as usual, but will also (provided the 
{report_timing} flag is {true} as it is by default) print the CPU time taken by 
that function evaluation.

\FAILURE
Never fails in itself, though it propagates any exception generated by the call 
{f x} itself.

\EXAMPLE
{
  #  time NUM_REDUCE_CONV `123 EXP 14`;;
  CPU time (user): 0.09
  val it : thm = |- 123 EXP 14 = 181414317867238075368413196009
}

\USES
Monitoring CPU time taken, e.g. to test different algorithms or implementation 
optimizations.

\SEEALSO
report_timing.

\ENDDOC