Programmer Guide/Command Reference/FORMAT: Difference between revisions

From STX Wiki
Jump to navigationJump to search
m (Text replace - "S_TOOLS-STx" to "{{STX}}")
m (Text replace - " STx " to " {{STX}} ")
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>arg<sub>1</sub></code> is ''mandatory'' with the STx <code>format</code> command:
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 18:16, 5 April 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. STx formats are described in Format Strings and Rules.

#srateHz := 44100
#SRSTR := FORMAT '%.1f kHz' '$#srateHz/1000'
// Here, the variable #SRSTR is 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.

Navigation menu

Personal tools