previous next top contents index framed top this page unframed
Figure 32–10. $characterWrite
| PROCEDURE $characterWrite (POINTER(textFile) f; LONG INTEGER numCharacters; CHARADR memCharadr; OPTIONAL BITS ctrlBits); |
$characterWrite is the text file counterpart to $storageUnitWrite, which works only on data files.
$characterWrite writes numCharacters characters from memory starting at memCharadr to f. The effect is undefined if inaccessible memory is specified. If the file is opened for PDF I/O, the characters by default are translated from the host to the PDF character set.
The only valid ctrlBits bit is $noTranslate. If it is set and f is open for PDF I/O, no character translation from the host to the PDF character set is done.
$characterWrite may be called for an unbuffered file (a file opened with the $unbuffered bit set); see Section 43.5.
MAINSAIL Language Manual, Section 32.12