op_ima_obj_attr_get_str()

摘要

获取指定对象中某个 string 类型属性的值。

语法

op_ima_obj_attr_get_str (objid, attr_name, buffer_size, value_buffer)
参数 类型 说明
objid Objid 关注对象的对象 ID
[对象 ID 可以从 Topo 包和 Id 包中的多个内核过程获得:op_id_self()、op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。]
attr_name const char * 关注属性的名称
[该属性必须是指定对象中已定义的 string 类型属性,否则会发生错误。]
buffer_size unsigned int value_buffer 的大小(包含结尾 '\0' 所占的空间)
value_buffer char * 指向某个变量的指针,该变量将被填入指定属性的值(值的最大长度为 buffer_size – 1 个字符)

返回类型

Compcode

若成功获取属性值,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。

示例

char     tx_nodename [128];

/* Determine the transmitting node id and name */
tx_nodeid = op_id_parent (op_td_get_int (pkptr, OPC_TDA_RA_TX_OBJID));
op_ima_obj_attr_get_str (tx_nodeid, "name", 128, tx_nodename);

详情

字符串属性可以是任意长度;但显示给用户的字符最多为 2048 个。请确保 *value_buffer 足够大以容纳预期的属性值。

用途

提供一种在仿真过程中动态获取对象属性的机制。该内核过程与 op_ima_obj_attr_get() 的工作方式完全相同,但仅适用于数据类型为 string 的对象属性。完整用途与详情参见 op_ima_obj_attr_get()。

错误

  • 与 op_ima_obj_attr_get() 相同,外加以下内容:
  • 程序中止:属性(<name>)的类型为(<type>)。无法以 string 类型获取其值。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com