Print: Difference between revisions
From MultiCharts
no edit summary
No edit summary |
|||
Line 1: | Line 1: | ||
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. | 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 == | |||
<syntaxhighlight>Print([OutputTarget],Expression1,Expression2,etc.)</syntaxhighlight> | <syntaxhighlight>Print([OutputTarget],Expression1,Expression2,etc.)</syntaxhighlight> | ||
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''''' | ::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 == | |||
<syntaxhighlight>Print(.1);</syntaxhighlight> | |||
Will print 0.10 in the PowerLanguage Editor Output Log, with three leading spaces inserted. | |||
<syntaxhighlight>Print(1.555555:6:3);</syntaxhighlight> | |||
<syntaxhighlight>Print(. | Will print 1.556 in the PowerLanguage Editor Output Log, with one leading space inserted. | ||
inserted | |||
Print( | <syntaxhighlight>Print(Printer,"Print Test");</syntaxhighlight> | ||
Will send the string expression "Print Test" to the default printer. | |||
<syntaxhighlight>Print(File("C:\test.txt"),CurrentDate,CurrentTime);</syntaxhighlight> | |||
Will save the output of [[CurrentDate]] and [[CurrentTime]] to the 'test.txt' file in the root directory of the C: drive. | |||
Print(File("C:\test.txt"),CurrentDate,CurrentTime); | |||
CurrentTime to the test.txt file in the root directory of the C: | |||
[[Category:Output]] | [[Category:Output]] |