|
|||||
|
|
|||||
| declaration/definition | save-clear | ||||
| Sample Code | Related Syntax | Related Concepts | |||
Syntax
save-clear shelf-type? shelf-name
The equivalent of a save declaration followed immediately by a clear action. After a save-clear saves the shelf, it clears the copy it made.
The shelf-type is an optional herald indicating the shelf type.
If the current contents of the saved shelf are not required in the local scope that performed the save, then save-clear can be used instead. The only difference is that after save-clear saves the shelf it clears the copy.
Because the size of the shelf is changed using a save-clear declaration, it may only be used on shelves that are declared to be variable. save-clear declarations may not have attached conditions. Unlike the save declaration, when save-clear is applied to stream shelves, there are no restrictions on what the items may be attached to.
If a number of save-clear declarations occur consecutively, the keyword save-clear may be replaced with either and or the "&" operator. This form is deprecated, since it does not enhance readability.
| ---- |
