FileTools[Binary][Write] - write binary data to a file
|
Calling Sequence
|
|
Write(file, rtab, opt1, opt2, ...)
Write(file, type, data, opt1, opt2, ...)
|
|
Parameters
|
|
file
|
-
|
file descriptor or filename
|
type
|
-
|
type of data to write
|
data
|
-
|
set or list
|
rtab
|
-
|
rtable
|
opt1, opt2, ...
|
-
|
(optional) argument of the form 'name' or 'name'=value
|
|
|
|
|
Description
|
|
•
|
The Write(file, rtab) command writes the elements from the rtable rtab to file. The Write function automatically determines the type from rtab. Therefore, the data type of rtab must supported by Write.
|
•
|
The Write(file, type, data) command writes the elements from data to file in type format.
|
•
|
There are two optional arguments for the Write command: byteorder and notrunc.
|
•
|
The byteorder argument specifies the order in which bytes are written for multi-byte data types. The byteorder function can have one of four values: big, little, network, and native.
|
|
- big and little specify big endian and little endian respectively
|
|
- network specifies network ordering (big endian)
|
|
- native uses the byte ordering of the current platform
|
|
If byteorder is not specified it defaults to network.
|
•
|
The default byte order for Write and Read is a system independent format. This means that if the default is used binary files can be exchanged across platforms without conversion.
|
•
|
The notrunc argument controls the behavior when an integer value does not fit in the given hardware type. By default the integer is truncated and written as the hardware value nearest to the requested value. If notrunc is specified an exception is raised and the write will be incomplete. The notrunc argument has no effect when writing floating-point values. Floats with large positive exponents, are represented as positive or negative floating-point infinity, (see Float). Those with large negative exponents are represented by floating-point zero.
|
•
|
If file is the name of a file that has not been opened, Maple attempts to open the file before attempting to read the data.
|
•
|
An error is raised if file is not a valid descriptor or if it is the name of a file that does not exists.
|
|
|
Examples
|
|
>
|
|
| (1) |
>
|
|
| (2) |
>
|
|
| (3) |
>
|
|
>
|
|
| (4) |
>
|
|
>
|
|
| (5) |
>
|
|
|
|