Возвращает все имена точек данных или имена элементов точек данных, которые соответствуют шаблону. Структуры точек данных записываются в массив в алфавитном порядке.

Краткое описание

dyn_string dpNames([string dpPattern[,string dpType]]);

Параметр

Параметр	Значение
dpPattern	Pattern (трафаретная)
dpType	Тип точки данныхПозволяет ограничить возвращаемые точки данных определенным типом точек данных. При использовании параметра будут возвращены только точки данных, которые соответствуют шаблону и выбранному типу точки данных.

ВНИМАНИЕ

Примите во внимание, что функция возвращает имена типов точек данных на систему!

Возвращаемое значение

Список с точками данных или элементами точек данных.

Ошибка

Ошибки можно вывести при помощи getLastError(). Если обнаружены недостающие аргументы или отсутствие точки данных. Если в качестве типа указан «0».

Описание

Функция dpNames() возвращает все имена точек данных или имена элементов точек данных, которые соответствуют шаблону dpPattern. Опция dpType не указан, возвращаются все имена точек данных. Если шаблон dpPattern не указан, возвращаются все имена точек данных. Знаки подстановки также могут быть использованы для фильтрации имен точек данных. Таким образом dpNames («*») относится только к верхнему уровню (корневые элементы) структуры точек данных и возвращает все имена точек данных. Поэтому она эквивалентна dpNames().

Если точка данных возвращается со структурой, структура должна быть описана. Находятся только точки данных, имеющие указанное число уровней. Уровни разделяются точкой. dpNames (**) эквивалентна dpNames (*.*). Кроме того:      «:*» возвращает все конфигурационные элементы, «:config.*» возвращает все подробные данные, «:config.detail.*» возвращает все атрибуты «dp.el:*» возвращает только конфигурационные элементы, согласно элементу точки данных , например, нет параметра _original для узла. dpNames позволяет также запрашивать точки данных из другой системы ПРИМЕЧАНИЕ Учтите, что конфигурационная запись maxDpNamesCount = xxx может использоваться для ограничения количества запрашиваемых точек данных. При указании записи в конфигурационном файле и вызове функции dpNames(), когда возвращаемое значение функции превышает количество, разрешенное конфигурационной записью, отображается сообщение об ошибке.

Например: Тип точки данных engine (двигатель)

• • Функция dpNames (*.*.*) находит двигатель, потому обнаружены появления engine с тремя уровнями.
    
    engine.setpoint.engineSpeed
     
  • Функция dpNames (*.*) находит двигатель, потому обнаружены появления engine с двумя уровнями.
    
    engine.setpoint и engine.currentValue

Стандартный сопоставление с шаблоном применяется в пределах уровня, например, dpNames («*DP*») находит точки данных Example DP_Arg2, ExampleDP_DDE, _DP и т.д..

ПРИМЕЧАНИЕ

Запросы с знаками подстановки для dpType не допускаются!

ПРИМЕР Присвоение всех элементов точки данных Valve17, в том числе Valve17.opening, именам переменных. main() {   dyn_string names;   names = dpNames(«Valve17.*»); }

ПРИМЕР Пример знаков подстановки в списках опций main() {   string s;   DebugN(dpNames(s = «{*.Ala.*,*.Ala*}»), s);   DebugN(dpNames(s = «*{.Ala.,.Ala}*»), s);   DebugN(dpNames(s = «*.A{la.,la}*»), s);   DebugN(dpNames(s = «*.Al{a.,a}*»), s);   DebugN(dpNames(s = «*.Ala{.,}*»), s);   DebugN(dpNames(s = «*.Ala{.}*»), s);   DebugN(dpNames(s = «*.Ala.*»), s);   DebugN(dpNames(s = «*.Ala*»), s); }

ПРИМЕР Запрос точек данных с дополнительным именем системы. Сохраняет имена всех элементов точек данных Valve17 из System2 в именах переменных.main(){  dyn_string names;  name = dpNames(«System2:Valve17.*»);}

Используется для объекта

Функция точки данных, Управляющие функции ожидания

Доступность

CTRL

См. также