例外処理
Python では、Exception を通常どおり捕捉できます。ランタイムが Zivid Motion のネストされた例外を自動的に展開します。C++ では、Zivid SDK が利用可能な場合は Zivid::toString(const std::exception&) を使用し、利用できない場合は std::rethrow_if_nested を使ってネストされた例外チェーンを手動で展開してください。
Python の例外処理
Python では、Zivid Motion ライブラリからの例外は言語ランタイムによって自動的に処理されます。ネストされた例外は適切に展開され、標準的な Python の例外処理を使用して捕捉できます。
# ...
try:
result = planner.path(...)
except Exception as e:
print(f"An error occurred: {e}")
Python はトレースバック内のネストされた例外を自動的に処理するため、例外チェーン全体を表示するために特別な操作を行う必要はありません。
C++ 例外処理
C++ では、例外をネストすることで、何が問題だったのかをより詳細に把握できます。Zivid Motion では、関連するエラーを連鎖させるためにネストされた例外を使用します。これらの例外を適切に処理するには、ネストされた例外チェーンを明示的に展開する必要があります。
Zivid SDK がインストールされています
Zivid SDK にアクセスできる場合は、ネストされた例外を自動的に処理する Zivid::toString(const std::exception&) 関数を使用できます。
#include <Zivid/Exception.h>
#include <Zivid/Motion/Planner.h>
#include <iostream>
int main()
{
// ...
try
{
auto result = planner.path(...);
}
catch(const std::exception &e)
{
std::cerr << "Error: " << Zivid::toString(e) << std::endl;
}
}
Zivid::toString() 関数は、例外メッセージとネストされた例外をフォーマットし、何が問題だったのかの完全なコンテキストを簡単に理解できるようにします。
Zivid SDK がインストールされていない場合
Zivid SDK にアクセスできない場合 (たとえば、スタンドアロンの Zivid Motion アプリケーションの場合)、ネストされた例外を手動で処理する必要があります。
#include <Zivid/Motion/Planner.h>
#include <iostream>
#include <exception>
void printException(const std::exception &e, const int level = 0)
{
std::cerr << std::string(level * 4, ' ') << (level ? "+ " : "") << "Exception: " << e.what() << '\n';
try
{
std::rethrow_if_nested(e);
}
catch(const std::exception &nestedException)
{
printException(nestedException, level + 1);
}
catch(...)
{}
}
int main()
{
// ...
try
{
auto result = planner.path(...);
}
catch(const std::exception &exception)
{
printException(exception);
}
}
この方法では、printException ヘルパー関数を使用して、ネストされた例外を再帰的に展開し、適切なインデントを付けて出力することで、失敗に至った一連のエラーの全体像を示します。