collect-registry-values subkey &key root max-name-size max-buffer-size expected-type errorp value-function => values-alist
A string specifying the name of the key.
A keyword or handle.
An integer.
An integer.
A keyword or
t
.
A boolean.
A function or symbol.
The function
collect-registry-values
returns an alist of all of the values of
subkey
under the key
root
.
subkey
and
root
are interpreted as described for create-registry-key. The default value of
root
is
:user
.
max-name-size specifies the maximum length of the returned name. If the name is longer than this, an error is signalled. The default value of max-name-size is 256.
max-buffer-size specifies the maximum length in bytes of the data. If the data is longer than this, an error is signalled. The default value of max-buffer-size is 1024.
If
value-function
is
nil
, the returned
values-alist
is an association list containing pairs
(
name
.
data
)
consisting of the names and data of the values of
subkey
.
expected-type
controls how certain types are converted to Lisp objects as described for enum-registry-value. The default value of
expected-type
is
t
.
If value-function is non-nil, it should be a function with signature
value-function handle subsubkey-name-and-value => name-and-value , collectp
value-function
is funcalled for each subsubkey with the handle of
subkey
and a cons of the name and value of the subsubkey. If
collectp
is non-nil then
name-and-value
is collected into the alist
values-alist
to return from
collect-registry-values
. Otherwise
name-and-value
is ignored.
If an error occurs and
errorp
is true, then an error is signalled. Otherwise,
values-alist
is returned as
nil
if
subkey
could not be opened at all or contains
nil
for the data of any particular pair that cannot be read. The default value of
errorp
is
t
.