osg.TestResult

osg.TestResult是OpenSceneGraph中用于记录测试结果的类。

概述

osg.TestResult是OpenSceneGraph测试框架中的一个关键组件。该类用于记录测试结果，并提供了各种方法来管理和检查这些结果。osg.TestResult维护了一个测试结果集合，并可以添加、删除、更新结果。结果可以分为几个级别，从最简单的PASS、FAIL、SKIP等级别到自定义级别。

详细说明

osg.TestResult包含以下方法：

• TestResult() 构造函数。
• clear() 清空测试结果集合。
• getNumResults() 获取测试结果集合中结果的数量。
• addResult(const std::string& name, osg::Test::Result result, const std::string& message="", const std::string& file="", int line=0) 向测试结果集合中添加一个结果。
  • name: 结果的名称。
  • result: 结果级别（PASS、FAIL、SKIP等）。
  • message: 结果的详细信息。
  • file: 与结果相关的文件名。
  • line: 与结果相关的行数。
• getResult(int i) 获取指定索引的测试结果。
• getResultByName(const std::string& name) 获取指定名称的测试结果。
• removeResult(int i) 删除指定索引的测试结果。
• removeResultByName(const std::string& name) 删除指定名称的测试结果。
• updateResult(int i, osg::Test::Result result, const std::string& message="", const std::string& file="", int line=0) 更新指定索引的测试结果。
  • result: 结果级别（PASS、FAIL、SKIP等）。
  • message: 结果的详细信息。
  • file: 与结果相关的文件名。
  • line: 与结果相关的行数。
• updateResultByName(const std::string& name, osg::Test::Result result, const std::string& message="", const std::string& file="", int line=0) 更新指定名称的测试结果。
  • result: 结果级别（PASS、FAIL、SKIP等）。
  • message: 结果的详细信息。
  • file: 与结果相关的文件名。
  • line: 与结果相关的行数。
• hasPassed() 返回测试结果中是否有PASS级别的结果。
• hasFailed() 返回测试结果中是否有FAIL级别的结果。
• hasSkipped() 返回测试结果中是否有SKIP级别的结果。

示例

下面是一个简单的示例，展示了如何使用osg.TestResult来记录测试结果。

#include <osg/Testing/TestResult.h>

int main(int argc, char** argv)
{
    osg::TestResult result;
    result.addResult("Test1", osg::Test::SKIPPED);
    result.addResult("Test2", osg::Test::PASS);
    result.addResult("Test3", osg::Test::FAIL, "Test failed for some reason.", "test.cpp", 42);

    std::cout << "Result count: " << result.getNumResults() << std::endl;
    std::cout << "Has passed: " << result.hasPassed() << std::endl;
    std::cout << "Has failed: " << result.hasFailed() << std::endl;
    std::cout << "Has skipped: " << result.hasSkipped() << std::endl;

    osg::Test::Result r = result.getResult(2);
    std::cout << "Test3 result: " << r << std::endl;

    return 0;
}

这个示例会输出以下内容：

Result count: 3
Has passed: 1
Has failed: 1
Has skipped: 1
Test3 result: FAIL

参考

• OpenSceneGraph官方文档：osg::TestResult Class Reference