Bytea — различия между версиями

Версия 08:03, 19 апреля 2008

Класс bytea (от англ. byte array — массив байтов) используется для работы с данными, как с потоком байтов. Класс во многом похож на класс string. Отличие заключается в том, что string ориентируется на строковые данные в кодировке UTF-8, в то время как bytea ориентируется на байты.

Например, в случае строки "hello world" методы bytea:length и string:length вернут одно и то же число, поскольку байтовое представление будет одинаковым. В случае строки "привет мир", длины уже не будут совпадать, поскольку в кодировке UTF-8 символы кирилицы будут представляться уже двумя байтами.

Родители: Object
Методы: empty length resize clear substr replace replace_all insert erase find find_first_of find_first_not_of Приводится к типам: <tt>int real uid string
Реализует операторы: +, +=, <<, индексного доступа, присваивания, сравнения

индексные операторы

operator [] (индекс: int)
Возвращает: int

Оператор индексного чтения служит для получения значения некоторого байта расположенного по указанному индексу.

operator []= (индекс: int, значение: int)
Возвращает: int

Оператор индексной записи, напротив, служит для установки значения байта расположенного по соответствующему индексу.

Примечание: Имеет значение только самый младший байт переданного числа, то есть значения в диапазоне от 0 до 255.

оператор +

operator + (слагаемое: bytea)
Возвращает: bytea

Метод возвращает новый байт-массив, полученную путем конкатенации (сложения) текущего и переданного массивов. Размер внутреннего буфера увеличивается автоматически, однако в случае большого количества последовательных (циклических) конкатенаций, возможен предварительный вызов метода resize для повышения быстродействия и уменьшения числа промежуточных операций копирования.

оператор +=

operator += (слагаемое: bytea)
Возвращает: текущий объект

Метод изменяет текущий массив, дописывая ему в конец массив, переданный в качестве параметра. Размер внутреннего буфера увеличивается автоматически, однако в случае большого количества последовательных (циклических) конкатенаций, возможен предварительный вызов метода resize для повышения быстродействия и уменьшения числа промежуточных операций копирования.

оператор <<

Эквивалент оператора +.

empty

Возвращает: логическое значение

Метод возвращает истину, если массив непуст.

length

Возвращает: int

Метод возвращает текущий размер данных в байтах.

resize

resize(новый размер в байтах: int)
Возвращает: текущий объект

Метод изменяет размер внутреннего буфера, устанавливая его равным переданному числу. При увеличении размера буфера, данные останутся нетронутыми, однако незанятая область будет содержать случайные данные.

clear

Возвращает: текущий объект

Очищает массив содержимого и сбрасывает внутренний буфер. После этого строка считается пустой.

substr

substr(начальная позиция: int, количество байт: int)
Возвращает: bytea

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

replace

replace(начальная позиция: int, количество байт: int, блок замены: bytea)
Возвращает: текущий объект

Метод заменяет указанное количество байт с начальной позиции на блок замены.

replace_all

replace_all(блок поиска: bytea, блок замены: bytea)
Возвращает: текущий объект

Метод находит все включения блока поиска в исходном массиве и заменяет их на блок замены.

insert

insert(позиция: int, данные: bytea)
Возвращает: текущий объект

Метод вставляет переданные данные в исходныый массив, в указаную позицию, "раздвигая" имеющиеся данные.

erase

erase_int(начальная позиция: int, количество байт: int)
Возвращает: текущий объект

Метод вырезает из текущих данных указанный блок.

find

find(блок поиска: string [, начальная позиция: int])
Возвращает: int

Метод ищет в исходных данных искомый блок и возвращает его смещение. Для поиска блока, начиная с некоторой позиции, может быть передан второй параметр — смещение начальной позиции.

find_first_of

find_first_not_of