GBBopen 1.2 Reference -- link-setf

link-setf

link-setf

link-slot-place unit-instance-or-instances => unit-instance-or-instances

[Macro]

Purpose
Set link-slot-place to be precisely unit-instance-or-instances links between unit instance and unit-instance-or-instances.

Package :gbbopen

Module :gbbopen-core

Arguments and values

link-slot-place		A form which is suitable for use as a generalized reference to a link slot
unit-instance-or-instances		A unit instance or a list of unit instances

Returns
The supplied unit-instance-or-instances.

Events
An unlink-event is signaled for:

all pointers that are removed from the specified link-slot-place
each inverse pointer of the link that is removed-from another unit instance

A link-event is signaled for:

all pointers that are added to the specified link-slot-place
each inverse pointer of the link that is added to another unit instance

Description
Any existing links in link-slot-place that do not involve unit-instance-or-instances are unlinked. Then links to any additional unit instances in unit-instance-or-instances are added.

See also
    linkf
    unlinkf
    unlinkf-all

Example
Set the supporting-hyps link slot of the hyp unit instance to the unit instances in supporting-hyps:

  > (link-setf (supporting-hyps-of unit-instance) supporting-hyps)
  #<hyp 231 (1488 7405) 0.63 [0..8]>
  >

Note
The form (link-setf link-slot-place nil) is semantically equivalent to (unlinkf-all link-slot-place). However, using unlinkf-all is preferable stylistically and slightly faster.

The GBBopen Project

link-setf