Output, Formatting, and Error Functions

These functions write output, build formatted text, control output, or intentionally raise user errors.

Clears the active output target when possible.

Returns: OK result.

Example:

clear();
print('Output was cleared');

Enables or disables output for the current output sink.

Returns: boolean-style number with the new enabled state.

Example:

enable_print(false);
print('hidden');
enable_print(true);
print('visible');

Builds an error message from all arguments and raises a user error.

Returns: does not return normally.

Example:

if(feed <= 0)
{
    error('Invalid feed: ', feed);
};

Writes values to the current output stream and appends a newline.

Returns: OK result.

Example:

print('X=', x, ', Y=', y);

Formats values, writes the result to output, and appends a newline.

Returns: OK result.

Example:

printf('X={}, Y={}', x, y);
printf('Tool {:d}', toolNumber);

Integer format specifiers convert numeric arguments to integer values before formatting.

Builds and returns text from all arguments.

Returns: string.

Example:

text = sprint('X=', x, ', Y=', y);

Formats values and returns the formatted text.

Returns: string.

Example:

line = sprintf('X={}, Y={}', x, y);

Previous: Strings

Next: Dialogs, Clipboard, Platform, and Paths