|
|||||
|
|
|||||
| Streams: reopening | |||||
| Prerequisite Concepts | Related Syntax | ||||
The reopen action is used to open an existing or new object so that text can be appended to it. Unlike with open, the contents of the attached object are not erased when it is reopened.
As with open, it is an error to reopen a stream that is part of the current output.
When a stream is opened with referents-allowed, the entire stream is placed in escrow, not just the referents. If you reopen the stream with referents not allowed, anything you put to the stream will be output before the escrow material that was written with referents allowed.
When reopening a file, remember that there is no guarantee that another process has not changed a file between the time you closed it and the time you reopened it. Also, remember that a file that is opened with referents allowed is placed in escrow and not written to the file system until the referent scope ends. In this case, if you reopen the file with referents not allowed, an actual file is created at that time and the escrow material is lost.
For backwards compatibility, in the open and reopen...as actions only, break-width is allowed without a heralding with, &, or and. If the attachment is not specified, and the break-width open modifier is applied, then the appropriate with, &, or and herald must precede the break-width keyword. This form is deprecated, and is provided for compatibility with previous releases of OmniMark.
|
Prerequisite Concepts Arrays Streams: attachments |
Related Syntax and break-width open referents-allowed reopen |
| ---- |
