Помилки компіляції та виконання

Кожне повідомлення компілятора й виконувача LootScript починається з коду виду LS2008. Код не змінюється між версіями і не залежить від мови інтерфейсу, тому за ним зручно шукати: тут зібрані всі коди, які може показати термінал, з текстом повідомлення, причиною та способом виправлення.

Повідомлення виводяться російською, якщо інтерфейс терміналу російською, і англійською на будь-якій іншій мові. Спочатку — помилки, які трапляються найчастіше, потім помилки виконання і повна таблиця.

Де видно помилки

При компіляції. Редактор компілює скрипт при кожній паузі набору. Знайдене потрапляє у вкладку «Проблеми» у нижній частині редактора: код, текст і позиція виду «Рядок 6:6». Подвійний клік по рядку переводить курсор до місця помилки. У заголовку редактора відображається підсумок: «ок · 12 мс», «попереджень: 2» або «помилок: 1».

При виконанні. Скрипт без помилок компіляції може зупинитися на якомусь барі: закінчився бюджет операцій, індекс вийшов за межі масиву, невідомий інструмент. Тоді у вкладці «Вивід» з’явиться рядок «Скрипт зупинено: LS6004: …», а у вікні тестера стратегій — та сама причина. Інші скрипти, панелі й сам термінал продовжують працювати.

Діагностики бувають трьох рівнів:

Як влаштовані коди

Часті помилки компіляції

LS1009 — немає оголошення скрипта

«Немає оголошення скрипта — почніть з indicator(“Назва”)». Першим оператором файлу має стояти indicator(...), strategy(...) або library(...). Та сама помилка з’являється, якщо оголошення є, але вище нього щось написано. Коментарі й директива #version 1 не заважають.

// Так не можна: оголошення не перше
len = input.int(14, "Довжина")
indicator("RSI")

indicator("RSI")
len = input.int(14, "Довжина")

Друге оголошення в тому ж файлі дає LS1008: у скрипта воно одне.

LS2002 — невідоме ім’я

«Невідоме ім’я «…» — перевірте написання або оголосіть його вище». Найчастіше це опечатка або функція без простору імен: всі індикаторні функції в ta, математика — в math, кольори — в color.

avg = sma(close, 20)

avg = ta.sma(close, 20)

Та сама помилка буде, якщо змінну читають раніше рядка, де її оголосили. Повний список імен — у довіднику функцій.

LS2008 — порівняння з na

«Порівняння з na завжди хибне — використовуйте na(x)». Будь‑яке порівняння з na, включно з == і !=, дає false, тому компілятор таку запис не пропустить.

x = ta.sma(close, 50)
plot(x == na ? close : x)

x = ta.sma(close, 50)
plot(na(x) ? close : x)

Коротше те саме пишеться через ??: plot(x ?? close).

LS2014 — значення змінюється від бару до бару там, де потрібна константа

««…» в «…» вимагає значення не слабшого за input, а передано series — візьміть input.*(…) або літерал». Довжина вікна ta.* має бути відома до першого бару. Довжина, яку вибирають за умовою на кожному барі, не підходить.

len = close > open ? 10 : 20
avg = ta.sma(close, len)

Порахуйте обидва варіанти і вибирайте результат, а не довжину:

fast = ta.sma(close, 10)
slow = ta.sma(close, 20)
avg  = close > open ? fast : slow

Якщо довжину має задавати користувач, візьміть її з input.int(...).

LS3004 — виклик ta.* залежить від змінної з гілки

«Аргумент «…» не можна обчислити поза гілкою — винесіть виклик ta.* на верхній рівень». Функції ta.* пам’ятають попередні бари, тому компілятор обчислює їх на кожному барі, навіть якщо виклик написаний всередині if. Якщо аргумент оголошено лише всередині гілки, на інших барах його просто нема.

var float avgBody = na
if close > open {
    body = close - open
    avgBody := ta.sma(body, 10)
}

body    = close - open
avgBody = ta.sma(body, 10)

LS2017, LS2007, LS1006 — рядки, умови й порівняння

У цих трьох помилок спільна причина: LootScript не приводить типи мовчки.

LS2018 і LS2019 — ім’я вже зайнято

««…» вже оголошено в цій області» (LS2018) — змінну оголосили вдруге через =. Щоб змінити значення, використовуйте :=.

level = high
level := low

««…» затемнює вбудоване ім’я — оберіть інше» (LS2019) — змінна, функція чи тип названі так само, як вбудований ряд чи функція: close, time, hour, volume. Перейменуйте: startHour замість hour. Імена просторів на кшталт color або position для змінних можна використовувати.

LS2004 і LS2005 — аргументи виклику

««…» очікує … аргумент(ів), а передано …» (LS2004) і «У «…» немає параметра «…»» (LS2005). Звірте виклик із сигнатурою в довіднику: імена параметрів пишуться точно так, як там вказано.

plot(close, colour = color.red)

plot(close, color = color.red)

LS3011 і LS5011 — стратегії

«strategy.* доступно лише в strategy(…)» (LS3011): заявки і стан позиції є тільки у скрипта, оголошеного через strategy(...). Замініть indicator("…") на strategy("…").

«Стратегія читає «…»: у біржового стакана і стрічки угод немає історії, бектест був би фікцією» (LS5011): стратегія перевіряється на історії, а у book.* і tape.* історії нема — на кожному минулому барі там na.

strategy("Перекіс стакана")
if book.imbalance(10) > 0.5 {
    strategy.entry("L", strategy.long)
}

Для історії стакана є простір depth: там, де стакан записано, воно дає значення на кожному барі.

strategy("Перекіс стакана")
if depth.imbalance(1.0) > 0.5 {
    strategy.entry("L", strategy.long)
}

LS5000–LS5006 — попередження про перемальовування

Ці попередження не заважають скрипту працювати. Вони кажуть, що лінія на історії виглядатиме інакше, ніж її бачили вживу:

• LS5001 — на графік доходить значення, яке є лише на живому барі (barstate.isrealtime, barstate.isnew).
• LS5000 — на графік доходить змінна varip: вона накопичує тики живого бара, яких в історії нема.
• LS5006 — на графік доходять book.* або tape.*: на історії ряд пустий.
• LS5003 — значення старшого таймфрейму з request.security без [1]: незакритий бар ще зміниться.
• LS5002 — lookahead = true в request.security: на історії скрипт бачить майбутнє.
• LS5005 — на графік доходить math.random або timenow: два прогони дадуть різні лінії.

Якщо так і задумано — наприклад, індикатор потрібен лише для живої торгівлі — попередження можна залишити.

LS3016 — налаштування прийнята і нічого не робить

Це зведення, а не помилка. Воно трапляється в скриптах, перенесених з інших платформ: параметр існує для сумісності, але в терміналі на нього нічого не впливає. Друга частина повідомлення пояснює чому.

Помилки виконання

Помилка виконання зупиняє скрипт на тому барі, де вона трапилася. Текст з’являється у вкладці «Вивід» у вигляді «Скрипт зупинено: LS6004: …».

LS6004 і LS6005 — скрипт працює занадто довго

«Скрипт вичерпав бюджет операцій на бар — спростіть цикл» (LS6004) і «Скрипт перевищив ліміт часу на проходження» (LS6005). На кожному барі є бюджет у 2 000 000 операцій. Час теж обмежено: весь прогін по історії — 2 секунди, один тік живого бара — 20 мс. Майже завжди причина — цикл, який не завершується або обходить забагато даних на кожному барі.

var int n = 0
i = 0
while i < 10 {
    n := n + 1
}

var int n = 0
i = 0
while i < 10 {
    n := n + 1
    i := i + 1
}

LS6002 і LS5004 — читання майбутнього

Індекс історії x[n] не може бути від’ємним: close[-1] означав би наступний бар. Якщо від’ємне число написано прямо в тексті, компілятор зупинить його відразу (LS5004). Якщо воно вийшло при обчисленні, скрипт зупиниться на барі з помилкою «Від’ємне зміщення історії — читати майбутнє не можна» (LS6002). Індекс, більший за число завантажених барів, помилкою не вважається — він дає na.

LS6001, LS6007, LS6019 — колекції й об’єкти

• LS6001 «Індекс … поза межами» — array.get, array.set або matrix.get поза розміром. Перевіряйте array.size(a) перед зверненням.
• LS6007 «Звернення до порожнього об’єкта (na)» — колекцію оголосили, але не створили: var array<float> a = na, а потім a.push(x). Створіть її через array.new<float>().
• LS6019 «Об’єкт малювання вже видалено або витіснено по стелі — створіть його заново». Одночасно живе 500 об’єктів одного виду, найстаріший витісняється. Підніміть ліміт через maxLinesCount, maxLabelsCount або maxBoxesCount в оголошенні або пере використайте об’єкт через set_*.

LS6017 і LS6018 — інструмент і таймфрейм у request.security

«Символ «…» невідомий — перевірте формат «МАЙДАНЧИК:СИМВОЛ» або задайте ignore_invalid_symbol = true» (LS6017) і «Таймфрейм «…» не розбирається — очікується «5», «60», «4h», «1D», «1W»» (LS6018). З ignore_invalid_symbol = true невідомий інструмент дає na замість зупинки.

Межі виконання

Коли помилки немає, але значення відсутнє

Багато ситуацій, які в інших мовах зламали б програму, в LootScript дають na — пропуск на графіку, а не зупинку:

• арифметика з na дає na: close - x при порожньому x — теж порожньо;
• x[n] глибше за початок історії — na;
• цілочисельний поділ на нуль — na, а дробовий поділ на нуль скрипт не зупиняє;
• book.*, tape.* і screener.* на історичних барах — na;
• кластери, дельта, відкритий інтерес і історія біржового стакана — na на барах, де даних нема. Перевіряйте cluster.available, delta.available і суміжні прапорці;
• ta.* на перших барах, поки вікно не заповнилося, — na.

na на графіку ніколи не малюється нулем: лінія переривається. Щоб підставити значення, використовуйте nz(x), x ?? запасне або fixnan(x).

Усі коди

LS0001–LS0009 і LS0999 — читання тексту

LS1000–LS1012 — розбір

LS2000–LS2030 — типи і імена

LS3000–LS3033 — зміст програми

LS4000–LS4009 — межі компіляції

LS5000–LS5013 — перерисовка і тестер

LS6000–LS6036 — виконання

Далі