Print

From MultiCharts
Revision as of 13:53, 26 January 2012 by 194.84.116.138 (talk)
Jump to navigation Jump to 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.)

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")

Where: PathFilename - a string expression specifying the path and filename

Specifies an ASCII file as the output target; if the specified file does not exist, the file will be created.

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: "String Expression"


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.

Example

<syntaxhighlight>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: hard drive