halcon/c++接口基础之异常处理

关于运行错误，HALCON/C++默认打印错误信息并且终止程序。然而在某些应用中，放宽这个法则可能更有用。比如，如果一个应用要求用户交互式地指定一个图像文件读取，如果因为用户不能拼错文件名而终止程序的话，会很不方便。因此，HALCON/C++允许集成你自己的错误处理代码。如下的章节将分别介绍面向对象的方法和面向过程的方法。

面向对象的方法

如果一个运行错误发生在面向对象的调用中，类HException的实例将会创建。（图5.8为类的定义）

class LIntExport HException {
public:HException(const HException &except);HException(const char *f, Hlong l, const char *p, Herror e, const char *m);HException(const char *f, Hlong l, const char *p, const char *m);HException(const char *f, Hlong l, const char *p, Herror e);static Handler InstallHHandler(Handler proc);void           PrintException(void);static Handler handler;   /* handler in use */Hlong          line;      /* line number where error occured */char           *file;     /* file name where error occured */char           *proc;     /* Name of procedure/operator */Herror         err;       /* error number */char           *message;  /* error text */
};

Figure 5.8: Part of the declaration of the class HException.
以上这个例子，包含了错误的所有信息。其中一个异常重要的成员如下：

line:错误发生的项目行号
file:错误发生的文件名
proc:实际的HALCON算子的名字
err: 错误代号，see below
message: 错误文本
当发生后，HException的对象被传递到所谓的异常句柄。HALCON的默认异常句柄将打印对应的错误信息，并且终止程序。

作为另一种可替代的方法，你可以实现和使用你自己的异常处理。为了作为HALCON exception handler，一个程序必须有如下的签名：

typedef void (*Handler)(const Halcon::HException &exception);

然后通过HException的方法InstallHHandler安装你的异常处理程序。（见图5.8）这样一旦发生了运行错误，HALCON然后调用你自己的程序，传递实际的异常的对象作为参数。

如下的例子将展示如何使用一个用户指定的异常处理器和标准的C++异常处理机制(try catch)一起使用.对应的项目example_errorhandle.cpp可以在%HALCONEXAMPLES%\cpp的子目录找到。它实现了以上指定的目的：你可以键入一个文件名去读取；如果文件不存在，项目将打印一个对应的信息但不会停止程序，而是继续运行。

项目的开始，一个用户指定的异常处理器使用如下的方法安装：

HException::InstallHHandler(&MyHalconExceptionHandler);

被安装的程序简单地调用C++的异常处理机制throw：

void MyHalconExceptionHandler(const Halcon::HException& except)
{throw except;
}

ReadImage的调用被一个try 区域封装，一个可能的异常可以在catch中捕获：

Herror  error_num; try
{image = HImage::ReadImage(filename);
}
catch (HException &except)
{error_num = except.err;return error_num;
}
return H_MSG_TRUE;

面向过程的方法

正如section “Calling HALCON Operators”中看到的那样，面向过程的方法返回一个Herror类型的数据。这个数据会分为两类：信息H_MSG_* and 错误 H_ESR_*.

典型地，如果没有错误发生，HALCON算子返回信息H_MSG_TRUE.

一旦遇到一个错误，HALCON默认打印所谓的错误信息并且终止程序。你可以通过算子set_check指定异常是否忽略。如下的例子代码检测一个文件是否正确打开；一旦遇到错误，将打印所谓的错误信息，可以通过get_error_text获得错误信息。

Herror         error_num;
char           message[1024];
long           file;set_check("~give_error");
error_num = open_file("not_existing_file", "input", &file);
set_check("give_error");if (error_num != H_MSG_TRUE)
{get_error_text(error_num, message);cout << "HALCON error " << error_num << ": " << message;
}

请注意一些数组算子没有返回值。这样，被描述的方法会导致一个内存泄漏。请使用面向对象的方法代替。