|
|||||
|
|
|||||
| Input functions | |||||
| Related Syntax | |||||
An input function is used to provide input to the markup processor through a do xml-parse or do sgml-parse action. The arguments of an input function are evaluated prior to actually entering the do xml-parse or do sgml-parse or establishing a new parsing activity, so any references to markup objects refer to the surrounding context, not the new parse state.
A input function is an ordinary OmniMark function (not an external function). It becomes an input function by virtue of being called with the input keyword as part of a do xml-parse or do sgml-parse. The same function may legally be called as a regular function in one part of your program and as an input function in another place (though it is hard to imagine why you would do this).
An input function must not return a value. Instead, all output that occurs within an input function, and all rules fired or functions called as a result of the execution of the input function, become input for the markup processor invoked by the do xml-parse or do sgml-parse. An input function may also write directly to #markup-parser (though the same function, if called elsewhere, may not have this privilage).
An input function is processed in parallel with the markup processor, which is invoked by the do xml-parse or do sgml-parse.
|
Related Syntax do sgml-parse external-text-entity |
| ---- |
