Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the cl-performance-tuning-helper Reference Manual, version 0.3.0, generated automatically by Declt version 3.0 "Montgomery Scott" on Wed Mar 25 17:30:48 2020 GMT+0.
| • Introduction | What cl-performance-tuning-helper is all about | |
| • Systems | The systems documentation | |
| • Files | The files documentation | |
| • Packages | The packages documentation | |
| • Definitions | The symbols documentation | |
| • Indexes | Concepts, functions, variables and data types |
CLOAD:load a file after compile.
e.g. (pth:cload "src") for compile and load "src.lisp".
ASMOUT:save DISASSEMBLE result for given function into a file. You can specify saving filename optionally.
When a function is given as an symbol s.t. 'SOME-FUNCTION, the default filename is a lowercase version of the symbol name with ".asm" suffix.
e.g. (pth:asmout 'SOME-PACKAGE:SOME-FUNCTION)
saves DISASSEMBLE result for #'SOME-PACKAGE:SOME-FUNCTION into "some-function.asm".
When a function is given as a lambda expression or a function itself (i.e. #'SOME-FUNCTION or (SYMBOL-FUNCTION 'SOME-FUNCTION)), you must specify filename explicitly.
e.g. (pth:asmout (lambda (x y) (+ x y)) "binary-add.asm")
saves DISASSEMBLE result of a given lambda expression into "binary-add.asm". In this case, suffix (".asm") is not appended automatically.
PERFORMANCE:simple performance checker.
e.g. 1 (pth:performance 100 debugger-p (some-function args...))
tries to eval SOME-FUNCTION 100 times with specified args.
After all, displays execution information by TIME macro.
PTH:PERFORMANCE returns t if all eval has been done successfully.
When a condition has been signaled;
nil:PTH:PERFORMANCE returns nil.nil:e.g. 2
target function also able to access current-num-repeats.
(let ((max 5))
(pth:performance (count max) nil
(format t "~&~d of ~d~%" count max) ))
;;; performance test for FORMAT 5 times
;;; do (FORMAT T "~&~d of ~d~%" COUNT MAX)
0 of 5
1 of 5
2 of 5
3 of 5
4 of 5
(and implementation dependant TIME macro result)
; => T
under MIT license.
Next: Files, Previous: Introduction, Up: Top [Contents][Index]
The main system appears first, followed by any subsystem dependency.
| • The cl-performance-tuning-helper system |
SUZUKI Shingo
SUZUKI Shingo
MIT
A simple performance tuning helper tool box for Common Lisp
0.3.0
Files are sorted by type and then listed depth-first from the systems components trees.
| • Lisp files |
| • The cl-performance-tuning-helper.asd file | ||
| • The cl-performance-tuning-helper/cl-performance-tuning-helper.lisp file |
Next: The cl-performance-tuning-helper/cl-performance-tuning-helper․lisp file, Previous: Lisp files, Up: Lisp files [Contents][Index]
cl-performance-tuning-helper.asd
cl-performance-tuning-helper (system)
Previous: The cl-performance-tuning-helper․asd file, Up: Lisp files [Contents][Index]
cl-performance-tuning-helper (system)
cl-performance-tuning-helper.lisp
Next: Definitions, Previous: Files, Up: Top [Contents][Index]
Packages are listed by definition order.
| • The cl-performance-tuning-helper-asd package | ||
| • The cl-performance-tuning-helper package |
Next: The cl-performance-tuning-helper package, Previous: Packages, Up: Packages [Contents][Index]
cl-performance-tuning-helper.asd
Previous: The cl-performance-tuning-helper-asd package, Up: Packages [Contents][Index]
pth
common-lisp
Definitions are sorted by export status, category, package, and then by lexicographic order.
| • Exported definitions |
Previous: Definitions, Up: Definitions [Contents][Index]
| • Exported macros | ||
| • Exported functions |
Next: Exported functions, Previous: Exported definitions, Up: Exported definitions [Contents][Index]
do performance test with specified arguments
usage: (performance num-repeats debugger-p (function &rest args))
num-repeats: designates a number of repeats in positive integer.
If you want to reference current repeat count from testing function,
you should specify num-repeats as following format:
(count-variable positive-integer).
debugger-p: designate enable to call debugger for ANY conditions.
function: a symbol of function or a lambda expression.
e.g.
(let ((max 5))
(pth:performance (i max) nil (format t "SAMPLE: ~d of ~d~%" i max)) )
=> t
—-
;;; performance test for FORMAT MAX times
;;; do (FORMAT T "SAMPLE: ~d of ~d~%" I MAX)
SAMPLE: 0 of 5
SAMPLE: 1 of 5
SAMPLE: 2 of 5
SAMPLE: 3 of 5
SAMPLE: 4 of 5
(and following platform dependant output of TIME function)
trash system stream outputs:
*standard-output*,
*error-output*,
and *trace-output*.
Previous: Exported macros, Up: Exported definitions [Contents][Index]
output DISASSEMBLE result into a file
load after compile a file
Previous: Definitions, Up: Top [Contents][Index]
| • Concept index | ||
| • Function index | ||
| • Variable index | ||
| • Data type index |
Next: Function index, Previous: Indexes, Up: Indexes [Contents][Index]
| Jump to: | C F L |
|---|
| Jump to: | C F L |
|---|
Next: Variable index, Previous: Concept index, Up: Indexes [Contents][Index]
| Jump to: | A C F M P T |
|---|
| Jump to: | A C F M P T |
|---|
Next: Data type index, Previous: Function index, Up: Indexes [Contents][Index]
Previous: Variable index, Up: Indexes [Contents][Index]
| Jump to: | C P S |
|---|
| Jump to: | C P S |
|---|