Home Page   We Generate Your Software.
Products Services Company Technology Demo Contact Site Map Search
The Somusar/SoProTech[tm] Booklet Series
Volume VI

"somusar/Tefigel: Reference Guide"

Printer friendly


Contents
1. Introduction
2. File Sections
3. Commands and Instructions
4. Markers
5. Comments
6. Special Characters
7. Variables
8. Arithmetic Computation
9. Boolean Computation
10. Control Flow
11. Subroutines and Functions
12. Built-in Functions
13. Input and Output
14. Packages and Libraries
15. Tag File Processing
16. CSV File Processing
17. Filters
18. Links and Traps
19. Name Spaces
20. Miscellaneous
20.1 Purpose
20.2 Usage
20.3 Description
21. Further Reading

Chapter 20 - Miscellaneous

20.1 - Purpose        top

Perform miscellaneous instructions to control Tefigel operating mode and state or to access the underlying operating system.

20.2 - Usage        top

Execute an operating system shell command:

   system <command-string>
Print Tefigel version string:
   version
Reset Tefigel internal state to initial state:
   reset
Dump Tefigel internal state:
   dump
Tune behavior of Tefigel:
   switch <control-variable>=<control-value>
"Hook" a user-defined Tefigel subroutine to a given processing event:
   hook <hook-event>=<hook-subroutine>
Remove association between a <hook-event> and a user-defined <hook-subroutine>:
   hook <hook-event>=

20.3 - Description        top

A <command-string> can be any command for the command interpreter (shell) of the underlying operating system.

Instruction reset resets all Tefigel variables and filters, and sets special characters, markers, control switches and event hooks to their default start-up state.

Instruction dump prints all available information about Tefigel status, including variables and name spaces, special characters, markers, filters, control switches, event hooks, and library path.

Switch <control-variable>'s may be set to the <control-value>'s described in the following list:

  • AUTO_NEWLINE
    0: do not automatically print a CR-LF sequence after each output line;
    1: [default] print a CR-LF sequence after each output line.

  • CMD_CASE
    0: Tefigel <instruction>'s are in upper case;
    1: [default] Tefigel <instruction>'s are in lower case.

  • ON_MISSING_FILE
    0: silently ignore attempts to process or call non-existent files;
    1: print a warning message when attempting to process or call non-existent files;
    2: [default] print a fatal error message and terminate processing on attempts to process or call non-existent files.

  • STRICT_CMDMARK
    0: consider input lines starting with an instruction as command lines, even if a command marker has been defined;
    1: [default] when a command marker is set, treat all input lines not starting with the current command marker as text lines.

  • TRACE
    0: [default] do not print tracing messages about Tefigel processing;
    1: trace begin and end of file processing instruction execution;
    2: same as 1, moreover trace execution of all instructions;
    3: same as 2, moreover trace processing of all input lines, including text lines.

A <hook-subroutine> is a Tefigel script that can be associated with one of the <hook-event>'s described in the following list:
  • NEW_INPUT
    The <hook-subroutine> (if any) associated with this event will be called when processing of a new input file begins. The file name of the new input file will be passed as a parameter to the <hook-subroutine>.

  • EOF_INPUT
    The <hook-subroutine> (if any) associated with this event will be called when processing of the current input file ends. The file name of the input file will be passed as a parameter to the <hook-subroutine>.

[Previous chapter]    [Next chapter]    [Back to top]

http:// www.somusar.com  / doc  / booklets  / tefigel_ref  - Powered by SoProMach
Copyright © 2003-2012 Somusar - Trademarks - Legal - Privacy - Webmaster