find-relation [Function]

Purpose

The find-relation function, a robust variant of get-relation, searches for the relation having a specified name.

Syntax

find-relation relation &key no-warning-p ignore-package-p context

Arguments

The relation argument is a relation, or a symbol or string which names a relation. If it is a symbol, it may be an extended identifier having the form context\^{\space}name, where context is the context from which the search is to proceed.

If the no-warning-p argument is t, then no warning is generated if Loom cannot find a relation having the specified name.

If the ignore-package-p argument is t, then Loom searches across packages for the specified name.

The context argument is the context, or the name of the context, from which the search is to start. The relation will be found if it is interned in context or any context above context. This argument defaults to the current context.

Value

The find-relation function returns the relation with the specified name, or nil if none is found.

Remarks

The find- functions tend to be more flexible, slower, and do more error-checking than the get- functions (such as get-relation). Package-independent searches may be especially slow.

Examples

(find-relation '+) ==> |R|+ 
(find-relation 'cl-user-theory\^{\space}age :no-warning-p t) ==> |R|AGE 
(find-relation 'r :ignore-package-p t) ==> |R|R 
(find-relation "child" :context 'bottom-theory) ==> |R|CHILD