Print

From MultiCharts
Jump to: navigation, search

Sends one or more specified expressions to the PowerLanguage Editor Output Log or another output target, if specified. Any combination of string, true/false, numerical series, or numerical expressions can be specified.

Usage

Print([OutputTarget],Expression1,Expression2,etc.)

The parameter inside the square brackets is optional.

Parameters

OutputTarget - an optional parameter; specifies an output target other then the PowerLanguage Editor Output Log; the parameter must be followed by a comma.
There are two optional output targets:
Printer - Specifies the default printer as the output target.
File("PathFilename") - Specifies an ASCII file as the output target; if the specified file does not exist, the file will be created.
Where:
PathFilename - a string expression specifying the path and filename.
If OutputTarget is not specified, the output will be sent to the PowerLanguage Editor Output Log.
Expression - a string, true/false, numerical series, or numerical expression. Any number of valid expressions, separated by commas, can be used.
A string expression must be enclosed in quotation marks. For example: Print("Hello World!");
A numerical expression can be formatted to specify the minimum number of characters, including the decimal point, and the number of decimal places to be used for the output:
Expression:C:D
Where:
C - minimum number of characters,
D - number of decimal places.
The default output format for a numerical expression is two decimal places and a minimum of seven characters.
If the number of decimal places in the numerical expression is more than the specified number, the value will be will be rounded off to the specified number of decimal places.
If the number of characters in the output is less than the specified minimum, leading spaces will be added to bring the output to the specified minimum value.

Examples

Print(.1);

Will print 0.10 in the PowerLanguage Editor Output Log, with three leading spaces inserted.

Print(1.555555:6:3);

Will print 1.556 in the PowerLanguage Editor Output Log, with one leading space inserted.

Print(Printer,"Print Test");

Will send the string expression "Print Test" to the default printer.

Print(File("C:\test.txt"),CurrentDate,CurrentTime);

Will save the output of CurrentDate and CurrentTime to the 'test.txt' file in the root directory of the C: drive.