Для разработчиков > Серверные скрипты > Описание функций > Скрипты

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

Синтаксис

function mGetAutoScriptsCountByName(sScriptName: string): integer;

Параметры и возвращаемые значения

Параметр	Тип	Значение
sScriptName	string	название тайм-скрипта.

Результат функции

Возвращает количество скриптов. Если таких нет — будет возращено 0.

Пример

Добавляется в очередь 3 скрипта-пустышки с одинаковыми названиями ("myscript"). Затем выводится в отладочную консоль количество запланированных скриптов с несуществующим именем "testscript" и с именем "myscript". После этого все вхождения скрипта "myscript" удаляются из очереди на выполнение.

var
  i, iCount: integer;
begin
  for i := 1 to 3 do
    mAddAutoScriptFromString('myscript', 'begin end.', IncMinute(Now, i));

  iCount := mGetAutoScriptsCountByName('testscript');
  mLogScript(inttostr(iCount), 'nonexistent script');
  
  iCount := mGetAutoScriptsCountByName('myscript');
  mLogScript(inttostr(iCount), '"myscript" entries');
  
  mDeleteAutoScriptByName('myscript');
end.