Bytea - История изменений

Korvin: /* оператор + */

2009-06-25T15:31:16Z

‎оператор +

Korvin в 06:50, 19 апреля 2008

2008-04-19T06:50:24Z

Korvin в 05:11, 19 апреля 2008

2008-04-19T05:11:12Z

Korvin: /* resize */

2008-04-19T05:03:33Z

‎resize

Korvin: Новая: Класс `bytea` (от англ. ''byte array'' — массив байтов) используется для работы с данными, как с потоком байт...

2008-04-19T05:02:48Z

Новая: Класс <tt>bytea</tt> (от англ. ''byte array'' — массив байтов) используется для работы с данными, как с потоком байт...

Новая страница

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

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

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

__NOTOC__

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

operator <nowiki>[]</nowiki> (''индекс'': <tt>int</tt>) 
'''Возвращает''': <tt>int</tt> 

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

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

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

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

== оператор + ==

operator + (''слагаемое'': <tt>bytea</tt>) 
'''Возвращает''': <tt>bytea</tt> 

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

== оператор += ==

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

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

== оператор << ==

Эквивалент оператора <tt>[[#оператор +|+]]</tt>.

== empty ==

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

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

== length ==

'''Возвращает''': <tt>[[int]]</tt> 

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

== resize ==

resize(''новый размер в байтах'': <tt>[[int]]</tt>)
'''Возвращает''': текущий объект 

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

== clear ==

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

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

== substr ==

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

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

== replace ==

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

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

== replace_all ==

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

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

== insert ==

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

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

== erase ==

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

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

== find ==

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

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

== find_first_of ==

== find_first_not_of ==

@@ Строка 47: / Строка 47: @@
 '''Возвращает''': <tt>bytea</tt> <br>
-Метод возвращает новый байт-массив, полученную путем конкатенации (сложения) текущего и переданного массивов. Размер внутреннего буфера увеличивается автоматически, однако в случае большого количества последовательных (циклических) конкатенаций, возможен предварительный вызов метода <tt>[[#resie|resize]]</tt> для повышения быстродействия и уменьшения числа промежуточных операций копирования.
+Метод возвращает новый байт-массив, полученный путем конкатенации (сложения) текущего и переданного массивов. Размер внутреннего буфера увеличивается автоматически, однако в случае большого количества последовательных (циклических) конкатенаций, возможен предварительный вызов метода <tt>[[#resie|resize]]</tt>, для повышения быстродействия и уменьшения числа промежуточных операций копирования.
 == оператор += ==

@@ Строка 33: / Строка 33: @@
 '''Возвращает''': <tt>int</tt> <br>
-Оператор индексного чтения служит для получения значения некоторого байта расположенного по указанному индексу.
+Оператор индексного чтения служит для получения значения некоторого байта расположенного по указанному индексу. Если указан индекс, выходящий за текущие границы массива, будет сгенерировано исключение [[Классы исключений#ERangeError|ERangeError]].
-−
 operator <nowiki>[]=</nowiki> (''индекс'': <tt>int</tt>, ''значение'': <tt>int</tt>) <br>
 '''Возвращает''': <tt>int</tt> <br>
-Оператор индексной записи, напротив, служит для установки значения байта расположенного по соответствующему индексу.
+Оператор индексной записи, напротив, служит для установки значения байта расположенного по соответствующему индексу. Если указан индекс, выходящий за текущие границы массива, будет сгенерировано исключение [[Классы исключений#ERangeError|ERangeError]].
 '''Примечание''': Имеет значение только самый младший байт переданного числа, то есть значения в диапазоне от 0 до 255.

@@ Строка 16: / Строка 16: @@
 [[#find|find]]
 [[#find_first_of|find_first_of]]
-[[#find_first_not_of|find_first_not_of]]
+[[#find_first_not_of|find_first_not_of]]</tt>
 '''Приводится к типам''': <tt>[[int]] [[real]] [[uid]] [[string]]</tt> <br>
 '''Реализует операторы''':