http://sfsys.ru/index.php?action=history&feed=atom&title=Query.First
Query.First - Revision history
2026-04-04T12:18:12Z
Revision history for this page on the wiki
MediaWiki 1.31.1
http://sfsys.ru/index.php?title=Query.First&diff=1828&oldid=prev
Admin: 1 revision imported
2021-02-07T06:52:30Z
<p>1 revision imported</p>
<table class="diff diff-contentalign-left" data-mw="interface">
<tr class="diff-title" lang="en">
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">Revision as of 06:52, 7 February 2021</td>
</tr><tr><td colspan="2" class="diff-notice" lang="en"><div class="mw-diff-empty">(No difference)</div>
</td></tr></table>
Admin
http://sfsys.ru/index.php?title=Query.First&diff=1827&oldid=prev
Admin at 08:01, 4 November 2019
2019-11-04T08:01:49Z
<p></p>
<p><b>New page</b></p><div>{{infobox function<br />
|name=First<br />
|object=[[Объект запрос базы данных|Запрос базы данных]]<br />
|caption=Переместиться в начало выборки<br />
|type=1<br />
|status=2<br />
|db=0<br />
|exception=Невозможно превратить в строку, число, неверная группировка, ошибка запроса.<br />
|visual=0}}<br />
{{HeadLinks|<br />
* [[Main_Page|Начальная страница]]<br />
* [[Общее_описание_языка|Общее описание]]<br />
* [[Объекты]]<br />
* [[Объект запрос базы данных]]}}<br />
Функция устанавливает текущую строку таблицы запроса на начало указанного уровня группировки, после чего можно начинать обход записей запроса с начала уровня. Функция работает как для обычных, так и для линейных запросов. '''Внимание:''' индекс группировки, используемый в этой функции, противоположен индексам, записанным в столбец ''@LEVEL'' таблицы результата запроса (пример, для запроса с тремя группировками, индекс этой функции ''1'' соответствует значению столбца @LEVEL, равному ''3'')! Изменение позиции текущей записи в таблице результата запроса при вызове функции можно показать на примере ниже:<br />
<pre><br />
//Картина исходных уровней таблицы для запроса в обычном режиме<br />
Группировка 1<br />
Группировка 2<br />
Группировка 3<br />
Группировка 1<br />
Группировка 2<br />
Группировка 3<br />
Группировка 3<br />
Группировка 2<br />
Группировка 3<br />
Группировка 2<br />
Группировка 3<br />
Группировка 3 <--- Положение курсора обхода до вызова функции<br />
Группировка 3<br />
Группировка 1<br />
...<br />
<br />
//После вызова функции First(2)<br />
Группировка 1<br />
Группировка 2<br />
Группировка 3<br />
Группировка 1<br />
Группировка 2<br />
Группировка 3<br />
Группировка 3<br />
Группировка 2<br />
Группировка 3<br />
Группировка 2 <--- Положение курсора обхода после вызова функции First(2)<br />
Группировка 3<br />
Группировка 3<br />
Группировка 3<br />
Группировка 1<br />
...<br />
<br />
//После вызова функции First(1)<br />
Группировка 1<br />
Группировка 2<br />
Группировка 3<br />
Группировка 1 <--- Положение курсора обхода после вызова функции First(1)<br />
Группировка 2<br />
Группировка 3<br />
Группировка 3<br />
Группировка 2<br />
Группировка 3<br />
Группировка 2<br />
Группировка 3<br />
Группировка 3<br />
Группировка 3<br />
Группировка 1<br />
...<br />
</pre><br />
<br />
== Синтаксис ==<br />
<code><br />
{{Grey|Query.}}'''First'''({{Optional|<Индекс или наименование группировки запроса (INT,STRING)>{{Default|{{Eq}}0}}}}):''<Результат запроса имеет хотя бы одну запись на этом уровне (INT)>''<br />
</code><br />
<br />
==== Аргументы ====<br />
* <code>''<Индекс или наименование группировки запроса (INT,STRING)>''</code> - Аргумент задает наименование столбца группировки или индекс группировки. При указании нуля (по умолчанию), текущей записью будет первая запись таблицы.<br />
<br />
==== Возвращаемое значение ====<br />
Возвращает единицу, если в таблице результата запроса внутри указанной группировки есть по крайней мере одна запись, иначе, возвращает ноль.<br />
<br />
== Примеры ==<br />
<pre><br />
//Заполним переменные в таблице запроса на основании средних за период формирования отчета, когда<br />
// в накопителе фигурирует только количество<br />
З:=Query.Create();<br />
З.Execute(ТЗ,0);<br />
aTab:=З.ResultTable;<br />
aTab.Select();<br />
While aTab.Next() Do<br />
зЦ0:=ПолучитьЦену(aTab.зН,НачДата);<br />
зЦ1:=ПолучитьЦену(aTab.зН,КонДата);<br />
aTab.зСмРасход:=aTab.зКлРасход*(зЦ1+зЦ0)/2;<br />
aTab.зСмНачОст:=aTab.зКлНачОст*(зЦ1+зЦ0)/2;<br />
aTab.зСмКонОст:=aTab.зКлКонОст*(зЦ1+зЦ0)/2;<br />
aTab.зСмПриход:=aTab.зКлПриход*(зЦ1+зЦ0)/2;<br />
EndDo;<br />
//Выполним постобработку<br />
З.Postprocess();<br />
//Перейдем в начало таблицы<br />
З.First();<br />
<br />
//Произведем обход таблицы <br />
While З.Next(1) Do<br />
...<br />
EndDo;<br />
</pre></div>
Admin