Name
ReadInt -- read an integer from a file (V2.0)
Synopsis
int = ReadInt(id[, flags])
Function
This function reads an integer from the file specified by id and returns it. Reading starts from the current file cursor position which you can modify using the Seek() command. By default, ReadInt() will read a 32-bit integer, advancing the file cursor by 4 bytes.

The flags parameter may be a combination of the following flags:

#IO_SIGNED:
The return value will be signed and will range from -2147483648 to 2147483647 (if #IO_FAKE64 isn't set). This is the default.

#IO_UNSIGNED:
The return value will be unsigned and will range from 0 to 4294967295. This cannot be combined with #IO_FAKE64.

#IO_LITTLEENDIAN:
By default, this function expects the data to be stored in big endian format (most significant byte first). You can set this flag to request this function to use the little endian format instead.

#IO_FAKE64:
Use 64-bit integers. This is called "fake 64" because Hollywood can't use the full 64-bit integer range because its numeric type is a 64-bit floating point value which can't represent exactly the same range as a true 64-bit integer value. Still, Hollywood's fake 64-bit integers should be large enough for almost anything. Using #IO_FAKE64 you can read integers in the range of -9007199254740992 to 9007199254740992. Note that #IO_UNSIGNED can't be used with #IO_FAKE64. Hollywood's fake 64-bit integers will always be signed. (V9.0)

Inputs
id
file to read data from
flags
optional: additional flags (see above) (defaults to #IO_SIGNED) (V9.0)
Results
int
integer value

Show TOC