Функция СЧИТАТЬ_ГЛОБ_АЛГ_ПАРАМ
Для работы требуется соединение с базой данных.
Функция СЧИТАТЬ_ГЛОБ_АЛГ_ПАРАМ позволяет получить значение глобальных параметров по имени набора. Запись набора могла быть выполнена ранее функцией УСТ_ГЛОБ_АЛГ_ПАРАМ в контексте текущей или другой программы.
ФУНКЦИЯ ЛОГИКА: СЧИТАТЬ_ГЛОБ_АЛГ_ПАРАМ(СТРОКА: имя;
ПЕРЕМ АЛГ_ПАРАМ: парам)
Параметры
- имя
- Имя набора параметров – произвольная строка, задаваемая разработчиком.
- парам
- Выходной параметр. Переменная, принимающая набор глобальных параметров.
Возвращаемое значение
ДА – в случае успешного считывания, НЕТ – если набор с указанным именим не существует или в случае ошибки.
Обрабатывать результат можно с помощью функции ПОСЛ_ОШИБКА.
Замечание
Глобальные наборы параметров относятся к текущей сессии. Наборы параметров можно использовать как на стороне клиента, так и на стороне сервера, но это будут разные наборы. Т.к. дополнительные сессии автоматически закрываются при завершении программы, то и все соответствующие им наборы параметров автоматически удаляются.
При закрытии основной сессии (например, при смене пользователя или базы данных в клиентском приложении) все наборы глобальных параметров удаляются.
Глобальные наборы параметров могут использоваться для кэширования данных в контексте сессии. При необходимости сбросить кэш можно удалить набор параметров функцией УДАЛИТЬ_ГЛОБ_АЛГ_ПАРАМ.
Пример
Приведенная программа поочередно создает и удаляет набор параметров с именем "альфа". При первом, 3-м, 5-м и т.д. запуске набора с таким именем нет и он создается. При втором, 4-м и т.д. запуске набор существует, он считывается, а затем удаляется.
ВЫЧИСЛИТЬ
ПЕРЕМ АЛГ_ПАРАМ: п
ПЕРЕМ рез = СЧИТАТЬ_ГЛОБ_АЛГ_ПАРАМ("альфа", п)
ЕСЛИ рез ТО // набор существует
ОТЛАДКА("Существует: " + СТР(рез) + " " + СТР(п))
рез = УДАЛИТЬ_ГЛОБ_АЛГ_ПАРАМ("альфа")
ОТЛАДКА("Удаление: " + СТР(рез))
ИНАЧЕ // набор не существует - создаем его
п.парам["пи"] = 3.14
рез = УСТ_ГЛОБ_АЛГ_ПАРАМ("альфа", п)
ОТЛАДКА("Запись: " + СТР(рез))
ПЕРЕМ АЛГ_ПАРАМ: пк // чистая переменная для контрольного считывания
рез = СЧИТАТЬ_ГЛОБ_АЛГ_ПАРАМ("альфа", пк)
УТВ(рез)
ОТЛАДКА("Контрольное чтение: " + СТР(пк))
КОНЕЦ_ЕСЛИ
КОНЕЦ
Вывод при нечетном запуске:
Запись: +
Контрольное чтение: АЛГ_ПАРАМ[парам=("пи":3.14)]
Вывод при четном запуске:
Существуют: + АЛГ_ПАРАМ[парам=("пи":3.14)]
Удаление: +