Stores a term with a key in an inner blackboard.

bb_put(+Board, +OuterKey, +InnerKey, +Term)

bb_put/4 stores a key/value tuple in an inner blackboard accessed with OuterKey. If there is no tuple OuterKey/InnerBoard in Board a new inner blackboard will be created and stored in Board.
This predicate is equivalent to:

( bb_get(Board, OuterKey, SubBoard) ->
    bb_put(SubBoard, InnerKey, Term)
;    bb_create(SubBoard),
    bb_put(SubBoard, InnerKey, Term),
    bb_put(Board, OuterKey, SubBoard)
)

Arguments

Board              blackboard
OuterKey           ground term
InnerKey           ground term
Term               term

Examples

    bb_create(Family),
    bb_put(Family, john, father, joe),
    bb_put(Family, john, mother, clara),
    bb_put(Family, emily, father, mike),
    bb_get(Family, john, Parent, Name)
->
    Parent = father
    Name = joe
and
    Parent = mother
    Name = clara

Standard

This predicate is not part of the ISO-Prolog Standard.

See also