Total Commander

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Общие понятия ======

Написание скриптов позволяет полностью изменить вывод информации под ваши нужды. В плагине используется скриптовый движок с упрощенным Pascal-подобным синтаксисом.

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

===== Типы данных =====

Все переменные имеют тип Variant. Это означает, что во многих случаях вы можете использовать ее значение без дополнительных преобразований типов. Однако в некоторых случаях может потребоваться явное приведение типов, для этого предусмотрены функции: [[script_integer]], [[script_number]] и [[script_string]].

Также в выражениях могут использоваться константы **True** и **False**.

===== Переменные =====

Переменные объявлять не надо, они при необходимости создаются динамически при присваивании им значений. Тип определяется по последнему присвоенному значению, типовой контроль при присваивании не выполняется. То есть если существующей числовой переменной присвоить строку, ее тип изменится. 

===== Операции =====


В выражениях поддерживаются следующие операции:
|Арифметические|+, -, *, /, %%^%% (степень), SHL, SHR|
|Битовые|BITOR,BITAND,BITXOR,BITNOT|
|Логические|>, <, >=, %%<=%%, =, <>, AND, OR, NOT|

Порядок выполнения операций стандартный.

===== Блоки =====


Блок необходимо использовать там, где необходимо объединить несколько операций. 
<code pcmi>
begin
 ...
end;
</code>

===== Условия =====

Простое условие. Проверяет результат <expression>, если он True, то выполняется <statement1>, если False --- то  <statement2>.
<code pcmi>
if <expression> then
 <statement1>
else
 <statement2>;
</code>

Условие-переключатель. Проверяет соответствие результата <expression> заданным значениям. Может содержать else для всех остальных значений, не указанных явно.
<code pcmi>
case <expression> 
 <value1>[,<value2>[, <valueN>]]:
   <statement1>;
 <value1>[..<value2>]:
   <statement2>;
 else 
   <statement3>;
end;
</code>

===== Циклы =====

Цикл выполняет <statement> от значения <value1> до <value2> с шагом 1.

<code pcmi>
for <value1>:=<expression> to <value2> do
 <statement>;
</code>

Цикл выполняет <statement> от значения <value1> до <value2> с шагом -1.
<code pcmi>
for <value1>:=<expression> downto <value2> do
 <statement>;
</code>

Цикл выполняет <statement> до тех пор, пока значение <expression> истинно.
<code pcmi>
while <expression> do
 <statement>;
</code>

Цикл выполняет <statement> до тех пор, пока значение <expression> не станет истинным.
<code pcmi>
repeat
 <statement>;
until <expression>;
</code>

===== Прочие операторы =====

Продолжение цикла. Может быть использован только в циклах.
<code actionscript>
continue;
</code>

Прерывание цикла. Может быть использован только в циклах.
<code pcmi>
break;
</code>

Выход из процедуры или функции. Пр нахождении в основном скрипте завершает скрипт.
<code actionscript>
exit;
</code>

Переход на метку. В настоящее время использование оператора не рекомендуется в целях сохранения понятности кода.
<code pcmi>
label <value>
...
goto <value>
</code>

===== Пользовательские процедуры и функции =====

Поддерживаются процедуры и функции на языке интерпретатора. В списке параметров процедур и функций необходимо только перечислить имена формальных параметров.

Если в качестве параметра функции или процедуры передается глобальная переменная интерпретатора, этот параметр для данного вызова считается VAR-параметром и его изменение внутри функции изменит значение глобальной переменной. В то же время все глобальные переменные интерпретатора внутри функции или процедуры ведут себя как локальные переменные, которым присвоены начальные значения, совпадающие со значениями одноименных глобальных переменных. В процедурах и функциях доступны их значения, которые можно изменить, но после выхода из процедуры или функции значение глобальной переменной не изменится. Все новые переменные, созданные внутри процедур и функций, являются локальными и после выхода из процедуры/функции они исчезнут. Таким образом, в процедурах и функциях можно использовать любые имена для локальных переменных, не опасаясь что они совпадут с именами глобальных переменных.

Процедуры не возвращают значений:
<code pcmi>
MyProc([<expression1>[, <expressionN>]]);

procedure MyProc([<value1>[, <valueN>]]);
begin
...
end;
</code>

Функции возвращают значения посредством специальной переменной **result**:
<code pcmi>
<value>:=MyFunc([<expression1>[, <expressionN>]]);

procedure MyFunc([<value1>[, <valueN>]]);
begin
...
result=<expression>;
end;
</code>

===== Библиотеки функций =====

Есть возможность реализовать [[funclibs|библиотеки функций]], которые можно подключать с помощью операторов **uses** и **include**.

Использование **uses** загружает только функции и процедуры, которые затем можно использовать в своем скрипте. Наиболее частый сценарий использования.
<code pcmi>
uses "LibName";
</code>

Использование **include** вставляет всё содержимое библиотеки в место скрипта, где использована директива.
<code pcmi>
include "LibName";
</code>