Просмотр кода страницы Операторы if и for

Операторы <code>if</code> и <code>for</code> – это замена для функций <code>if</code> и <code>str2</code>. 

Дело в том, что функции работают в выражениях внутри квадратных скобок, где все изменения формата текста игнорируются. 

Операторы работают непосредственно с форматированным текстом, что открывает множество возможностей.

==Общие правила пользования операторами==

''Операторы'' – это специальные ключевые слова, вставляемые в текст прямоугольника в квадратных скобках.

Фрагменты текста между операторами вставляются от скобки до скобки, поэтому необходимо помнить, что они должны вплотную прилегать к скобкам, без всяких пробелов и пр.

Ключевые слова не чувствительны к регистру букв. То есть, нет разницы, как писать - <code>else</code>, <code>ELSE</code> или <code>Else</code>.

Внутри скобок допустимы пробелы и переходы на новую строку. 

Также можно менять формат текста внутри скобок – это ни на что не повлияет. 

Всё это даёт возможность сделать текст прямоугольника более «читабельным». 

'''Пример:'''
<code>[if не [Результаты->Значение]:Пусто][if [Результаты->Значение]<[Результаты->Минимум]][Результаты->Минимум][else][Результаты->Значение][endif][else] - [endif]</code>

Это же самое выражение можно записать следующим образом:

<syntaxhighlight>
[if не [Результаты->Значение]:Пусто][
if [Результаты->Значение]<[Результаты->Минимум]]<[Результаты->Минимум][
else
][Результаты->Значение][
endif][
else
] - [
endif]
</syntaxhighlight>

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

То есть внутри этих фрагментов также можно использовать операторы.

'''Примечание:''' обратите внимание на оформление вложенных друг в друга операторов "лесенкой". Рекомендуется делать так же, т.к. будет намного легче читать прописанное условие.

==If==

===Синтаксис 1:===

<code>[if ЛогическоеВыражение]Фрагмент для «истины»[endif]</code>

'''Смысл:'''
Вычисляется логическое выражение, и если результат – истина, то в прямоугольник вставляется фрагмент от закрывающей квадратной скобки оператора <code>if</code> до открывающей квадратной скобки оператора <code>endif</code>. 

Иначе всё от открывающей скобки оператора <code>if</code> до закрывающей скобки оператора <code>endif</code> пропускается.

'''Пример:'''
<syntaxhighlight>
[if не[Результат анализа -> Значение показателя]:Пусто
и [Результат анализа -> Значение показателя]!=0
][Результат анализа -> Значение показателя] г/см2[
endif]
</syntaxhighlight>

===Синтаксис 2:===
<code>[if ЛогическоеВыражение]Фрагмент для “истины»[else]Фрагмент для “лжи»[endif]</code>

'''Смысл:'''
Вычисляется логическое выражение, и если результат – истина, то в прямоугольник вставляется фрагмент от закрывающей квадратной скобки оператора <code>if</code> до открывающей квадратной скобки оператора <code>else</code>. 

Иначе вставляется фрагмент от <code>else</code> до <code>endif</code>.

'''Пример:'''
<syntaxhighlight>
[if [Результат анализа -> Значение показателя]<=[Результат анализа -> норма]
][Результат анализа -> Значение показателя][
else
][Результат анализа -> Значение показателя][
endif]
</syntaxhighlight>

==For==
===Синтаксис 1:===
<code>[for Запрос]Фрагмент для повторения[endfor]</code>

'''Смысл:'''
Фрагмент повторяется для каждой записи из запроса с указанным названием от первой до последней.

'''Пример:'''
Вывести перечень показателей в ячейке.

<syntaxhighlight>
[for Показатели 
][Показатели -> Название]
[endfor]
</syntaxhighlight>

В результате все показатели будут перечислены в столбик (каждый – на новой строке, т.к. строка кончается до открывающей скобки <code>endfor</code>.

===Синтаксис 2:===
<code>[for Запрос]Фрагмент для повторения[!]Фрагмент-разделитель[endfor]</code>

'''Смысл:'''
Для каждой записи указанного запроса, от первой до последней, в прямоугольник вставляются фрагменты для повторения. После каждого фрагмента, кроме последнего, следует фрагмент-разделитель.

'''Пример:'''
Вывести перечень показателей в ячейке через символ <code>;</code>

<syntaxhighlight>
[for Показатели 
][Показатели -> Название][
!]; [
endfor]
</syntaxhighlight>

'''Примечание.''' Если в запросе пустота, то функция отрабатывает один раз с значением <code>ПУСТО</code>.
Т.е. если выводится только значение <code>[for Примечание][Примечание -> Строка][!], [endfor]</code> 
то вы ничего не заметите 
но, если внутри функции есть какие-то дополнительные символы/переменные, 
то выходит некорректно <code>[for Примечание][Примечание -> Строка] - значение[!], [endfor] -></code> 
в результате будет - значение.