Query.Level

From SunFlurry wiki
Jump to: navigation, search
  Level (Текущий уровень группировки)
Объект:Запрос базы данных
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Не выполненный запрос
Визуальность:Нет

Функция возвращает индекс уровня группировки, текущей строки таблицы запроса. Нижний уровень группировки соответствует значению 1, верхний -- общему количеству группировок в запросе. Запрос должен быть выполненным. Функция является аналогом атрибута LinearLevelPos, однако, в отличии от последнего работает как для линейного, так и для обычного запросов, но не может изменять уровень группировки линейного уровня.

Синтаксис

Query.Level():<Текущий уровень группировки (INT)>

Возвращаемое значение

Возвращает числовое значение, текущий уровень обхода (группировки) запроса.

Примеры

//Фрагмент показывает, какие значения будет отдавать функция Level на разных этапах обхождения запроса

//Функция возвращает 0
Message(З.Level());

While З.Next(1) Do
  //Функция возвращает 1
  Message(З.Level());

  While З.Next(2) Do
    //Функция возвращает 2
    Message(З.Level());

    ...

  EndDo;
EndDo;