Редактирование: Заполнения массива набором записей

[[Категория:Унифицированная работа с базами данных]]
<code>Int '''FieldToArray'''(int ''&lt;IDRset&gt;'', int ''&lt;FieldNum&gt;''|string ''&lt;FieldName&gt;'', varname Array ''&lt;Arr&gt;''<nowiki>[, int </nowiki>''&lt;Frec&gt;''<nowiki>[, int </nowiki>''&lt;Lrec&gt;'']])</code>

Функция '''FieldToArray''' заполняет массив <code>''&lt;Arr&gt;''</code> содержимым поля <code>''&lt;FieldNum&gt;''</code> (<code>''&lt;FieldName&gt;''</code>) набора записей с номером <code>''&lt;IDRset&gt;''</code>. Функция возвращает количество заполненных элементов массива. 

Необязательные параметры <code>''&lt;Frec&gt;''</code> и <code>''&lt;Lrec&gt;''</code> задают первую и последнюю запись набора записей, которые будут переданы в массив. Если указано только <code>''&lt;Frec&gt;''</code>, то значение интерпретируется, как количество записей, начиная с первой, которые попадут в массив <code>''&lt;Arr&gt;''</code>. Если ни одно из значений <code>''&lt;Frec&gt;''</code> и <code>''&lt;Lrec&gt;''</code> не указано, то в массив попадают все записи набора записей.

Параметр <code>''&lt;FieldNum&gt;''</code> (<code>''&lt;FieldName&gt;''</code>) задаёт номер поля (с нуля) или имя поля, значения которого записываются в массив.

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

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


<code>Int '''RecToArray'''(int ''&lt;IDRset&gt;'', int ''&lt;RecNum&gt;'', varname array ''&lt;Arr&gt;''<nowiki>[, int </nowiki>''&lt;Ffield&gt;''<nowiki>[, int </nowiki>''&lt;Lfield&gt;'']])</code>

Функция '''RecToArray''' заполняет массив <code>''&lt;Arr&gt;''</code> содержимым записи <code>''&lt;RecNum&gt;''</code> набора записей с номером <code>''&lt;IDRset&gt;''</code>. Функции возвращает количество заполненных элементов массива. 

Необязательные параметры <code>''&lt;Ffield&gt;''</code> и <code>''&lt;Lfield&gt;''</code> задают первое и последнее поле, которые будут переданы в массив. Если указано только <code>''&lt;Ffield&gt;''</code>, то значение интерпретируется, как количество полей, начиная с нулевого, которое попадет в массив <code>''&lt;Arr&gt;''</code>. Если ни одно из значений <code>''&lt;Ffield&gt;''</code> и <code>''&lt;Lfield&gt;''</code> не указано, то в массив попадают все поля.

Параметр <code>''&lt;RecNum&gt;''</code> задаёт номер записи (с единицы), значения полей которой записываются в массив.

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

Если по каким-то причинам массив не удается заполнить (нет записи с указанным номером, номер начального поля больше номера конечного и пр.), то функция возвращает ноль.


<code>Int '''TableToArray'''(int ''&lt;IDRset&gt;'', varname array ''&lt;Arr&gt;'', int ''&lt;Ffield&gt;'', int ''&lt;Lfield&gt;''<nowiki>[, int </nowiki>''&lt;Frec&gt;''<nowiki>[, int </nowiki>''&lt;Lrec&gt;'']])</code>

Функция '''TableToArray''' заполняет массив <code>''&lt;Arr&gt;''</code> по строкам содержимым набора записей с номером <code>''&lt;IDRset&gt;''</code>. Функция возвращает количество заполненных элементов массива. Массив должен быть двумерным (описан [[Переменные и выражения|командой]] <code>defarr n[''&lt;x&gt;'',''&lt;y&gt;'']</code>). При этом первый индекс массива соответствует номеру поля, второй – номеру записи.

Параметры <code>''&lt;Ffield&gt;''</code> и <code>''&lt;Lfield&gt;''</code> задают первое и последнее поле набора записей, которые будут переданы в массив. Необязательные параметры <code>''&lt;Frec&gt;''</code> и <code>''&lt;Lrec&gt;''</code> задают первую и последнюю запись набора. Если указано только <code>''&lt;Frec&gt;''</code>, то значение интерпретируется, как количество записей, начиная с первого, которые попадут в массив <code>''&lt;Arr&gt;''</code>. Если ни одно из значений <code>''&lt;Frec&gt;''</code> и <code>''&lt;Lrec&gt;''</code> не указано, то в массив попадают все записи набора.

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

Если по каким-то причинам массив не удается заполнить (нет записи с указанным номером, номер начального поля больше номера конечного и пр.), то функция возвращает ноль.
@@ Строка 1: / Строка 1: @@
 [[Категория:Унифицированная работа с базами данных]]
-{{Унифицированная работа с базами данных}}
-----
 <code>Int '''FieldToArray'''(int ''&lt;IDRset&gt;'', int ''&lt;FieldNum&gt;''|string ''&lt;FieldName&gt;'', varname Array ''&lt;Arr&gt;''<nowiki>[, int </nowiki>''&lt;Frec&gt;''<nowiki>[, int </nowiki>''&lt;Lrec&gt;'']])</code>
@@ Строка 37: / Строка 35: @@
 Если по каким-то причинам массив не удается заполнить (нет записи с указанным номером, номер начального поля больше номера конечного и пр.), то функция возвращает ноль.
-----
-{{Унифицированная работа с базами данных}}