1 Функции макросов

Обзор

Функции макросов дают возможность индивидуализации значений макросов.

Периодически макрос может раскрыться в значение с которым не всегда легко работать. Значение может быть длинным или содержать определённую подстроку, которая вас интересует и которую вы бы хотели извлечь. Это та задача, где функции макросов могут быть полезны.

Синтаксис функции макросов:

{<макрос>.<функция>(<параметры>)}

где:

• <макрос> - настраиваемый макрос (например, {ITEM.VALUE} или {#LLD_МАКРОС})
• <функция> - применяемая функция
• <параметры> - список параметров функции разделенных запятыми. Параметры необходимо заключать в кавычки, если они начинаются с '' '' (пробела), " или содержат ), ,.

Например:

{{TIME}.fmttime(формат,сдвиг_времени)}
       {{ITEM.VALUE}.regsub(шаблон, вывод)}
       {{#LLD_МАКРОС}.regsub(шаблон, вывод)}

Поддерживаемые функции макросов

Если функция используется в поддерживаемых местах, но применён макрос, который не поддерживает функции макросов, тогда макрос раскроется в 'НЕИЗВЕСТНО'.

Если шаблон не соответствует регулярному выражению, тогда макрос раскрывается в 'НЕИЗВЕСТНО' (за исключением макросов низкоуровневого обнаружения, где в этом случае функция будет проигнорирована и макрос останется нераскрытым)

Если функция макросов применяется в макросе в местах, которые не поддерживают функции макросов, тогда функция будет игнорироваться.

Примеры

Способы использования функции макросов для индивидуализации значений проиллюстрированы следующими примерами полученных значений:

Просмотр полных значений элемента данных

Длинные значения раскрытых макросов {ITEM.VALUE} и {ITEM.LASTVALUE} обрезаются до 20 символов. Для просмотра полных значений этих макросов вы можете использовать функции макросов, например:

{{ITEM.VALUE}.regsub("(.*)", \1)}
{{ITEM.LASTVALUE}.regsub("(.*)", \1)}