函数名:

UF_ATTR_get_string_user_attribute

函数功能:

如果属性存在,获取字符串类型属性的值和引用字符串(如果存在)

函数原型:

int UF_ATTR_get_string_user_attribute(tag_t object, const char *title, int index, char **string_value, logical *has_attribute)

参数说明:

object(Input): 持有属性的对象

title(Input): 属性标题

index(Input): 数组索引(如果不是数组,则设置为UF_ATTR_NOT_ARRAY)

string_value(Output to UF_*free*): 字符串属性的值(使用过后需要调用UF_free()函数释放)

has_attribute(Output): 已找到一个属性

注意事项:

1. 当object为NULL_TAG时会报错。如果title为空字符串时会报错。

2. 如果object是原型,则获取原型上的属性,如果object是实例,则获取实例上的属性,如果object是事例,则获取事例上的属性

3. 如果object为事例,但是事例上没有对应标题的属性,就会找实例上对应标题的属性,如果存在则返回实例上的属性值,如果实例也不存在对应标题的属性值则查找原型上对应标题的属性,即此函数会向下查找属性值。

4. string_value使用UF_free释放后,可以再次使用

5. 获取属性的对象object可以不是工作部件