44.4. $pageWrite

$pageWrite writes numPages pages of data from the ADDRESS memAdr to f, starting at page startPage in the file (the first page is numbered zero). A page is $pageSize storage units. If numPages is less than or equal to zero, one page is written.

Unless f is opened for random access, $pageWrite succeeds only if the file is positioned at the start of the page to be written; otherwise, an error message is given.

$pageWrite may be especially efficient if the file was opened with the $unbuffered bit.

$storageUnitWrite and $characterWrite are other PROCEDUREs used to write large amounts of data to a file with a single PROCEDURE call.

$pageWrite does not modify or translate data from files opened for PDF I/O, since it has no way to know the data type(s) of the data written.