| Allegro CL version 10.1 Unrevised from 10.0 to 10.1. 10.0 version |
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.
See multiprocessing.htm for general information on multiprocessing in Allegro CL.
Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.
| Allegro CL version 10.1 Unrevised from 10.0 to 10.1. 10.0 version |