Функция считывает все значения параметра конфигурации, которые встречаются в файле конфигурации более одного раза. Функция может использоваться, например, для чтения значений параметра «путь_проекта», параметра «LoadCtrlLibs» или прочих. |
Краткое описание
int paCfgReadValueList(string filename, string section, string key, dyn_string &value[, string separator[, string host]]); |
Параметр
Параметр | Описание |
filename | Имя конфигурационного файла, например «config» или «config.level». |
section | Секция конфигурационного файла, например «general» |
key | Параметр конфигурации, чье значение считывается, например «langs» |
value | Считываемое значение. |
separator | Функция разделяет значение по паре параметр-значение с помощью разделителя. |
host | В случае указания данного параметра считываются только параметры с этим узлом, например «$host1». В случае если запись пустая «» считываются только параметры без имени хоста. В случае отсутствия определений хоста параметры хостов не считываются. |
Возвращаемое значение
В случае ошибок функция возвращает -1, в противном случае 0. |
Ошибки
Недостающие или ошибочные аргументы. |
Описание
Функция считывает все значения параметра конфигурации, которые встречаются в файле конфигурации более одного раза. |
ПРИМЕР В примере ниже демонстрируется считывание всех значений параметров «LoadCtrlLibs» со всех секций файла «config.level». Значения отделяются разделителем. Все секции файла определены пустой строкой string section = «»; #uses «CtrlPv2Admin main() { int val; string filename = «c:/Programme/Sybcom/PVSS2/3.0/config/config.level»; string section = «ui»; string separator = «,»; dyn_string val1; val = paCfgReadValueList(filename,section, «LoadCtrlLibs»,val1,separator); /* Считывание всех значений записей LoadCtrlLibs из ui файла config.level . Значения отделяются разделителем «,». */ DebugN(val1); } ПРИМЕЧАНИЕ Следует отметить, что максимальное количество символов в строке конфигурационного файла ограничено 511 символами (также см. Configuration file). В случае превышения данного числа, возвращается -1. |
ПРИМЕР Следующий пример считывает все значения параметра langs entry из секции [general] файла конфигурации (проект «test»). main() { int val; string filename = «c:/KASKAD_Proj/test/config/config»; string section = «general»; dyn_string val1; val = paCfgReadValueList(filename,section,»langs»,val1); DebugN(val1); } |
Используется для объекта
Функции администрирования проектов |
Доступность
CTRL |
См. также