13.3 Basic Resource Database Functions

A resource-database structure is a CLX object that represents a set of resource bindings. The following paragraphs describe the CLX functions used to:

make-resource-database

Function

Returns an empty resource database.

resource-database: Type resource-database.

add-resource

database name-list value

Function

database: The resource-database for the new resource binding.
name-list: A list containing strings or symbols specifying the name for the resource binding.
value: The value associated with the name-list in the resource binding. This can be an object of any type.

Adds the resource binding specified by name-list and value to the given database. Only one value can be associated with the name-list in the database. This function replaces any value previously associated with the name-list.

delete-resource

database name-list

Function

database: The resource-database containing the resource binding.
name-list: A list containing strings or symbols specifying the name for the deleted resource binding.

Removes the resource binding specified by name-list from the given database.

map-resource

database function &rest args

Function

database: A resource-database.
function: A function object or function symbol.
args: A list of arguments to the function.

Calls the function for each resource binding in the database . For each resource binding consisting of a name-list and a value, the form (apply function name-list value args) is executed.

merge-resources

from-database to-database

Function

from-database: The resource-database from which resource bindings are read.
to-database: The resource-database to which resource bindings are added.

Merges the contents of the from-database with the to-database. map-resource invokes add-resource in order to add each resource binding in the from-database to the to-database. The updated to-database is returned.

to-database: Type resource-database.