Difference between revisions of "PRINT USING"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
m
imported>Aoeu
Line 1: Line 1:
 
The '''PRINT USING''' statement is used to [[PRINT]] formatted data to the Screen or a file using a [[STRING]] template.
 
The '''PRINT USING''' statement is used to [[PRINT]] formatted data to the Screen or a file using a [[STRING]] template.
  
 +
==Syntax==
  
 
+
PRINT [#,] USING; template$; variable; list; ...etc.
''Syntax:'' PRINT [#,] USING; template$; variable; list; ...etc.
 
  
  
 
* Template is a literal or variable [[STRING]] using the following formatting characters.  
 
* Template is a literal or variable [[STRING]] using the following formatting characters.  
  
 
+
{| style="border: 1px; border-color: black;"
:: '''&''' prints an entire string value. Length should be limited as template width will vary.
+
|-
:: '''\''' denotes the start and end point of a fixed string area with spaces between(LEN = spaces + 2).  
+
| '''&''' || prints an entire string value. Length should be limited as template width will vary.
:: '''!''' prints only the leading character of a string value.
+
|-
:: '''#''' denotes a numerical digit. An appropriate number of digits should be used for values received.
+
| '''\''' || denotes the start and end point of a fixed string area with spaces between(LEN = spaces + 2).  
:: '''^^^^''' prints a numerical value in exponential format.
+
|-
:: '''.''' period denotes a number's decimal point position. Also determines value accuracy.
+
| '''!''' || prints only the leading character of a string value.
:: ''',''' a comma placed before the decimal point prints a comma in a numerical value every 3 places.
+
|-
:: '''+''' denotes position of the number's sign.
+
| '''#''' || denotes a numerical digit. An appropriate number of digits should be used for values received.
:: '''-''' placed after the number displays the number's sign after the number (negative only).
+
|-
:: '''$$''' prints a dollar sign immediately before the highest digit of the numerical value.
+
| '''^^^^''' || prints a numerical value in exponential format.
:: '''**''' prints an aterisk in any leading spaces of a string value.
+
|-
:: '''**$''' combines ** and $.
+
| '''.''' || period denotes a number's decimal point position. Also determines value accuracy.
 
+
|-
 +
''',''' || a comma placed before the decimal point prints a comma in a numerical value every 3 places.
 +
|-
 +
'''+''' || denotes position of the number's sign.
 +
|-
 +
| '''-''' || placed after the number displays the number's sign after the number (negative only).
 +
|-
 +
| '''$$''' || prints a dollar sign immediately before the highest digit of the numerical value.
 +
|-
 +
| '''**''' || prints an asterisk in any leading spaces of a string value.
 +
|-
 +
|'''**$''' || combines ** and $.
 +
|}
  
 
* The list of data variables used in the template are '''separated by semicolons''' after the template string value.  
 
* The list of data variables used in the template are '''separated by semicolons''' after the template string value.  

Revision as of 03:07, 27 December 2009

The PRINT USING statement is used to PRINT formatted data to the Screen or a file using a STRING template.

Syntax

PRINT [#,] USING; template$; variable; list; ...etc.


  • Template is a literal or variable STRING using the following formatting characters.
& prints an entire string value. Length should be limited as template width will vary.
\ denotes the start and end point of a fixed string area with spaces between(LEN = spaces + 2).
! prints only the leading character of a string value.
# denotes a numerical digit. An appropriate number of digits should be used for values received.
^^^^ prints a numerical value in exponential format.
. period denotes a number's decimal point position. Also determines value accuracy.
, a comma placed before the decimal point prints a comma in a numerical value every 3 places.
+ denotes position of the number's sign.
- placed after the number displays the number's sign after the number (negative only).
$$ prints a dollar sign immediately before the highest digit of the numerical value.
** prints an asterisk in any leading spaces of a string value.
**$ combines ** and $.
  • The list of data variables used in the template are separated by semicolons after the template string value.
  • The variables should be listed in the order that they are used in the template from left to right.
  • Normal text is allowed in the template also (see example).
  • NOTE: If the numerical value exceeds the template's digit range a type symbol will appear in the leftmost digit area.


Example:

tmp$ = "Salesperson: & & #####,. $$#####,.##"
PRINT USING tmp$; first$; last$; boxes%; sales!


Screen results: Salesperson: Bobby Smith 1,510 $4,530.00

Explanation: "Salesperson:" text preceeds the formatted data. The name lengths will change the length of the string template accordingly so columns will not all line up. If \ \ was used, the columns would stay the same, but parts of some names might be lost. If the box or sales values exceed 3 digits, a comma is used in the value every 3 digits.


See also: PRINT, PRINT #, USING


Navigation:

Go to Keyword Reference - Alphabetical

Go to Keyword Reference - By usage