Difference between revisions of "Print"
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]] |
Revision as of 11:48, 7 February 2012
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.
- The default output format for a numerical expression is two decimal places and a minimum of seven characters.
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.