delУдаляет локальную или модульную переменную.
Сигнатура: del(varName: string)
Аргументы: varName — название переменной в виде строки. Название переменной может включать префикс области видимости, такой как $ (для локальных переменных) или # (для модульных переменных). Если префикс опущен, переменная считается локальной.
Возвращаемое значение: Нет.
Пример использования:
$localVar = 123
#moduleVar = true
del("$localVar") // Удаляет локальную переменную $localVar
del("localVar") // Тот же эффект, что и del("$localVar")
del("#moduleVar") // Удаляет переменную с областью видимости в пределах модуля
setClientTimezoneOffsetИзменяет текущее смещение временной зоны пользователя (собеседника бота).
Сигнатура: setClientTimezoneOffset(offset: int)
Аргументы: offset — смещение временной зоны в минутах. Положительные значения означают смещение на восток, отрицательные — на запад.
Возвращаемое значение: Нет.
Примечание: Вызов этой функции также приведет к изменению значений системных переменных now, today и time в соответствии с новой временной зоной.
Пример использования:
setClientTimezoneOffset(-1800) // Устанавливает смещение временной зоны на -30 минут (например, для часового пояса UTC-30)
asBoolПреобразует значение в булев тип.
Сигнатура: asBool(obj: any) -> bool
Аргументы: obj — любое значение, которое требуется преобразовать.
Возвращаемое значение: Булевое значение.
Примечание: В BPL (Basic Programming Language) все значения могут быть преобразованы в булев тип. Например, nil, пустые строки или ноль преобразуются в false, а все остальные значения — в true.
Пример использования:
$bool = asBool(nil) // $bool будет равно false
$bool = asBool("") // $bool будет равно false
$bool = asBool(0) // $bool будет равно false
$bool = asBool([]) // $bool будет равно true
$bool = asBool(123) // $bool будет равно true
asStringПреобразует значение в строку.
Сигнатура: asString(obj: any) -> string
Аргументы: *obj — любое значение, которое требуется преобразовать.
Возвращаемое значение: Строковое представление значения.
Примечание: В BPL все значения могут быть преобразованы в строковый тип.
Пример использования:
$str = asString(123) // $str будет равно "123"
$str = asString(1.23) // $str будет равно "1.23"
$str = asString(true) // $str будет равно "true"
$str = asString({1: "a b c", 2: 0.5}) // $str будет равно "{1: "a b c", 2: 0.5}"
asIntПреобразует значение в целое число.
Сигнатура: asInt(obj: any) -> int
Аргументы: obj — любое значение, которое требуется преобразовать.
Возвращаемое значение: Целочисленное значение. Если преобразование невозможно, возвращается 0.
Пример использования:
$int = asInt(5.67) // $int будет равно 5
$int = asInt("123") // $int будет равно 123
$int = asInt(true) // $int будет равно 1
$int = asInt(nil) // $int будет равно 0
$int = asInt("abc") // $int будет равно 0
asFloatПреобразует значение в вещественное число.
Сигнатура: asFloat(obj: any) -> float
Аргументы: obj — любое значение, которое требуется преобразовать.
Возвращаемое значение: Вещественное число. Если преобразование невозможно, возвращается 0.0.
Пример использования:
$float = asFloat("5.67") // $float будет равно 5.67
$float = asFloat(123) // $float будет равно 123.0
$float = asFloat(true) // $float будет равно 1.0
$float = asFloat(nil) // $float будет равно 0.0
$float = asFloat("abc") // $float будет равно 0.0