PRINT USING (file statement)

From QB64 Wiki
Revision as of 20:23, 9 January 2015 by imported>Clippy
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The PRINT #, USING statement is used to PRINT formatted text data to a file.


Syntax

PRINT filenumber%, [text${;|,}] USING template$; variable[; ...][{;|,}]


Parameters

  • INTEGER filenumber refers to the file number OPENed previously followed by a comma.
  • Literal or variable STRING text$ can be placed between PRINT and USING or it can be included in the template.
  • A semicolon or comma may follow the text to stop or tab the print cursor before the template PRINT.
  • The literal or variable STRING template should use the template symbols to display each variable type in the list following it.
  • The list of data variables used in the template are separated by semicolons after the template string value.
  • In QB64 ONE semicolon or comma may follow the variable list to stop the print cursor for pending prints. QB only allowed a semicolon.


Usage:

  • If the template string is omitted or symbols don't match the variable(s) an "Illegal Function Call" ERROR will occur!
  • 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 integer digit range a % symbol will appear in the leftmost digit area.
  • WARNING: The numbers displayed are rounded so the actual values are never changed and are actually more accurate.


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.


See also:



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page