form

Format: form( template, values, fill )

Arguments: (text) template Block of text describing the format of the output text

[any] values List of values for each fill field

(text) fill Optional character used to define fill fields; default = "^"

Returns: (text) Block of text similar to the template argument with all fill fields replaced by the corresponding elements in values

Description: Form is used to create formatted output. The template argument contains all text that will appear on the output plus a string of fill characters (e.g., ^^^^) wherever a fill field appears. Each element in the values argument is converted to a text string and substituted for the corresponding fill field. If the text string is longer than the corresponding field, the text is truncated.

Form is designed to be complementary to the dialog input primitive. Use the say, write, or append primitives to cause the block of text created to be output.

Examples: form("Name: ^^^^^^^^  Age: ^^^", ["Rob",29]) =
Name: Rob       Age: 29

See Also: dialog, say, write, append