IDataOutput - Adobe ActionScript® 3 (AS3 )

Пакет	flash.utils
Интерфейс	public interface IDataOutput
Средство реализации	ByteArray, FileStream, Socket

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

В интерфейсе IDataOutput предусмотрен набор методов для записи двоичных данных. В операциях ввода-вывода этот интерфейс дополняет интерфейс IDataInput, который считывает двоичные данные. Интерфейс IDataOutput реализован в классах FileStream, Socket и ByteArray.

По умолчанию все операции IDataInput и IDataOutput используют порядок bigEndian (у старшего байта последовательности меньший адрес), и являются неблокирующими.

Расширение знака имеет значение только при чтении данных, но не при их записи. Поэтому для работы с IDataInput.readUnsignedByte() и IDataInput.readUnsignedShort() не требуется создавать отдельные методы записи. Другими словами:

IDataOutput.writeByte() используется с IDataInput.readUnsignedByte() и IDataInput.readByte().
IDataOutput.writeShort() используется с IDataInput.readUnsignedShort() и IDataInput.readShort().

Посмотреть примеры

Связанные элементы API

Интерфейс IDataInput
endian
Класс FileStream
Класс Socket
Класс URLStream
Класс ByteArray

Общедоступные свойства

	Свойство		Определено
		endian : String Порядок байтов данных, константа BIG_ENDIAN или LITTLE_ENDIAN класса Endian.	IDataOutput
		objectEncoding : uint Указывает, какой формат, AMF3 или AMF0, используется для записи или чтения двоичных данных с помощью метода writeObject().	IDataOutput

Общедоступные методы

	Метод		Определено
		writeBoolean(value:Boolean):void Записывает логическое значение.	IDataOutput
		writeByte(value:int):void Записывает байт.	IDataOutput
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Записывает последовательность байтов из заданного массива байт bytes, начиная с байта, заданного параметром offset (используя индекс с нулевой базой), длиной, заданной параметром length, в поток файлов, байтов или массив байтов.	IDataOutput
		writeDouble(value:Number):void Записывает число IEEE 754 с двойной точностью (64-разрядное) и плавающей запятой.	IDataOutput
		writeFloat(value:Number):void Записывает число IEEE 754 с одинарной точностью (32-разрядное) и плавающей запятой.	IDataOutput
		writeInt(value:int):void Записывает 32-разрядное целое число со знаком.	IDataOutput
		writeMultiByte(value:String, charSet:String):void Записывает в поток файлов, байтов или массив байтов многобайтовую строку заданной длины с использованием заданного набора символов.	IDataOutput
		writeObject(object:*):void Записывает объект в поток файлов, байтов или массив байтов в сериализованном формате AMF.	IDataOutput
		writeShort(value:int):void Записывает 16-разрядное целое число.	IDataOutput
		writeUnsignedInt(value:uint):void Записывает 32-разрядное целое число без знака.	IDataOutput
		writeUTF(value:String):void Записывает в поток файлов, байтов или массив байтов строку UTF-8.	IDataOutput
		writeUTFBytes(value:String):void Записывает строку UTF-8.	IDataOutput

Сведения о свойстве

endian

свойство

endian:String

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Порядок байтов данных, константа BIG_ENDIAN или LITTLE_ENDIAN класса Endian.

Реализация
public function get endian():String
public function set endian(value:String):void

Связанные элементы API

Класс Endian

objectEncoding

свойство

objectEncoding:uint

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Указывает, какой формат, AMF3 или AMF0, используется для записи или чтения двоичных данных с помощью метода writeObject(). Значение представлено константой из класса ObjectEncoding.

Реализация
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void

Связанные элементы API

IDataInput.readObject()
writeObject()
Класс ObjectEncoding

Сведения о методе

writeBoolean

()

метод

public function writeBoolean(value:Boolean):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает логическое значение. Записывается один байт, соответствующий параметру value, 1 в случае значения true и 0 в случае значения false.

Параметры

value:Boolean — Логическое значение, показывающее, какой байт записывается. Если параметр имеет значение true, записывается 1; если false, записывается 0.

writeByte

()

метод

public function writeByte(value:int):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает байт. Используются 8 младших битов параметра, а 24 старших битов игнорируются.

Параметры

value:int — Значение байта в виде целого числа.

writeBytes

()

метод

public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает последовательность байтов из заданного массива байтов bytes, начиная с байта, заданного параметром offset (используя индекс с нулевой базой), длиной, заданной параметром length, в поток файлов, байтов или массив байтов.

Если параметр length опущен, применение длины по умолчанию, равной 0, приведет к тому, что будет записан весь буфер, начиная со значения параметра offset. Если также опустить параметр offset, будет записываться весь буфер.

Если параметры offset или length находятся за пределами диапазона, то они корректируются так, чтобы совпасть с началом и концом массива bytes.

Параметры

	`bytes:ByteArray` — Массив байтов для записи.

	`offset:uint` (default = `0`) — Индекс с нулевой базой, определяющий положение в массиве для начала записи.

	`length:uint` (default = `0`) — Целое число без знака, определяющее глубину буфера для записи.

writeDouble

()

метод

public function writeDouble(value:Number):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает число IEEE 754 с двойной точностью (64-разрядное) и плавающей запятой.

Параметры

value:Number — Число с двойной точностью (64-разрядное) и плавающей запятой.

writeFloat

()

метод

public function writeFloat(value:Number):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает число IEEE 754 с одинарной точностью (32-разрядное) и плавающей запятой.

Параметры

value:Number — Число с одинарной точностью (32-разрядное) и плавающей запятой.

writeInt

()

метод

public function writeInt(value:int):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает 32-разрядное целое число со знаком.

Параметры

value:int — Значение байта в виде целого числа со знаком.

writeMultiByte

()

метод

public function writeMultiByte(value:String, charSet:String):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает в поток файлов, байтов или массив байтов многобайтовую строку заданной длины с использованием заданного набора символов.

Параметры

	`value:String` — Записываемое значение строки.

	`charSet:String` — Строка, определяющая используемый набор символов. Возможные строки наборов символов: `"shift_jis"`, `"cn-gb"`, `"iso-8859-1"` и другие. Полный список см. в разделе Поддерживаемые наборы символов.

writeObject

()

метод

public function writeObject(object:*):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает объект в поток файлов, байтов или массив байтов в сериализованном формате AMF.

Параметры

object:* — Объект для сериализации.

Связанные элементы API

objectEncoding
flash.net.registerClassAlias()

writeShort

()

метод

public function writeShort(value:int):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает 16-разрядное целое число. Используются 16 младших битов параметра, а 16 старших битов игнорируются.

Параметры

value:int — Значение байта в виде целого числа.

writeUnsignedInt

()

метод

public function writeUnsignedInt(value:uint):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает 32-разрядное целое число без знака.

Параметры

value:uint — Значение байта в виде целого числа без знака.

writeUTF

()

метод

public function writeUTF(value:String):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает в поток файлов, байтов или массив байтов строку UTF-8. Сначала записывается длина строки UTF-8 в байтах (в виде 16-разрядного целого числа), за которой следуют байты символов строки.

Параметры

value:String — Записываемое значение строки.

Выдает

RangeError — Если длина превышает 65535.

writeUTFBytes

()

метод

public function writeUTFBytes(value:String):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Записывает строку UTF-8. Аналогично writeUTF(), но строке не предшествует 16-разрядное слово, указывающее длину.

Параметры

value:String — Записываемое значение строки.

Примеры Использование этого примера

DataOutputExample.as

В следующем примере класс DataOutputExample используется для записи в массив байтов логического значения и представления числа «пи» с двойной точностью и плавающей запятой. Это можно сделать, выполнив следующие действия:

Объявляется новый экземпляр объекта ByteArray byteArr.
Записывается эквивалент байтового логического значения false и эквивалент числа «пи» с двойной точностью и плавающей запятой.
Считывается логическое значение и число двойной точности с плавающей запятой.

Обратите внимание на то, что в конце добавляется сегмент кода для проверки ошибок конца файла. Это позволяет прекратить считывание потока байтов по достижении его окончания.

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

    public class DataOutputExample extends Sprite {        
        public function DataOutputExample() {
            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.
            }
        }
    }
}

Юридическая информация | Политика конфиденциальности онлайн

IDataOutput - AS3

Классы x

endian

objectEncoding

writeBoolean

writeByte

writeBytes

writeDouble

writeFloat

writeInt

writeMultiByte

writeObject

writeShort

writeUnsignedInt

writeUTF

writeUTFBytes