Difference between revisions of "PRINT USING"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
m
imported>Clippy
m
Line 14: Line 14:
  
  
<center>'''Template is a literal or variable [[STRING|string]] using the following formatting characters:'''
+
{{PrintUsing}}
 
 
 
 
{| border=1]]
 
|-
 
| '''&''' || 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.
 
|-
 
| '''.''' || Denotes a number's decimal point position. Also determines value accuracy.
 
|-
 
|  ''',''' || Placed to left of decimal point, prints a comma every 3 places left of the decimal point.
 
|-
 
|  '''+''' || 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 non-zero digit position of the numerical value.
 
|-
 
| '''**'''  || Prints an asterisk in any leading empty spaces of a numerical value. Specifies 2 extra digit positions.
 
|-
 
|'''**$''' || Combines ** and $. Negative values will display minus sign to left of $.
 
|-
 
|'''_''' || Underscore prints the next character as a literal string value instead of a format symbol
 
|}
 
 
 
'''Note: Any string character not listed above will be printed as a literal character!</center>
 
 
 
 
 
  
  

Revision as of 17:48, 20 August 2012

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


Syntax

PRINT [text${;|,}] USING template$; variable; list; ...etc[{;|,}]


  • Preceding literal or variable text$ can be placed between PRINT and USING or it can be included in the template.
  • 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.
  • No more than 25 # digit places are allowed in a template number or an error will occur.
  • Can convert numerical exponential or scientific notation values to normal decimal point values.
  • NOTE: If the numerical value exceeds the template's integer digit range a % symbol will appear in the leftmost digit area.


Template is a literal or variable string using the following formatting characters:


  & Prints an entire string value. STRING 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. Exclamation points require underscore prefix.
  # Denotes a numerical digit. An appropriate number of digits should be used for values received.
^^^^ After # digits prints numerical value in exponential E+xx format. Use ^^^^^ for E+xxx values.*
  . Period sets a number's decimal point position. Digits following determine rounded value accuracy.
  ,. Comma to left of decimal point, prints a comma every 3 used # digit places left of the decimal point.
  + Plus sign denotes the position of the number's sign. + or - will be displayed.
  - Minus sign (dash) placed after the number, displays only a negative value's sign.
  $$ Prints a dollar sign immediately before the highest non-zero # digit position of the numerical value.
  ** Prints an asterisk in any leading empty spaces of a numerical value. Adds 2 extra digit positions.
 **$ Combines ** and $$. Negative values will display minus sign to left of $.
  _ Underscore preceding a format symbol prints those symbols as literal string characters.

Note: Any string character not listed above will be printed as a literal text character.

* Any # decimal point position may be specified. The exponent is adjusted with significant digits left-justified.


Example: Printing formatted data using a predefined string template variable.

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

Salesperson: Bobby Smith 1,510 $4,530.00

Explanation: The Salesperson: text precedes 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:



Navigation:
Keyword Reference - Alphabetical
Keyword Reference - By Usage
Main Wiki Page