| Allegro CL version 10.0 This page is new in 10.0. | ||||||||||
Arguments: index &key return log wait
Return one entry from the current or the specified memory log.
Return nil if an entry was not obtained.
The index argument specifes the desired entry: 0 denotes the oldest entry; -1 denotes the most recent entry.
If log is specified, return an entry from that log.
If wait is specified, it determines how
long to wait in order to acquire a log on the current log
(nil or 0 means do not wait, a positive
integer means wait that number of seconds, any other
non-nil value means wait as long as
necessary).
The return argument may
be :list, :vector, a list or a
vector:
:list -- return the log entry as a new list of 4+w
elements.
:vector -- return the log entry as a new vector of
4+w elements.
nil if necessary. Copy as much as will
fit.
nil if necessary. Copy as much as will
fit.
Note that each entry from a current and active log is fetched under a new lock. Thus two calls with the same index may not retrieve the same entry. Two calls with consecutive indices may return unrelated entries If consistent indexed access is desired, a copy of the current log must be made.
See Memlog: A Facility for Minimally Intrusive Monitoring of Complex Application Behavior in smp.htm for more information.
Copyright (c) 1998-2015, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 10.0. This page is new in the 10.0 release.
Created 2015.5.21.
| Allegro CL version 10.0 This page is new in 10.0. | ||||||||||