Writes bytes to a file.
call "CBL_WRITE_FILE" using file-handle file-offset byte-count flags buffer
Using call prototype (see Library Routines - Key) | Picture (32-bit systems) | |
---|---|---|
file-handle | cblt-bytestream-handle | pic x(4) comp-5. |
file-offset | cblt-x8-compx | pic x(8) comp-x. |
byte-count | cblt-x4-compx | pic x(4) comp-x. |
flags | cblt-x1-compx | pic x comp-x. |
buffer | pic x(n). | pic x(n). |
file-handle | The file handle returned when the file was opened. | ||
file-offset | The offset in the file at which to write. This field is currently limited to a maximum value of x"00FFFFFFFF". | ||
byte-count | The number of bytes to write.
Putting a value of zero in this field causes the file to be truncated or extended to the size specified in the file-offset field. | ||
flags | This parameter can take the following value:
| ||
buffer | The buffer from which the bytes are written. It is your responsibility to ensure that the buffer is large enough to hold the number of bytes to be written. |
None
The success of the call can be checked by examining RETURN-CODE.