The IDataInput interface provides a set of methods for reading binary data.
This interface is the I/O counterpart to the IDataOutput interface, which
writes binary data.
All IDataInput and IDataOutput operations are "bigEndian" by default (the most significant
byte in the sequence is stored at the lowest or first storage address),
and are nonblocking.
If insufficient data is available, an EOFError exception
is thrown. Use the IDataInput.bytesAvailable property to determine
how much data is available to read.
Sign extension matters only when you read data, not when you write it. Therefore you do not need separate
write methods to work with IDataInput.readUnsignedByte() and
IDataInput.readUnsignedShort(). In other words:
Use IDataOutput.writeByte() with IDataInput.readUnsignedByte() and
Use IDataOutput.writeShort() with IDataInput.readUnsignedShort() and
Returns the number of bytes of data available for reading
in the input buffer.
User code must call bytesAvailable to ensure
that sufficient data is available before trying to read
it with one of the read methods.
Implementation public function get bytesAvailable():uint
Reads the number of data bytes, specified by the length parameter,
from the file stream, byte stream, or byte array. The bytes are read into the
ByteArray objected specified by the bytes parameter, starting at
the position specified by offset.
bytes:ByteArray — The ByteArray object to read
offset:uint (default = 0) — The offset into the bytes parameter at which data
read should begin.
length:uint (default = 0) — The number of bytes to read. The default value
of 0 causes all available data to be read.
EOFError — There is not sufficient data available
Reads a multibyte string of specified length from the file stream, byte stream, or byte array using the
specified character set.
length:uint — The number of bytes from the byte stream to read.
charSet:String — The string denoting the character set to use to interpret the bytes.
Possible character set strings include "shift-jis", "cn-gb",
"iso-8859-1", and others.
For a complete list, see Supported Character Sets.
Note: If the value for the charSet parameter is not recognized by the current
system, then Adobe® Flash® Player or
Adobe® AIR® uses the system's default
code page as the character set. For example, a value for the charSet parameter, as in
myTest.readMultiByte(22, "iso-8859-01"), that uses 01 instead of
1 might work on your development system, but not on another system. On the other
system, Flash Player or the AIR runtime will use the system's
default code page.