Syntax

  open  stream-name indexer? with referents-allowed
       defaulting { string expression } ...
       as attachment

  open  stream-name indexer? with referents-allowed
       defaulting { string expression1 , string expression2 } ...
       as attachment

  reopen  stream-name indexer? with referents-allowed
       defaulting { string expression } ...
       as attachment

  reopen  stream-name indexer? with referents-allowed
       defaulting { string expression1 , string expression2 } ...
       as attachment

This modifier allows a programmer to provide a definition (default value) for every referent that's written out. A defaulting declaration can be specified with referents-allowed in an open or reopen action. There are two possible forms, either as one string expression or two, and these provide an effective value for referents as follows:

• If there is one string expression, then that is the effective value. To ensure that undefined referents are simply omitted from any stream to which they are written, use the zero-length string as their default effective value.
• If there are two string expressions, then the effective value is the name of the referent, with the first string preceding it and the second following it. To get just the name with no surrounding text, use two zero-length strings.

The defaulting part used to provide the effective value of an undefined referent is the defaulting part associated with the "final destination" of the referent.

Related Syntax    open    referents-allowed    reopen    silent-referent

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]