使用TagGroupGetTagAsBoolean时如何检测tag_path是否存在？

问题背景 #

使用TagGroup存储标志与参数时，调用TagGroupGetTagAsBoolean(tag_path, value)读取标签值，若指定tag_path不存在，变量会保留初始值（如0），无法直接通过返回值判断标签是否存在。需要可靠的标签存在性检测方法，且因需处理大量标签，希望方案高效。

代码示例 #

String config_path = "C:\\Program Files\\Gatan\\Plugins\\config.gtg";

TagGroup ui_config_tg = NewTagGroup();
ui_config_tg.TagGroupLoadFromFile(config_path);
Number jpg_flag = 0;  // 初始化为0
ui_config_tg.TagGroupGetTagAsBoolean("flag:jpg_flag", jpg_flag);

// 此时若"flag:jpg_flag"不存在，jpg_flag仍为0，如何判断标签是否存在？

核心问题 #

1. 是否有内置方法检测TagGroup中指定tag_path是否存在？
2. 若无内置方法，如何高效批量检测标签存在性？

解决方案 #

1. 内置检测方法 #

Gatan的TagGroup API提供了TagGroupDoesTagExist方法，可直接检测指定路径的标签是否存在，返回布尔值。用法如下：

String tag_path = "flag:jpg_flag";
if (ui_config_tg.TagGroupDoesTagExist(tag_path)) {
    ui_config_tg.TagGroupGetTagAsBoolean(tag_path, jpg_flag);
} else {
    // 标签不存在的处理逻辑
}

该方法为官方内置，可靠性高，单次检测性能开销极低，适合单标签的存在性验证。

2. 批量检测的高效方案 #

若需批量检测大量标签，可通过以下两种方式优化性能：

方案一：预遍历构建标签路径索引

先递归遍历整个TagGroup，将所有标签的完整路径存入索引结构，后续检测直接查询索引即可，避免重复路径解析开销：

TagGroup BuildTagPathIndex(TagGroup tg, String parent_path = "") {
    TagGroup index = NewTagGroup();
    Number num_tags = tg.TagGroupCountTags();
    for (Number i = 0; i < num_tags; i++) {
        String tag_name;
        TagGroup child_tg;
        if (tg.TagGroupGetTagAsTagGroup(i, tag_name, child_tg)) {
            String full_path = parent_path == "" ? tag_name : parent_path + ":" + tag_name;
            index.TagGroupSetTagAsString(full_path, "exists");
            // 递归处理子TagGroup
            TagGroup child_index = BuildTagPathIndex(child_tg, full_path);
            index.TagGroupMerge(child_index);
        } else {
            // 处理非TagGroup类型的标签
            tg.TagGroupGetTagName(i, tag_name);
            String full_path = parent_path == "" ? tag_name : parent_path + ":" + tag_name;
            index.TagGroupSetTagAsString(full_path, "exists");
        }
    }
    return index;
}

// 使用方式
TagGroup tag_index = BuildTagPathIndex(ui_config_tg);
StringList check_tags = NewStringList();
check_tags.StringListAdd("flag:jpg_flag");
check_tags.StringListAdd("flag:png_flag");
check_tags.StringListAdd("setting:resize");

for (Number i = 0; i < check_tags.StringListCount(); i++) {
    String tag_path = check_tags.StringListGetString(i);
    if (tag_index.TagGroupDoesTagExist(tag_path)) {
        // 标签存在，执行读取操作
    } else {
        // 标签不存在的处理逻辑
    }
}

该方式仅需遍历一次TagGroup，后续检测为O(1)查询，适合大量标签的批量检测场景。

方案二：拆分路径逐层验证

对于结构已知的TagGroup，拆分路径逐层验证，减少深层路径解析开销：

Boolean TagPathExists(TagGroup root_tg, String tag_path) {
    StringList path_parts = SplitString(tag_path, ":");
    TagGroup current_tg = root_tg;
    for (Number i = 0; i < path_parts.StringListCount(); i++) {
        String part = path_parts.StringListGetString(i);
        if (!current_tg.TagGroupDoesTagExist(part)) {
            return false;
        }
        // 中间节点必须是TagGroup类型
        if (i < path_parts.StringListCount() - 1) {
            TagGroup child_tg;
            if (!current_tg.TagGroupGetTagAsTagGroup(part, child_tg)) {
                return false;
            }
            current_tg = child_tg;
        }
    }
    return true;
}

// 使用方式
if (TagPathExists(ui_config_tg, "flag:jpg_flag")) {
    // 标签存在的处理逻辑
}

该方法避免了一次性解析完整路径的开销，对层级较深的标签性能更优，尤其适合批量检测同层级标签。

内容的提问来源于stack exchange，提问作者ChenZX