Programmer Guide/Command Reference: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{STX| | {{DISPLAYTITLE:{{STX|Caps}} {{SUBPAGENAME}}}} | ||
The command reference documents all the commands available in the {{STX}} macro language. This is with the notable exception of the {{Stx}} shell item commands, which are documented in the chapter [[Programmer_Guide/Shell_Items|Shell Items]]. | The command reference documents all the commands available in the {{STX}} macro language. This is with the notable exception of the {{Stx}} shell item commands, which are documented in the chapter [[Programmer_Guide/Shell_Items|Shell Items]]. | ||
Revision as of 15:20, 8 May 2014
The command reference documents all the commands available in the STx macro language. This is with the notable exception of the STx shell item commands, which are documented in the chapter Shell Items.
Each STx command generates both a result value (the return value of the command) and a completion code, the latter indicating success or failure of the command. The completion code is stored in the shell variables RC (a numerical error or warning code, 0 indicating success) and EMSG (textual error message according to value of RC).
- Notes
-
- You should make it a habit to always end the list of options with the "end of options" option,
/-(q.v.) because, otherwise, you will get into trouble when command arguments start with a slash. - Most commands overwrite the variables RC and EMSG. There are a few commands, though, which touch RC and EMSG only if an execution error occours. The most prominent commands in the latter group are IF and GOTO and, actually, most other control commands.
- Some commands return the completion code also as their return value.
- In contrast to commands, macros store their return value (generated with the EXIT command) in the variable RESULT, meaning that macro calls do not affect the variables RC and EMSG.
- You should make it a habit to always end the list of options with the "end of options" option,
- See also
- Introduction, shell items
STx commands (alphabetical list)
ARG · ATTRIBUTES · BREAK · CHECKIT · COND · CONTINUE · DELETE · DISPATCH · DO · DRIVE · ELSE · EMSG · END · ENV · EVAL · EVALCHECK · EXIT · FIND · FOR · FOREVER · FORMAT · GOSUB · GOSUBX · GOTO · IF · IFNOT · INT · INTCHECK · INTERPRET · IREF · KEYWORD · LENGTH · LINELENGTH · LIST · LOAD · LOGMSG · LOWER · MACRO · MACROX · MESSAGE · NAME · NEW · NUM · NUMCHECK · PARSECELLMESSAGE · POSITION · PRINTDIALOG · PRINTSETTINGS · PWD · QUERY · QUOTE · READ · REVERSE · SEGMENT · SET · SFTRUNCATE · SHELL · STRCHR · STXCONSTANTS · SUBSTR · SYSINFO · SYSTEM · TAGS · TGET · TIME · TOKEN · TRANSLATE · TRIM · TSET · UNIQUE · UNLOAD · UPPER · WHILE · WORD · WORDS · WRITE · WRITELOG
