5.4.5.9 Write Statement

Note

This section describes the implementation of MS-VBAL §5.4.5.9 Write Statement.

Syntax

AST node	Instruction kind(s)	Notes
PrintStatementNode	`Simple`	`Token`: `Write`.

See RD-VBAL §3.4.3 File Statements.

Runtime Semantics

Write # and Input # use one text format: Write # writes it, and Input # reads it (RD-VBAL §5.4.5.10 Input Statement).

Text Format

Value	Written as
`String`	A quoted string.
`Boolean` `True`	`#TRUE#`
`Null`	`#NULL#`
An `Error` value	`#ERROR n#`, where `n` is the error value's number.
`Date`	`#yyyy-mm-dd hh:mm:ss#`
An object	What it stands for, its default member's value, let-coerced to `String` and quoted (`"7"` for an Excel range that holds 7), as in MS-VBA (recorded in Excel). `Nothing` is error 91, and an object whose default member takes an argument (a `Collection`) error 450.

A Variant is written as the value it holds, through a Variant within a Variant: a Boolean, Null, Error, Date or number held in a Variant takes the form of its own type above, as MS-VBAL §5.4.5.9's rules are about an output expression's data value.

The spellings are fixed, whatever the regional settings of the session's environment: a number's decimal separator is ., and a date's separators and year are those above, in the Gregorian calendar. They are the spellings Input # reads back.

Implementation

Write # writes through the channel's character output surface, IFileChannelOutput, which it shares with Print #. Width # sets that surface's maximum line length (RD-VBAL §5.4.5 File Statements).