referents-allowed

modifier

Syntax
open stream with referents-allowed ...

open stream with referents-allowed defaulting { string expression } ...

open stream with referents-allowed defaulting { string expression1 ,  string expression2 } ...
  
reopen stream with referents-allowed ...

reopen stream with referents-allowed defaulting { string expression } ...

reopen stream with referents-allowed defaulting { string expression1 ,  string expression2 } ...

set stream with referents-allowed to  ...

set stream with referents-allowed defaulting { string expression } to ... 

set stream with referents-allowed defaulting { string expression1 ,  string expression2 } to ... 
    


Purpose

This modifier allows referents to be written to a stream.

Streams opened (or reopened) using this modifier will not have data written to their attachments (for example, files) until the current referent scope is closed and its referents resolved. If the stream was opened in the global referent scope, referents are not resolved until the program ends, so these referents-allowed streams opened as files should not be used as input to a later part of the program.

You can use the defaulting modifier with referents-allowed to provide default values for every referent.

The contents of streams attached to buffers or referents opened with the referents-allowed modifier, and then closed, can be written only to other streams that were opened with the referents-allowed or referents-displayed modifier.