log

Log a string to a file.

Syntax

status = log ( [ file [ , text ] ] ) ;

Arguments

list file (optional)

• The file in which to log to.
• When only this argumment is specified, then the log file name is changed.
• When no arguments are specified, the log file name defaults to stdout.

string text (optional)

• The text in which to output.
• When this argument is not specified, only the log file name is changed.

Return Value

str status

• $ACKNOWLEDGE

  The log() function was successful.

  The STATUS variable is set to $ACKNOWLEDGE

Exceptions

%ARGUMENT : Invalid arguments. Usage: status = log ( [ file [ , text ] ] ) ;

%BOUNDS : Subscript is out of bounds in log()

Description

None

Examples

To execute the example below, press or modify the example to try different variations. puts "Create an example for the function 'log'" ;

Related Links

None