GBBopen 1.2 Reference -- with-find-stats

with-find-stats

with-find-stats (&key initialize report) declaration* form* => result* [Macro]

Purpose
Record and optionally display retrieval statistics for find-instances and map-instances-on-space-instances.

Package :gbbopen

Module :gbbopen-core

Arguments and values

initialize		A generalized boolean(default is `t`)
report		A generalized boolean(default is `t`)
declaration		A declare expression (not evaluated)
forms		An implicit progn of forms to be evaluated
results		The values returned by evaluating the last `form`

Returns
The values returned by evaluating the last form.

Example
Collect and display the retrieval statistics associated with running an application function scanner:

  > (with-find-stats ()
       (scanner (find-instance-by-name 471 'hyp)))
  ;; Find/Map Statistics:
  ;;        20 find/map operations (0 using marking, 20 using hashing)
  ;;       100 buckets scanned
  ;;      9240 instances touched
  ;;      9240 instances considered
  ;;       521 instances accepted
  ;;      0.16 seconds (0.80 msec/operation)
  (#<hyp 419 (1835 4791) 0.85 [5..35]>
   #<hyp 233 (1835 4791) 0.89 [5..35]>)
  >

The GBBopen Project

with-find-stats