PRINT USING (file statement)

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.

Table 5: The formatting symbols used by the [L]PRINT USING[#] commands. ┌───────┬────────────────────────────────────────────────────────────────┐ │ & │ 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. │ ├───────┼────────────────────────────────────────────────────────────────┤ │ # │ 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. (1) │ ├───────┼────────────────────────────────────────────────────────────────┤ │ . │ 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. (1) Any # decimal point position may be specified. The exponent is adjusted with significant digits left-justified.

See also

• PRINT USING, PRINT #
• LPRINT USING

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage