Programmer Guide/Command Reference/FORMAT: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
<var>var</var> := FORMAT formatstring | <var>var</var> := FORMAT formatstring arg<sub>1</sub> [ arg<sub>2</sub> ... ] | ||
<code>format</code> formats its arguments, interpreting the first argument as a format string (almost, but not quite unlike the C-language <code>printf</code> command. S_TOOLS-STx formats are described in [[Programmer Guide/Format Strings and Rules|Format Strings and Rules]]. | <code>format</code> formats its arguments, interpreting the first argument as a format string (almost, but not quite unlike the C-language <code>printf</code> command. S_TOOLS-STx formats are described in [[Programmer Guide/Format Strings and Rules|Format Strings and Rules]]. | ||
| Line 8: | Line 8: | ||
// Here, the variable <code>#SRSTR</code> is assigned the string '<code>44.1 kHz</code>'. | // Here, the variable <code>#SRSTR</code> is assigned the string '<code>44.1 kHz</code>'. | ||
Note that, unlike with the C-language <code>printf</code> formats, the first argument <code> | Note that, unlike with the C-language <code>printf</code> formats, the first argument <code>arg<sub>1</sub></code> is ''mandatory'' with the STx <code>format</code> command: | ||
#str := format 'How much wood would a wood chuck chuck?' 'dummy' | #str := format 'How much wood would a wood chuck chuck?' 'dummy' | ||
Here, dummy argument (in our case, the string constant <code>'dummy'</code> is mandatory, although it will not influence the result of the string "How much wood would a wood chuck chuck?" being assigned to the variable <var>#str</var>. | Here, dummy argument (in our case, the string constant <code>'dummy'</code> is mandatory, although it will not influence the result of the string "How much wood would a wood chuck chuck?" being assigned to the variable <var>#str</var>. | ||
Revision as of 12:16, 31 March 2011
var := FORMAT formatstring arg1 [ arg2 ... ]
format formats its arguments, interpreting the first argument as a format string (almost, but not quite unlike the C-language printf command. S_TOOLS-STx formats are described in Format Strings and Rules.
#srateHz := 44100 #SRSTR := FORMAT '%.1f kHz' '$#srateHz/1000' // Here, the variable#SRSTRis assigned the string '44.1 kHz'.
Note that, unlike with the C-language printf formats, the first argument arg1 is mandatory with the STx format command:
#str := format 'How much wood would a wood chuck chuck?' 'dummy'
Here, dummy argument (in our case, the string constant 'dummy' is mandatory, although it will not influence the result of the string "How much wood would a wood chuck chuck?" being assigned to the variable #str.
