IDataInput  - AS3

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.

The byte order for the data, either the BIG_ENDIAN or LITTLE_ENDIAN constant from the Endian class.

Related API Elements

Used to determine whether the AMF3 or AMF0 format is used when writing or reading binary data using the readObject() method. The value is a constant from the ObjectEncoding class.

Related API Elements

Reads a Boolean value from the file stream, byte stream, or byte array. A single byte is read and true is returned if the byte is nonzero, false otherwise.

Reads a signed byte from the file stream, byte stream, or byte array.

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.

Parameters

Reads an IEEE 754 double-precision floating point number from the file stream, byte stream, or byte array.

Reads an IEEE 754 single-precision floating point number from the file stream, byte stream, or byte array.

Reads a signed 32-bit integer from the file stream, byte stream, or byte array.

Reads a multibyte string of specified length from the file stream, byte stream, or byte array using the specified character set.

Parameters

Reads an object from the file stream, byte stream, or byte array, encoded in AMF serialized format.

Related API Elements

Reads a signed 16-bit integer from the file stream, byte stream, or byte array.

Reads an unsigned byte from the file stream, byte stream, or byte array.

Reads an unsigned 32-bit integer from the file stream, byte stream, or byte array.

Reads an unsigned 16-bit integer from the file stream, byte stream, or byte array.

Reads a UTF-8 string from the file stream, byte stream, or byte array. The string is assumed to be prefixed with an unsigned short indicating the length in bytes.

This method is similar to the readUTF() method in the Java^® IDataInput interface.

Reads a sequence of UTF-8 bytes from the byte stream or byte array and returns a string.

Parameters

1. Declare a new ByteArray object instance byteArr.
2. Write the byte-equivalent value of the Boolean false and the double-precision floating-point equivalent of the mathematical value of pi.
3. Read back the boolean and double-precision floating-point number.

Notice how a code segment is added at the end to check for end of file errors to ensure that the byte stream is not read past its end.

package {
    import flash.display.Sprite;
    import flash.utils.ByteArray;
    import flash.errors.EOFError;

    public class DataInputExample extends Sprite {        
        public function DataInputExample() {
            var byteArr:ByteArray = new ByteArray();

            byteArr.writeBoolean(false);
            byteArr.writeDouble(Math.PI);
            
            byteArr.position = 0;

            try {
                trace(byteArr.readBoolean()); // false
            } 
            catch(e:EOFError) {
                trace(e);           // EOFError: Error #2030: End of file was encountered.
            }
            
            try {
                trace(byteArr.readDouble());    // 3.141592653589793
            } 
            catch(e:EOFError) {
                trace(e);           // EOFError: Error #2030: End of file was encountered.
            }
            
            try {
                trace(byteArr.readDouble());
            } 
            catch(e:EOFError) {
                trace(e);        // EOFError: Error #2030: End of file was encountered.
            }
        }
    }
}