Число байт данных, доступных для чтения от текущей позиции в массиве байт до конца массива.

Каждый раз, когда выполняется доступ к объекту ByteArray, в сочетании с методами чтения следует использовать свойство bytesAvailable. Это позволит обеспечить чтение действительных данных.

Обозначает кодировку объекта по умолчанию класса ByteArray для использования в новом экземпляре ByteArray. При создании экземпляра ByteArray используется значение кодировки defaultObjectEncoding. Свойство defaultObjectEncoding инициализируется в ObjectEncoding.AMF3.

Когда объект записывается или считывается из двоичных данных, свойство objectEncoding указывает используемую версию формата: формат ActionScript 3.0, ActionScript 2.0 или ActionScript 1.0. Значение представлено константой из класса ObjectEncoding.

См. также

Изменяет или считывает порядок байт данных: Endian.BIG_ENDIAN или Endian.LITTLE_ENDIAN.

См. также

Длина объекта ByteArray в байтах.

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

Если длина установлена в значение, меньшее текущей длины, выполняется усечение массива байт.

Позволяет определить, какой формат — ActionScript 3.0, ActionScript 2.0 или ActionScript 1.0, — должен применяться при записи или чтении из экземпляра ByteArray. Значение представлено константой из класса ObjectEncoding.

См. также

Перемещает или возвращает текущую позицию указателя файла в объекте ByteArray (в байтах). При следующем вызове метода чтения с этого положения начинается чтение, а при вызове метода записи начинается запись.

Создает экземпляр ByteArray, представляющий упакованный массив байт. С помощью методов и свойств данного класса можно оптимизировать хранилище и поток данных.

Удаляет содержимое массива байт и сбрасывает значения length и position в значение 0. При явном вызове этого метода высвобождается память, используемая экземпляром ByteArray.

Упаковывает массив байт. Упаковывается весь массив байт. Для содержимого, которое выполняется в Adobe AIR, можно указать алгоритм упаковки посредством передачи значения (определенного в классе CompressionAlgorithm) в качестве параметра algorithm. Flash Player поддерживает только алгоритм по умолчанию, zlib.

После вызова свойству length объекта ByteArray присваивается новая длина. Свойство position устанавливается на конец массива байт.

Формат упакованных данных zlib описан в документе http://www.ietf.org/rfc/rfc1950.txt.

Алгоритм упаковки данных deflate описан в документе http://www.ietf.org/rfc/rfc1951.txt.

Алгоритм упаковки deflate используется в различных форматах упаковки (например, zlib, gzip, некоторых реализациях zip и в других). Когда данные упаковываются с использованием одного из этих форматов упаковки, помимо хранения упакованной версии исходных данных, данные формата упаковки (например, ZIP-файл) содержат метаданные. Вот некоторые из примером метаданных, включаемых в различные форматы файлов: имя файла, дата и время изменения файла, исходный размер файла, необязательные комментарии, контрольная сумма и другие данные.

Например, когда объект ByteArray сжимается с помощью алгоритма zlib, результирующий объект ByteArray получает структуру определенного формата. Определенные байты содержат метаданные об упакованных данных, а другие байты содержат сжатую версию исходных данных объекта ByteArray. Как определено спецификацией формата упакованных данных zlib, эти байты (то есть та часть, которая содержит упакованную версию исходных данных) сжимаются с использованием алгоритма deflate. Как следствие, эти байты идентичны результату вызова функции compress(CompressionAlgorithm.DEFLATE) для исходного объекта ByteArray. Однако результат выполнения compress(CompressionAlgorithm.ZLIB) содержит дополнительные метаданные, в то время как результат выполнения compress(CompressionAlgorithm.DEFLATE) содержит только упакованную версию исходных данных ByteArray и ничего больше.

Поэтому, чтобы формат deflate можно было использовать для упаковки данных экземпляра ByteArray в определенный формат (например, gzip или zip), нельзя просто вызвать compress(CompressionAlgorithm.DEFLATE). Необходимо создать объект ByteArray со структурой, соответствующей спецификации формата упаковки, включающий соответствующие метаданные, а также упакованные данные, полученные с использованием формата deflate. Аналогично, чтобы раскодировать данные, упакованные в такой формат, как gzip или zip, по отношению к этим данным нельзя просто вызвать метод uncompress(CompressionAlgorithm.DEFLATE). Сначала необходимо отделить метаданные от упакованных данных, а затем использовать формат deflate для распаковки упакованных данных.

Параметры

См. также

Сжимает массив байт с использованием алгоритма упаковки DEFLATE. Упаковывается весь массив байт.

После вызова свойству length объекта ByteArray присваивается новая длина. Свойство position устанавливается на конец массива байт.

Алгоритм упаковки данных DEFLATE описан в документе http://www.ietf.org/rfc/rfc1951.txt.

Алгоритм упаковки DEFLATE используется в различных форматах упаковки (например, zlib, gzip некоторых реализациях zip и в других). Когда данные упаковываются с использованием одного из этих форматов упаковки, помимо хранения упакованной версии исходных данных, данные формата упаковки (например, ZIP-файл) содержат метаданные. Вот некоторые из примером метаданных, включаемых в различные форматы файлов: имя файла, дата и время изменения файла, исходный размер файла, необязательные комментарии, контрольная сумма и другие данные.

Например, когда объект ByteArray сжимается с помощью метода compress(), объект ByteArray сжимается с использованием формата упакованных данных zlib. Результирующий объект ByteArray имеет структуру определенного формата. Определенные байты содержат метаданные об упакованных данных, а другие байты содержат сжатую версию исходных данных объекта ByteArray. Как определено спецификацией формата упакованных данных zlib, эти байты (то есть та часть, которая содержит упакованную версию исходных данных) сжимаются с использованием алгоритма DEFLATE. Как следствие, эти байты идентичны результату вызова функции deflate() для исходного объекта ByteArray. Однако результат выполнения метода compress() содержит дополнительные метаданные, в то время как результат выполнения метода deflate() содержит только упакованную версию исходных данных ByteArray и ничего больше.

Аналогично, чтобы использовать метод deflate() для упаковки экземпляра объекта ByteArray в определенный формат (например, gzip или zip), для этих данных нельзя просто вызвать метод deflate(). Необходимо создать объект ByteArray со структурой, соответствующей спецификации формата упаковки, включающие соответствующие метаданные, а также упакованные данные, полученные с использованием метода deflate(). Аналогично, чтобы раскодировать данные, упакованные в такой формат, как gzip или zip, для этих данных нельзя просто использовать метод inflate(). Сначала необходимо отделить метаданные от упакованных данных, а затем использовать метод deflate() для распаковки упакованных данных.

См. также

Распаковывает массив байт. Массив байт должен быть сжат с использованием алгоритма упаковки DEFLATE, применяемого методом deflate().

После вызова свойству length объекта ByteArray присваивается новая длина. Свойству position присваивается значение 0.

Алгоритм упаковки данных DEFLATE описан в документе http://www.ietf.org/rfc/rfc1951.txt.

При раскодировании данных, упакованных в формат, использующий алгоритм сжатия DEFLATE (например, формат gzip или zip), вызов метода inflate() не сработает для объекта ByteArray, содержащего метаданные. Сначала необходимо отделить метаданные, которые входят в состав упакованного формата данных, от самих сжатых данных. Дополнительную информацию см. в описании метода deflate().

См. также

Считывает из потока байт логическое значение. Считывается один байт. Если этот байт ненулевой, то возвращается значение true. В противном случае возвращается значение false.

Считывает из потока байт байт со знаком.

Возвращенное значение находится в диапазоне от -128 до 127.

Считывает·из потока байт число байт данных, заданное параметром length. Байты считываются в объект ByteArray, определяемый параметром bytes, при этом байты записываются в целевой массив ByteArray, начиная с позиции, определяемой параметром offset.

Параметры

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

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

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

Возвращенное значение находится в диапазоне от -2147483648 до 2147483647.

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

Параметры

Считывает объект из массива байт, зашифрованного в сериализованный формат AMF.

Считывает из потока байт 16-разрядное целое число со знаком.

Возвращенное значение находится в диапазоне от -32768 до 32767.

Считывает из потока байт байт без знака.

Возвращенное значение находится в диапазоне от 0 до 255.

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

Возвращенное значение находится в диапазоне от 0 до 4294967295.

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

Возвращенное значение находится в диапазоне от 0 до 65535.

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

См. также

Считывает последовательность байт UTF-8, заданную параметром length, из потока байт и возвращает строку.

Параметры

Преобразует массив байт в строку. Если данные массива начинаются маркером порядка байт Unicode, во время преобразования данных в строку приложение учтет этот маркер. Если параметр System.useCodePage установлен в значение true, приложение будет обрабатывать данные массива во время преобразования как данные в текущей системной кодировке.

Распаковывает массив байт. Для содержимого, которое выполняется в Adobe AIR, можно указать алгоритм упаковки посредством передачи значения (определенного в классе CompressionAlgorithm) в качестве параметра algorithm. Массив байт должен быть сжат с использованием этого же алгоритма. Flash Player поддерживает только алгоритм по умолчанию, zlib.

После вызова свойству length объекта ByteArray присваивается новая длина. Свойству position присваивается значение 0.

Формат упакованных данных zlib описан в документе http://www.ietf.org/rfc/rfc1950.txt.

Алгоритм упаковки данных deflate описан в документе http://www.ietf.org/rfc/rfc1951.txt.

При раскодировании данных, упакованных в формат, использующий алгоритм сжатия deflate (например, формат gzip или zip), вызов метода uncompress(CompressionAlgorithm.DEFLATE) не сработает для объекта ByteArray, содержащего метаданные. Сначала необходимо отделить метаданные, которые входят в состав упакованного формата данных, от самих сжатых данных. Дополнительную информацию см. в описании метода compress().

Параметры

См. также

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

Параметры

Записывает байт в поток байт.

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

Параметры

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

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

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

Параметры

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

Параметры

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

Параметры

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

Параметры

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

Параметры

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

Параметры

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

Параметры

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

Параметры

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

Параметры

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

Параметры

1. Объявляется новый экземпляр объекта ByteArray byteArr.
2. Записывается эквивалент байтового логического значения false, а затем проверяется длина и оно считывается.
3. Записывается эквивалент числа "пи" с двойной точностью и плавающей запятой.
4. Все эти девять байт, записанных в массив байт, считываются.

Примечание. Когда trace() вызывается для байта, то выводится десятичный эквивалент байт, хранящихся в байтовом массиве.

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

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

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

            byteArr.writeBoolean(false);
            trace(byteArr.length);            // 1
            trace(byteArr[0]);            // 0

            byteArr.writeDouble(Math.PI);
            trace(byteArr.length);            // 9
            trace(byteArr[0]);            // 0
            trace(byteArr[1]);            // 64
            trace(byteArr[2]);            // 9
            trace(byteArr[3]);            // 33
            trace(byteArr[4]);            // 251
            trace(byteArr[5]);            // 84
            trace(byteArr[6]);            // 68
            trace(byteArr[7]);            // 45
            trace(byteArr[8]);            // 24
            
            byteArr.position = 0;

            try {
                trace(byteArr.readBoolean() == false); // true
            } 
            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.
            }
        }
    }
}