こんにちは、id:mitsutaka-takadaです。
C++でエラー通知というとエラー・コードや例外が通常の手段かと思います。エラー・コードは戻り値でenumを返すことでエラーを通知します。
例外と比較してenumオブジェクトを返すのみで、とても軽量な通知手段です。
今回の記事では複数のエラー・コードを型消去によってまとめて扱う方法を書きたいと思います。
ゴール
例えば、ネットワーク・リクエストとデータベース・アクセスをしている関数があるとします。それぞれ自身のドメインに関するエラーをエラー・コード(NetworkError&DatabaseError)で通知してくるとき、この関数はエラー・コード(SomeError)として何を返せばよいでしょうか？
#include <string>
#include <experimental/string_view>
enum class NetworkError{
NoError,
SomeNetworkError
};
enum class DatabaseError{
NoError,
SomeDatabaseError
};
std::pair<std::string, DatabaseError>
getAccountIdFromDatabase(std::string_view userId){
return {"", DatabaseError::SomeDatabaseError};
}
std::pair<int, NetworkError>
getAccountBalanceFromNetwork(std::string_view accountId){
return {-1, NetworkError::SomeNetworkError};
}
struct SomeError{};
std::pair<int, SomeError>
getUserBalance(std::string_view userId){
if(auto [accountId, databaseError] = getAccountIdFromDatabase(userId);
databaseError == DatabaseError::SomeDatabaseError){
return {};
}
else if(auto [balance, networkError] = getAccountBalanceFromNetwork(accountId); networkError == NetworkError::SomeNetworkError){
return {};
}
else {
return {balance, {}};
}
}
<system_error>
エラーコードの和集合、Variantを利用する（下記、おまけ参照）など、いくつか考えられると思いますが、
今回はC++11で導入された<system_error>を利用した方式を紹介したいと思います。
SomeErrorにNetworkErrorやDatabaseErrorが代入でき（型消去）、SomeErrorからその情報を取得するのが目標です。
<system_error>では、複数ドメインのエラーコードを１つのenumとして統一的に扱うためstd::error_codeを用意しています。std::error_codeはエラーコード（整数値）とカテゴリ(ドメインを表すstd::error_categoryオブジェクト)の対です。エラーコードは整数値で複数ドメインをまたいで一意性が保証されていません。例えば、NetworkError::SomeErrorとDatabaseError::SomeErrorに同じ１という値が割り当てられているかもしれません。そのため単純に整数値を比較するだけではNetworkError::SomeErrorとDatabaseError::SomeErrorを識別できなくなります。これを防ぐためにカテゴリを使用します。
std::error_codeを使用するには、以下の３ステップが必要です。
- エラーコードを
std::error_codeで使用できるように登録する。(std::is_error_code_enumの特殊化）
- ドメイン用のカテゴリを定義する。(
std::error_categoryの派生クラスの定義)
- エラーコードとカテゴリの紐づけを行う。(
make_error_codeオーバーロードの定義)
実際にstd::error_codeを使用したコードを見てみましょう。
#include <iostream>
#include <string>
#include <experimental/string_view>
#include <system_error>
enum class NetworkError{
NoError,
SomeNetworkError
};
enum class DatabaseError{
NoError,
SomeDatabaseError
};
namespace std{
template<>
struct std::is_error_code_enum<NetworkError> : std::true_type{};
template<>
struct std::is_error_code_enum<DatabaseError> : std::true_type{};
}
struct NetworkErrorCategory : std::error_category{
const char* name() const noexcept override{
return "NetworkErrorCategory";
}
std::string message(int ev) const override{
switch(static_cast<NetworkError>(ev)){
case NetworkError::SomeNetworkError:
return "some network error occured";
case NetworkError::NoError:
return "no error";
}
}
};
struct DatabaseErrorCategory : std::error_category{
const char* name() const noexcept override{
return "DatabaseErrorCategory";
}
std::string message(int ev) const override{
switch(static_cast<NetworkError>(ev)){
case NetworkError::SomeNetworkError:
return "some database error occured";
case NetworkError::NoError:
return "no error";
}
}
};
NetworkErrorCategory const networkErrorCategoryInstance;
DatabaseErrorCategory const databaseErrorCategoryInstance;
inline
std::error_code make_error_code(NetworkError ne){
return {static_cast<std::underlying_type_t<NetworkError>>(ne), networkErrorCategoryInstance};
}
inline
std::error_code make_error_code(DatabaseError de){
return {static_cast<std::underlying_type_t<DatabaseError>>(de), databaseErrorCategoryInstance};
}
std::pair<std::string, DatabaseError>
getAccountIdFromDatabase(std::string_view userId){
return {"", DatabaseError::SomeDatabaseError};
}
std::pair<int, NetworkError>
getAccountBalanceFromNetwork(std::string_view accountId){
return {-1, NetworkError::SomeNetworkError};
}
std::pair<int, std::error_code>
getUserBalance(std::string_view userId){
if(auto [accountId, databaseError] = getAccountIdFromDatabase(userId);
databaseError == DatabaseError::SomeDatabaseError){
return {-1, databaseError};
}
else if(auto [balance, networkError] = getAccountBalanceFromNetwork(accountId);
networkError == NetworkError::SomeNetworkError) {
return {-1, networkError};
}
else {
return {balance, std::error_code{}};
}
}
int main(){
if(auto const [balance, error] = getUserBalance("mitsutaka-takeda");
!error
){
std::cout << "my balance is " << balance << std::endl;
}
else{
if(error == NetworkError::SomeNetworkError){
}
else if(error == DatabaseError::SomeDatabaseError){
}
}
}
まず、getUserBalanceで複数ドメインのエラーをstd::error_codeとして統一できていることに注目してください。各ドメインのエラーコードNetworkErrorやDatabaseErrorからstd::error_codeへの変換は暗黙的に行われます。
またmain関数のエラーハンドリングで、std::error_codeからエラー情報を取得する際、各ドメインのエラーコード(NetworkError::SomeNetworkErrorやDatabaseError::SomeDatabaseError)と直接比較しています。
std::error_code自体はポリモーフィズムも利用せず整数値とオブジェクトへの参照の対で軽量な構造体であり、既存のエラーコードに非侵入的に使用できるため色々な場面で活躍できます。またC++の標準ライブラリでも使用されており統一されたエラーハンドリングを行うための基礎になります。
他にも複数のエラーコードをグルーピングするstd::error_conditionなど応用もあるので興味がある方は参考のリンクを見てください。
参考
おまけ
エラーコードの和集合
SomeErrorをNetworkErrorとDatabaseErrorの値の和として定義することで、２つのエラー情報を持つエラーコードを返すことができます。SomeErrorにNetworkErrorとDatabaseErrorのコードに対応するコードをすべて追加して、NetworkError/DatabaseErrorからSomeErrorへの変換処理fromNetworkError/fromDatabaseErrorを書きます。
std::error_codeと比較すると、各ドメインのエラーコードへの修正がSomeErrorなど他の箇所にも影響を与えます。
#include <string>
#include <experimental/string_view>
enum class NetworkError{
NoError,
SomeNetworkError
};
enum class DatabaseError{
NoError,
SomeDatabaseError
};
enum class SomeError{
NoError,
SomeNetworkError,
SomeDatabaseError
};
SomeError
fromNetworkError(NetworkError networkError){
return networkError == NetworkError::NoError ? SomeError::NoError : SomeError::SomeNetworkError;
}
SomeError
fromDatabaseError(DatabaseError databaseError){
return databaseError == DatabaseError::NoError ? SomeError::NoError : SomeError::SomeDatabaseError;
}
std::pair<std::string, DatabaseError>
getAccountIdFromDatabase(std::string_view userId){
return {"", DatabaseError::SomeDatabaseError};
}
std::pair<int, NetworkError>
getAccountBalanceFromNetwork(std::string_view accountId){
return {-1, NetworkError::SomeNetworkError};
}
std::pair<int, SomeError>
getUserBalance(std::string_view userId){
if(auto [accountId, databaseError] = getAccountIdFromDatabase(userId);
databaseError == DatabaseError::SomeDatabaseError){
return {-1, fromDatabaseError(databaseError)};
}
else if(auto [balance, networkError] = getAccountBalanceFromNetwork(accountId);
networkError == NetworkError::SomeNetworkError) {
return {-1, fromNetworkError(networkError)};
}
else {
return {balance, SomeError::NoError};
}
}
C++17 std::variant
SomeErrorをNetworkError/DatabaseErrorのC++17で導入されるvariantとして定義する方法です。和集合と比べて、対応する値の定義や変換処理は不要になります。
std::error_codeを使用した方法と比較すると、SomeErrorの型を事前に決定しておかなければいけません。
例えば、getUserBalanceが他ドメイン（ファイルシステム）のエラーを追加で扱わなければいけないとき、
SomeErrorの定義をstd::variant<NoError, NetworkError, DatabaseError, FileSystemError>に変更しなければいけません。std::error_codeでは、型情報は消去されているので、そのような修正入りません。
#include <string>
#include <experimental/string_view>
#include <variant>
enum class NetworkError{
NoError,
SomeNetworkError
};
enum class DatabaseError{
NoError,
SomeDatabaseError
};
struct NoError{};
using SomeError = std::variant<NoError, NetworkError, DatabaseError>;
std::pair<std::string, DatabaseError>
getAccountIdFromDatabase(std::string_view userId){
return {"", DatabaseError::SomeDatabaseError};
}
std::pair<int, NetworkError>
getAccountBalanceFromNetwork(std::string_view accountId){
return {-1, NetworkError::SomeNetworkError};
}
std::pair<int, SomeError>
getUserBalance(std::string_view userId){
if(auto [accountId, databaseError] = getAccountIdFromDatabase(userId);
databaseError == DatabaseError::SomeDatabaseError){
return {-1, databaseError};
}
else if(auto [balance, networkError] = getAccountBalanceFromNetwork(accountId);
networkError == NetworkError::SomeNetworkError) {
return {-1, networkError};
}
else {
return {balance, NoError{}};
}
}
