utResult包包含以下过程和函数。

初始化结果数据。utResult.init。
显示结果。utResult.show、utResult.showone、utResult.showlast。
显示最后一个测试的成功或失败。utResult.success、utResult.failure。
迭代访问结果数组。utResult.firstresult、utResult.nextresult、utResult.nthresult、utResult.resultcount。
控制成功测试的显示。utResult.include_successes、utResult.ignore_successes。

utResult包提供了一个控制utAsert断言程序输出信息的API。utPLSQL.test与utPLSQL.testsuite的结果通过utResult.show过程进行显示。因此，通常不需要执行任何操作。但是，如果想要从其他环境中访问这些信息（例如Oracle Forms或Java等），或者构建自己的断言逻辑或者测试引擎，可以使用utResult包中的程序。

1、初始化

要初始化utResult数据，使用以下过程将其设置为NULL：

PROCEDURE init (from_suite_in IN BOOLEAN := FALSE);

2、显示结果

使用以下三个过程之一显示测试结果。

PROCEDURE show (
      run_id_in   IN   utr_outcome.run_id%TYPE := NULL,
      reset_in    IN   BOOLEAN := FALSE
   );

PROCEDURE showone (
      run_id_in   IN   utr_outcome.run_id%TYPE := NULL,
      indx_in     IN   PLS_INTEGER
);

PROCEDURE showlast (run_id_in IN utr_outcome.run_id%TYPE := NULL);

其中，run_id_in用于查看某一次测试内的结果。

使用show过程显示utResult数组中的全部结果。如果reset_in设置为TRUE，将会初始化结果信息。

使用showone过程显示第n个结果。

使用showlast显示最后一个测试结果。

3、检索测试状态

函数success与failure用于返回最后一次测试的状态。

FUNCTION success (run_id_in IN utr_outcome.run_id%TYPE := NULL)
      RETURN BOOLEAN;

   FUNCTION failure (run_id_in IN utr_outcome.run_id%TYPE := NULL)
      RETURN BOOLEAN;

4、遍历结果数组

utPLSQL.show过程遍历utResult结果数组并显示信息。同样也可以使用以下程序组合编写相同的逻辑。

PROCEDURE firstresult (run_id_in IN utr_outcome.run_id%TYPE := NULL);

   FUNCTION nextresult (run_id_in IN utr_outcome.run_id%TYPE := NULL)
      RETURN result_rt;

   PROCEDURE nextresult (
      name_out        OUT      VARCHAR2,
      msg_out         OUT      VARCHAR2,
      case_indx_out   OUT      PLS_INTEGER,
      run_id_in       IN       utr_outcome.run_id%TYPE := NULL
   );

   FUNCTION nthresult (
      indx_in     IN   PLS_INTEGER,
      run_id_in   IN   utr_outcome.run_id%TYPE := NULL
   )
      RETURN result_rt;

   PROCEDURE nthresult (
      indx_in         IN       PLS_INTEGER,
      name_out        OUT      VARCHAR2,
      msg_out         OUT      VARCHAR2,
      case_indx_out   OUT      PLS_INTEGER,
      run_id_in       IN       utr_outcome.run_id%TYPE := NULL
   );

   FUNCTION resultcount (run_id_in IN utr_outcome.run_id%TYPE := NULL)
      RETURN PLS_INTEGER;

5、控制成功信息的显示

以下程序可以打开或关闭成功信息的显示。也就是说，打开时（默认）会显示成功的断言程序的信息；否则，只显示失败信息。

procedure include_successes;
procedure ignore_successes;

下一个，utAssert包

utPLSQL用户指南三

1、初始化

2、显示结果

3、检索测试状态

4、遍历结果数组

5、控制成功信息的显示