TaushkanovKV в 09:28, 11 августа 2026

2026-08-11T09:28:04Z

TaushkanovKV в 09:26, 11 августа 2026

2026-08-11T09:26:45Z

TaushkanovKV: Новая страница: «==Standard - стандартная библиотека== ===Математические и тригонометрические функции=== ====Прео...»

2026-08-11T09:26:28Z

Новая страница: «==Standard - стандартная библиотека== ===Математические и тригонометрические функции=== ====Прео...»

Новая страница

==Standard - стандартная библиотека==
===Математические и тригонометрические функции===
====Преобразование IEEE битов====
'''<big>float fpFromIEEE(uint bits)</big>'''
*'''Назначение''': Преобразует 32-битное IEEE-754 представление в число float
*'''Возвращаемое значение''': число float
*'''Аргументы''': uint bits - битовое представление
'''<big>uint fpToIEEE(float value)</big>'''
*'''Назначение''': Преобразует число float в 32-битное IEEE-754 представление
*'''Возвращаемое значение''': битовое представление (uint)
*'''Аргументы''': float value - исходное число
'''<big>double fpFromIEEE(uint64 bits)</big>'''
*'''Назначение''': Преобразует 64-битное IEEE-754 представление в число double
*'''Возвращаемое значение''': число double
*'''Аргументы''': uint64 bits - битовое представление
'''<big>uint64 fpToIEEE(double value)</big>'''
*'''Назначение''': Преобразует число double в 64-битное IEEE-754 представление
*'''Возвращаемое значение''': битовое представление (uint64)
*'''Аргументы''': double value - исходное число
====Сравнение с допуском====
'''<big>bool closeTo(float a, float b, float epsilon = 0.00001f)</big>'''
*'''Назначение''': Сравнивает два числа float с заданной погрешностью
*'''Возвращаемое значение''': true, если числа близки в пределах погрешности; иначе false
*'''Аргументы''':
**float a - первое число;
**float b - второе число;
**float epsilon (опционально) - погрешность (по умолчанию 0.00001)
'''<big>bool closeTo(double a, double b, double epsilon = 0.0000000001)</big>'''
*'''Назначение''': Сравнивает два числа double с заданной погрешностью
*'''Возвращаемое значение''': true, если числа близки в пределах погрешности; иначе false
*'''Аргументы''':
**double a - первое число;
**double b - второе число;
**double epsilon (опционально) - погрешность (по умолчанию 1e-10)
====Тригонометрические функции====
'''<big>float cos(float angle)</big>'''
*'''Назначение''': Вычисляет косинус угла
*'''Возвращаемое значение''': косинус угла
*'''Аргументы''': float angle - угол в радианах
'''<big>float sin(float angle)</big>'''
*'''Назначение''': Вычисляет синус угла
*'''Возвращаемое значение''': синус угла
*'''Аргументы''': float angle - угол в радианах
'''<big>float tan(float angle)</big>'''
*'''Назначение''': Вычисляет тангенс угла
*'''Возвращаемое значение''': тангенс угла
*'''Аргументы''': float angle - угол в радианах
'''<big>float acos(float value)</big>'''
*'''Назначение''': Вычисляет арккосинус (обратный косинус)
*'''Возвращаемое значение''': угол в радианах
*'''Аргументы''': float value - значение в диапазоне [-1, 1]
'''<big>float asin(float value)</big>'''
*'''Назначение''': Вычисляет арксинус (обратный синус)
*'''Возвращаемое значение''': угол в радианах
*'''Аргументы''': float value - значение в диапазоне [-1, 1]
'''<big>float atan(float value)</big>'''
*'''Назначение''': Вычисляет арктангенс (обратный тангенс)
*'''Возвращаемое значение''': угол в радианах
*'''Аргументы''': float value - значение
'''<big>float atan2(float y, float x)</big>'''
*'''Назначение''': Вычисляет арктангенс двух переменных
*'''Возвращаемое значение''': угол в радианах
*'''Аргументы''':
**float y - координата Y;
**float x - координата X
====Гиперболические функции====
'''<big>float cosh(float x)</big>'''
*'''Назначение''': Вычисляет гиперболический косинус
*'''Возвращаемое значение''': гиперболический косинус
*'''Аргументы''': float x - значение
'''<big>float sinh(float x)</big>'''
*'''Назначение''': Вычисляет гиперболический синус
*'''Возвращаемое значение''': гиперболический синус
*'''Аргументы''': float x - значение
'''<big>float tanh(float x)</big>'''
*'''Назначение''': Вычисляет гиперболический тангенс
*'''Возвращаемое значение''': гиперболический тангенс
*'''Аргументы''': float x - значение
====Экспоненциальные и логарифмические функции====
'''<big>float log(float x)</big>'''
*'''Назначение''': Вычисляет натуральный логарифм (по основанию e)
*'''Возвращаемое значение''': натуральный логарифм
*'''Аргументы''': float x - значение > 0
'''<big>float log10(float x)</big>'''
*'''Назначение''': Вычисляет десятичный логарифм (по основанию 10)
*'''Возвращаемое значение''': десятичный логарифм
*'''Аргументы''': float x - значение > 0
====Степенные функции====
'''<big>float pow(float base, float exponent)</big>'''
*'''Назначение''': Возводит число в степень
*'''Возвращаемое значение''': результат возведения в степень
*'''Аргументы''':
**float base - основание;
**float exponent - показатель степени
'''<big>float sqrt(float x)</big>'''
*'''Назначение''': Вычисляет квадратный корень
*'''Возвращаемое значение''': квадратный корень
*'''Аргументы''': float x - неотрицательное значение
====Функции округления и остатка====
'''<big>float ceil(float x)</big>'''
*'''Назначение''': Округляет вверх до ближайшего целого
*'''Возвращаемое значение''': округлённое вверх значение
*'''Аргументы''': float x - значение
'''<big>float abs(float x)</big>'''
*'''Назначение''': Вычисляет абсолютное значение (модуль)
*'''Возвращаемое значение''': абсолютное значение
*'''Аргументы''': float x - значение
'''<big>float floor(float x)</big>'''
*'''Назначение''': Округляет вниз до ближайшего целого
*'''Возвращаемое значение''': округлённое вниз значение
*'''Аргументы''': float x - значение
'''<big>float fraction(float x)</big>'''
*'''Назначение''': Выделяет дробную часть числа
*'''Возвращаемое значение''': дробная часть числа
*'''Аргументы''': float x - значение
===Специализированные функции===
Специализированные функции среды разработки, доступные для использования в скриптах, приведены ниже.
====Функции для работы с узлами====
'''<big>float GetNodeValueAsFloat(string strNodePath)</big>'''
*'''Назначение''': Получить значение узла в виде float по заданному пути
*'''Возвращаемое значение''': значение узла (float)
*'''Аргументы''': string strNodePath - путь к узлу
'''<big>void SetNodeValueAsFloat(string strNodePath, float fValue)</big>'''
*'''Назначение''': Установить значение узла в float по заданному пути
*'''Возвращаемое значение''': нет
*'''Аргументы''':
**string strNodePath - путь к узлу;
**float fValue - устанавливаемое значение
'''<big>int GetNodeValueAsInt(string strNodePath)</big>'''
*'''Назначение''': Получить значение узла в виде int по заданному пути
*'''Возвращаемое значение''': значение узла (int)
*'''Аргументы''': string strNodePath - путь к узлу
'''<big>void SetNodeValueAsInt(string strNodePath, int iValue)</big>'''
*'''Назначение''': Установить значение узла в int по заданному пути
*'''Возвращаемое значение''': нет
*'''Аргументы''':
**string strNodePath - путь к узлу;
**int iValue - устанавливаемое значение
'''<big>string GetNodeValueAsString(string strNodePath)</big>'''
*'''Назначение''': Получить значение узла в виде string по заданному пути
*'''Возвращаемое значение''': значение узла (string)
*'''Аргументы''': string strNodePath - путь к узлу
'''<big>void SetNodeValueAsString(string strNodePath, string strValue)</big>'''
*'''Назначение''': Установить значение узла в виде string по заданному пути
*'''Возвращаемое значение''': нет
*'''Аргументы''':
**string strNodePath - путь к узлу;
**string strValue - устанавливаемое значение
'''<big>bool GetNodeValueAsBool(string strNodePath)</big>'''
*'''Назначение''': Получить значение узла в виде bool по заданному пути
*'''Возвращаемое значение''': значение узла (bool)
*'''Аргументы''': string strNodePath - путь к узлу
'''<big>void SetNodeValueAsBool(string strNodePath, bool bValue)</big>'''
*'''Назначение''': Установить значение узла в виде bool по заданному пути
*'''Возвращаемое значение''': нет
*'''Аргументы''':
**string strNodePath - путь к узлу;
**bool bValue - устанавливаемое значение
'''<big>bool NodeValueIsError(string strNodePath)</big>'''
*'''Назначение''': Проверка значения узла на ошибку
*'''Возвращаемое значение''': true, если значение узла содержит ошибку; иначе false
*'''Аргументы''': string strNodePath - путь к узлу
'''<big>void StartNode(string strNodePath)</big>'''
*'''Назначение''': Запуск узла по заданному пути
*'''Возвращаемое значение''': нет
*'''Аргументы''': string strNodePath - путь к узлу
'''<big>void StopNode(string strNodePath)</big>'''
*'''Назначение''': Остановка узла по заданному пути
*'''Возвращаемое значение''': нет
*'''Аргументы''': string strNodePath - путь к узлу
====Функции для работы с окнами====
'''<big>void CloseWindow(string strNodePath, int iDisplay)</big>'''
*'''Назначение''': Закрыть окно по заданному пути на дисплее с номером iDisplay
*'''Возвращаемое значение''': нет
*'''Аргументы''':
**string strNodePath - путь к окну;
**int iDisplay - номер дисплея
'''<big>void ShowWindow(string strNodePath, int iDisplay)</big>'''
*'''Назначение''': Отобразить окно по заданному пути на дисплее с номером iDisplay. Координаты — абсолютные, установленные в свойствах окна.
*'''Возвращаемое значение''': нет
*'''Аргументы''':
**string strNodePath - путь к окну;
**int iDisplay - номер дисплея
'''<big>int LoadComposition(string strWindowPath, string strCompositionPath, int iDisplay)</big>'''
*'''Назначение''': Загрузить композицию strCompositionPath в окно strWindowPath на дисплее с номером iDisplay
*'''Возвращаемое значение''': код результата загрузки
*'''Аргументы''':
**string strWindowPath - путь к окну;
**string strCompositionPath - путь к композиции;
**int iDisplay - номер дисплея

*'''Примечания''': функция доступна с версии <code>AS 1.6.25+</code>
====Функции для работы с временем====
'''<big>int GetCurrentTime()</big>'''
*'''Назначение''': Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года)
*'''Возвращаемое значение''': время в секундах (int)
*'''Аргументы''': нет
'''<big>uint64 GetCurrentTimeMs()</big>'''
*'''Назначение''': Получение текущего времени в UNIX формате (количество миллисекунд с 01 января 1970 года)
*'''Возвращаемое значение''': время в миллисекундах (uint64)
*'''Аргументы''': нет
*'''Примечания''': функция доступна с версии <code>AS 1.2.55+</code>, <code>AS 1.6.1+</code>
'''<big>int GetLocalTime()</big>'''
*'''Назначение''': Получение текущего времени в UNIX формате (количество секунд с 01 января 1970 года) с учётом часового пояса
*'''Возвращаемое значение''': локальное время в секундах (int)
*'''Аргументы''': нет
'''<big>int GetHours(int iTime)</big>'''
*'''Назначение''': Получение текущего часа из времени в формате UNIX
*'''Возвращаемое значение''': час (int)
*'''Аргументы''': int iTime - время в формате UNIX
'''<big>int GetMinutes(int iTime)</big>'''
*'''Назначение''': Получение текущих минут из времени в формате UNIX
*'''Возвращаемое значение''': минуты (int)
*'''Аргументы''': int iTime - время в формате UNIX
'''<big>int GetSeconds(int iTime)</big>'''
*'''Назначение''': Получение текущих секунд из времени в формате UNIX
*'''Возвращаемое значение''': секунды (int)
*'''Аргументы''': int iTime - время в формате UNIX
====Функции для работы с событиями====
'''<big>int StoreMessage(int iMessageLevel, string strMessage)</big>'''
*'''Назначение''': Генерация информационного события (типа «сообщение»). Событие помещается в группу «Системные».
*'''Возвращаемое значение''': 0 — успешно, иначе код ошибки
*'''Аргументы''':
**int iMessageLevel - уровень сообщения (1 — наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG;
**string strMessage - текст сообщения

*'''Примечания''': функция доступна с версии <code>AS 1.2.34+</code>
'''<big>int StoreMessage(int iMessageLevel, string strMessage, string strGroup)</big>'''
*'''Назначение''': Генерация информационного события (типа «сообщение»). Событие помещается в указанную при вызове группу.
*'''Возвращаемое значение''': 0 — успешно, иначе код ошибки
*'''Аргументы''':
**int iMessageLevel - уровень сообщения (1 — наивысший): 1=FATAL, 2=ERROR, 3=WARNING, 4=NOTICE, 5=INFO, 6=TRACE, 7=DEBUG;
**string strMessage - текст сообщения;
**string strGroup - имя группы, в которую должно помещаться событие

*'''Примечания''': функция доступна с версии <code>AS 1.6.20+</code>
====Функции для работы со строками====
'''<big>string EncodeMD5(string strText)</big>'''
*'''Назначение''': Кодирование строки в MD5 хэш
*'''Возвращаемое значение''': MD5 хэш параметра
*'''Аргументы''': string strText - исходная строка
*'''Примечания''': функция доступна с версии <code>AS 1.2.34+</code>
====Другие функции====
'''<big>bool isnan(double)</big>'''
*'''Назначение''': Проверка на nan
*'''Возвращаемое значение''': true, если значение является nan; иначе false
*'''Аргументы''': double - проверяемое значение
'''<big>int LaunchProcess(string process)</big>'''
*'''Назначение''': Запуск процесса в операционной системе. Запуск производится в блокирующем режиме, то есть возврат из функции осуществляется по завершению процесса.
*'''Возвращаемое значение''': код завершения процесса
*'''Аргументы''': string process - команда/путь запускаемого процесса

← Предыдущая		Версия 09:28, 11 августа 2026
Строка 1:		Строка 1:
		+	== Общие положения ==
		+	Данное описание предназначено для <code>AgavaSCADA/AgavaPLC 1.2+</code>
		+
	==Standard - стандартная библиотека==		==Standard - стандартная библиотека==
	===Математические и тригонометрические функции===		===Математические и тригонометрические функции===

← Предыдущая		Версия 09:26, 11 августа 2026
Строка 250:		Строка 250:
	*'''Возвращаемое значение''': код завершения процесса		*'''Возвращаемое значение''': код завершения процесса
	*'''Аргументы''': string process - команда/путь запускаемого процесса		*'''Аргументы''': string process - команда/путь запускаемого процесса
		+
		+	[[Категория:AgavaSCADA/AgavaPLC]]

Библиотека Standard AgavaSCADA/AgavaPLC 1.2+ - История изменений

TaushkanovKV в 09:28, 11 августа 2026

TaushkanovKV в 09:26, 11 августа 2026

TaushkanovKV: Новая страница: «==Standard - стандартная библиотека== ===Математические и тригонометрические функции=== ====Прео...»