函数名:
UF_ATTR_get_string_user_attribute
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可以不是工作部件