mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-30 22:20:17 +00:00
75 lines
4.3 KiB
Text
75 lines
4.3 KiB
Text
|
The [[PRINT (file statement)|PRINT #]] statement prints numeric or string expressions to a file, port or device.
|
||
|
|
||
|
|
||
|
{{PageSyntax}}
|
||
|
::: '''PRINT #''fileNumber%''''', [ [{{Parameter|expression}}] [{;|,] ... ]
|
||
|
|
||
|
|
||
|
{{Parameters}}
|
||
|
* {{Parameter|fileNumber%}} is the file number of a file or device opened for writing. See {{KW|OPEN}}.
|
||
|
* {{Parameter|expression}} is a numeric or string expression to be written to the file. Quotes will be removed from strings.
|
||
|
* The print statement can be followed by a [[semicolon]] to stop the print cursor or a [[comma]] to tab the next print.
|
||
|
|
||
|
|
||
|
''Usage:''
|
||
|
* [[STRING]] values will be stripped of leading and trailing quotation marks when printed to the file. Use [[CHR$]](34) to add quotes to a file.
|
||
|
* {{Parameter|separator}} is used to separate multiple expressions and specifies how the file cursor is to be moved before writing the next expression. It can be one of the following:
|
||
|
** semi-colon (;) - specifies that the print cursor stop immediately after the print. A subsequent print will start there.
|
||
|
** comma (,) - specifies that the file cursor is to move to the next 14-column tab-stop. If the file cursor is at column 56 or greater, it is moved to the next file row at column 1.
|
||
|
* If {{Parameter|separator}} is not used at the end of the expression list, the file cursor moves to the next file row at column 1.
|
||
|
* PRINT # can use the '''+ concatenation''' operator or semicolons to combine strings.
|
||
|
* [[SPC]]({{Parameter|n%}}) - specifies that {{Parameter|n%}} space characters will be written in a print.
|
||
|
* [[TAB]]({{Parameter|column%}}) - specifies that the file cursor is to move to a column number {{Parameter|column%}}. If the file cursor is beyond that column, it is moved to that column on the next file row.
|
||
|
* When printing literal or variable numerical values the following rules apply:
|
||
|
** If the value is positive, the number is prefixed with a space character, otherwise, the number is prefixed with a negative sign (-).
|
||
|
** If the value is an [[INTEGER]] (whole number), no decimal point or fractional part will be written.
|
||
|
** If the value is not an integer (whole number) and has zero for a coefficient, no leading zero is written. For example, -0.123 is written as "-.123 "
|
||
|
** If a numeric literal is in scientific notation, the number is also written in scientific notation. [[PRINT USING (file statement)|PRINT #, USING]] can return actual rounded numerical values in string form.
|
||
|
** The numerical value is always followed by a space character unless [[STR$]] is used to convert it to a string value.
|
||
|
* Whenever [[PRINT (file statement)|PRINT #]] moves the file cursor to a new file row, a carriage return character ({{KW|CHR$|CHR$(13)}}) followed by a line feed character ({{KW|CHR$|CHR$(10)}}) is written. The combination are referred to as the "CRLF" character.
|
||
|
|
||
|
|
||
|
''Example:'' Prints data to a text file sequentially and reads it back to the program screen as one line of text.
|
||
|
{{CodeStart}} '' ''
|
||
|
filename$ = "testfile.dat"
|
||
|
x = 1: y = 2: z$ = "Three"
|
||
|
|
||
|
{{Cl|OPEN}} filename$ {{Cl|FOR...NEXT|FOR}} {{Cl|OUTPUT}} {{Cl|AS}} #1 'opens and clears an existing file or creates new empty file
|
||
|
|
||
|
{{Cl|PRINT (file statement)|PRINT}} #1, x, y, z$
|
||
|
|
||
|
{{Cl|CLOSE}} #1
|
||
|
|
||
|
{{Cl|PRINT}} "File created with data. Press a key!"
|
||
|
|
||
|
K$ = {{Cl|INPUT$}}(1) 'press a key
|
||
|
|
||
|
{{Cl|OPEN}} filename$ {{Cl|FOR (file statement)|FOR}} {{Cl|INPUT (file mode)|INPUT}} {{Cl|AS}} #2 'opens a file to read it
|
||
|
|
||
|
{{Cl|LINE INPUT (file statement)|LINE INPUT}} #2, text$
|
||
|
|
||
|
{{Cl|CLOSE}} #2
|
||
|
|
||
|
{{Cl|PRINT}} text$
|
||
|
{{Cl|WRITE}} text$
|
||
|
|
||
|
{{Cl|END}} '' ''
|
||
|
{{CodeEnd}}
|
||
|
: ''File content:'' [[PRINT (file statement)|PRINT]] string file values will not include the enclosing quotation marks but can be read by [[LINE INPUT (file statement)|LINE INPUT]] as text.
|
||
|
{{TextStart}} 1 2 Three'' '' {{TextEnd}}
|
||
|
: ''Screen output:'' [[PRINT]] string values will not display enclosing quotation marks. [[WRITE]] screen displays will.
|
||
|
{{OutputStart}} 1 2 Three
|
||
|
" 1 2 Three"
|
||
|
{{OutputEnd}}
|
||
|
|
||
|
|
||
|
{{PageSeeAlso}}
|
||
|
* [[SPC]], [[SPACE$]], [[TAB]]
|
||
|
* [[PRINT USING (file statement)|PRINT #, USING]]
|
||
|
* [[PRINT]], [[PRINT (TCP/IP statement)]]
|
||
|
* [[WRITE (file statement)|WRITE #]], [[INPUT (file statement)|INPUT #]]
|
||
|
* [[LINE INPUT (file statement)|LINE INPUT #]]
|
||
|
* [[OPEN]], [[LPRINT]], [[WRITE]]
|
||
|
|
||
|
|
||
|
{{PageNavigation}}
|