Syntax

  with referents-displayed (& open-modifier)

This modifier allows referents to be written to the stream. The referents are immediately converted to a string expression identifying the name of the referent and its current value. This string expression is an ordinary value. No replacement is done when referents are resolved.

The purpose of this modifier is to allow referents to be written to streams without buffering those streams until referents are resolved, and to display something useful when doing so. This is primarily useful in programmer-generated errors, warnings, or information messages, where the contents of a buffer containing referents needs to be displayed.

Related Syntax    referents-allowed

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