\(\text{FileWriteReal}\)

You can use the \(\text{FileWriteReal}\) function to write a real value to a file in single precision or double precision format.

You can use the \filewritereal backslash command to insert this function.

The following variants of this function are available:

  • \(\text{boolean } \text{FileWriteReal} \left ( \text{<file number>}, \text{<real value>} \right )\)

  • \(\text{boolean } \text{FileWriteReal} \left ( \text{<file number>}, \text{<real value>}, \text{<size/endian>} \right )\)

The \(\text{<file number>}\) parameter is an integer value returned by the \(\text{FileOpenWrite}\) or \(\text{FileOpenWriteTruncate}\) functions. The \(\text{<real value>}\) parameter holds the real value to be written. The \(\text{<size/endian>}\) parameter can be used to specify how the real value should be written.

If the \(\text{<size/endian>}\) parameter is excluded or if the \(\text{size/endian}\) parameter is zero, the function will write the real value as a decimal string using either a fixed point notation such as -123.4 or in scientific notation such as -1.234E2.

If the \(\text{<size/endian>}\) parameter is +4 or +8, the real value will be written in single precision or double precision little-endian floating point format conforming with IEEE 754-2008.

If the \(\text{<size/endian>}\) parameter is -4 or -8, the real value will be written in single precision or double precision big-endian floating point format conforming with IEEE 754-2008.

The \(\text{FileWriteReal}\) function returns true on success or false on failure.

The Figure 137 shows how you can use the \(\text{FileWriteReal}\) function.