swirl Guide to OmniMark 5   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesOMX VariablesErrors
 
  Related Syntax   Related Concepts  
declaration/definition   save-clear    

Syntax

  save-clear  shelf-name


Purpose

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.

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.

    Related Syntax
   clear
   save
 
Related Concepts
   Variables
 
----

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ OMX ] [ OMX ] [ ERRORS ]

Generated: August 11, 2000 at 3:07:48 pm
If you have any comments about this section of the documentation, send email to docerrors@omnimark.com

Copyright © OmniMark Technologies Corporation, 1988-2000.