swirl
Guide to OmniMark 7   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
  Related Syntax   Related Concepts  
control structure  

using output as

 
 

Syntax

  using output as modified-sink (& modified-sink)*
     action

Argument definitions

modified-sink
stream-name indexer? (with open-modifiers)? or attachment (with open-modifiers)?


Purpose

The using output as prefix creates a new output scope and attaches to it the given modified sink expressions. If a sink expression is a stream, it must be open. If a modified sink expression is an attachment, it will be opened for the duration of the output scope.

The following attachments are permitted for using output as:

  1. referent string-expression, which attaches the output scope to a referent whose name is given by a string expression.
  2. filestring-expression, which attaches the output scope to a file whose name is given by a string expression.
  3. an external output function call, which attaches the output scope to a "connection" to an external output function. When data is written to the stream, it is processed by the external output function. This extends the ways in which OmniMark interacts with the external environment simply by adding external function libraries.

When the modified sink expression is a stream, the following modifiers are permitted with using output as:

  1. a string expression containing the element content format modifiers
  2. the binary open modifier

Meanwhile, if the modified sink expression is an attachment, any modifier allowed by the open action can be used.

Any output generated by action will be redirected to the output scope created by using output as.

The following variations are permitted:

    Related Syntax
   & (and)
   binary
   put
   set
 
Related Concepts
   Output
 
 

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

OmniMark 7.1.2 Documentation Generated: June 28, 2005 at 5:45:56 pm
If you have any comments about this section of the documentation, send email to [email protected]

Copyright © Stilo Corporation, 1988-2005.