403 lines
13 KiB
C++
403 lines
13 KiB
C++
// error_code_user_test.cpp ------------------------------------------------//
|
|
|
|
// Copyright Beman Dawes 2006
|
|
|
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
|
|
// See library home page at http://www.boost.org/libs/system
|
|
|
|
// ------------------------------------------------------------------------ //
|
|
|
|
// This program demonstrates creation and use of new categories of error
|
|
// codes. Several scenarios are demonstrated and tested.
|
|
|
|
// Motivation was a Boost posting by Christopher Kohlhoff on June 28, 2006.
|
|
|
|
#include <boost/system/error_code.hpp>
|
|
#include <boost/cerrno.hpp>
|
|
#include <string>
|
|
#include <cstdio>
|
|
#include <boost/detail/lightweight_test.hpp>
|
|
|
|
#ifdef BOOST_POSIX_API
|
|
# include <sys/stat.h>
|
|
#else
|
|
# include <windows.h>
|
|
#endif
|
|
|
|
// ------------------------------------------------------------------------ //
|
|
|
|
// Library 1: User function passes through an error code from the
|
|
// operating system.
|
|
|
|
|
|
boost::system::error_code my_mkdir( const std::string & path )
|
|
{
|
|
return boost::system::error_code(
|
|
# ifdef BOOST_POSIX_API
|
|
::mkdir( path.c_str(), S_IRWXU|S_IRWXG|S_IROTH|S_IXOTH ) == 0 ? 0 : errno,
|
|
# else
|
|
::CreateDirectoryA( path.c_str(), 0 ) != 0 ? 0 : ::GetLastError(),
|
|
# endif
|
|
boost::system::system_category() );
|
|
}
|
|
|
|
// ------------------------------------------------------------------------ //
|
|
|
|
// Library 2: User function passes through errno from the C-runtime.
|
|
|
|
#include <cstdio>
|
|
|
|
boost::system::error_code my_remove( const std::string & path )
|
|
{
|
|
return boost::system::error_code(
|
|
std::remove( path.c_str() ) == 0 ? 0 : errno,
|
|
boost::system::generic_category() ); // OK for both Windows and POSIX
|
|
// Alternatively, could use generic_category()
|
|
// on Windows and system_category() on
|
|
// POSIX-based systems.
|
|
}
|
|
|
|
// ------------------------------------------------------------------------ //
|
|
|
|
// Library 3: Library uses enum to identify library specific errors.
|
|
|
|
// This particular example is for a library within the parent namespace. For
|
|
// an example of a library not within the parent namespace, see library 4.
|
|
|
|
// header lib3.hpp:
|
|
|
|
namespace boost
|
|
{
|
|
namespace lib3
|
|
{
|
|
// lib3 has its own error_category:
|
|
const boost::system::error_category & get_lib3_error_category() BOOST_SYSTEM_NOEXCEPT;
|
|
const boost::system::error_category & lib3_error_category = get_lib3_error_category();
|
|
|
|
enum error
|
|
{
|
|
boo_boo=123,
|
|
big_boo_boo
|
|
};
|
|
}
|
|
|
|
namespace system
|
|
{
|
|
template<> struct is_error_code_enum<boost::lib3::error>
|
|
{ static const bool value = true; };
|
|
}
|
|
|
|
namespace lib3
|
|
{
|
|
inline boost::system::error_code make_error_code(error e)
|
|
{ return boost::system::error_code(e,lib3_error_category); }
|
|
}
|
|
|
|
}
|
|
|
|
// implementation file lib3.cpp:
|
|
|
|
// #include <lib3.hpp>
|
|
|
|
namespace boost
|
|
{
|
|
namespace lib3
|
|
{
|
|
class lib3_error_category_imp : public boost::system::error_category
|
|
{
|
|
public:
|
|
lib3_error_category_imp() : boost::system::error_category() { }
|
|
|
|
const char * name() const BOOST_SYSTEM_NOEXCEPT
|
|
{
|
|
return "lib3";
|
|
}
|
|
|
|
boost::system::error_condition default_error_condition( int ev ) const BOOST_SYSTEM_NOEXCEPT
|
|
{
|
|
return ev == boo_boo
|
|
? boost::system::error_condition( boost::system::errc::io_error,
|
|
boost::system::generic_category() )
|
|
: boost::system::error_condition( ev,
|
|
boost::lib3::lib3_error_category );
|
|
}
|
|
|
|
std::string message( int ev ) const
|
|
{
|
|
if ( ev == boo_boo ) return std::string("boo boo");
|
|
if ( ev == big_boo_boo ) return std::string("big boo boo");
|
|
return std::string("unknown error");
|
|
}
|
|
|
|
};
|
|
|
|
const boost::system::error_category & get_lib3_error_category() BOOST_SYSTEM_NOEXCEPT
|
|
{
|
|
static const lib3_error_category_imp l3ecat;
|
|
return l3ecat;
|
|
}
|
|
}
|
|
}
|
|
|
|
// ------------------------------------------------------------------------ //
|
|
|
|
// Library 4: Library uses const error_code's to identify library specific
|
|
// errors.
|
|
|
|
// This particular example is for a library not within the parent namespace.
|
|
// For an example of a library within the parent namespace, see library 3.
|
|
|
|
// header lib4.hpp:
|
|
|
|
namespace lib4
|
|
{
|
|
// lib4 has its own error_category:
|
|
const boost::system::error_category & get_lib4_error_category() BOOST_SYSTEM_NOEXCEPT;
|
|
const boost::system::error_category & lib4_error_category = get_lib4_error_category();
|
|
|
|
extern const boost::system::error_code boo_boo;
|
|
extern const boost::system::error_code big_boo_boo;
|
|
}
|
|
|
|
// implementation file lib4.cpp:
|
|
|
|
// #include <lib4.hpp>
|
|
|
|
namespace lib4
|
|
{
|
|
class lib4_error_category_imp : public boost::system::error_category
|
|
{
|
|
public:
|
|
lib4_error_category_imp() : boost::system::error_category() { }
|
|
|
|
const char * name() const BOOST_SYSTEM_NOEXCEPT
|
|
{
|
|
return "lib4";
|
|
}
|
|
|
|
boost::system::error_condition default_error_condition( int ev ) const BOOST_SYSTEM_NOEXCEPT
|
|
{
|
|
return ev == boo_boo.value()
|
|
? boost::system::error_condition( boost::system::errc::io_error,
|
|
boost::system::generic_category() )
|
|
: boost::system::error_condition( ev, lib4::lib4_error_category );
|
|
}
|
|
|
|
std::string message( int ev ) const
|
|
{
|
|
if ( ev == boo_boo.value() ) return std::string("boo boo");
|
|
if ( ev == big_boo_boo.value() ) return std::string("big boo boo");
|
|
return std::string("unknown error");
|
|
}
|
|
};
|
|
|
|
const boost::system::error_category & get_lib4_error_category() BOOST_SYSTEM_NOEXCEPT
|
|
{
|
|
static const lib4_error_category_imp l4ecat;
|
|
return l4ecat;
|
|
}
|
|
|
|
const boost::system::error_code boo_boo( 456, lib4_error_category );
|
|
const boost::system::error_code big_boo_boo( 789, lib4_error_category );
|
|
|
|
}
|
|
|
|
// ------------------------------------------------------------------------ //
|
|
|
|
// Chris Kolhoff's Test3, modified to work with error_code.hpp
|
|
|
|
// Test3
|
|
// =====
|
|
// Define error classes to check for success, permission_denied and
|
|
// out_of_memory, but add additional mappings for a user-defined error category.
|
|
//
|
|
|
|
//namespace test3 {
|
|
|
|
// enum user_err
|
|
// {
|
|
// user_success = 0,
|
|
// user_permission_denied,
|
|
// user_out_of_memory
|
|
// };
|
|
//
|
|
// class user_error_category_imp : public boost::system::error_category
|
|
// {
|
|
// public:
|
|
// const std::string & name() const
|
|
// {
|
|
// static std::string s( "test3" );
|
|
// return s;
|
|
// }
|
|
//
|
|
// boost::system::error_code portable_error_code( int ev ) const
|
|
// {
|
|
// switch (ev)
|
|
// {
|
|
// case user_success:
|
|
// return boost::system::error_code(boost::system::errc::success, boost::system::generic_category());
|
|
// case user_permission_denied:
|
|
// return boost::system::error_code(boost::system::errc::permission_denied, boost::system::generic_category());
|
|
// case user_out_of_memory:
|
|
// return boost::system::error_code(boost::system::errc::not_enough_memory, boost::system::generic_category());
|
|
// default:
|
|
// break;
|
|
// }
|
|
// return boost::system::error_code(boost::system::errc::no_posix_equivalent, boost::system::generic_category());
|
|
// }
|
|
//
|
|
// };
|
|
//
|
|
// const user_error_category_imp user_error_category_const;
|
|
//
|
|
// const boost::system::error_category & user_error_category
|
|
// = user_error_category_const;
|
|
//
|
|
// template<> inline boost::system::error_code make_error_code(user_err e)
|
|
// {
|
|
// return boost::system::error_code(e, user_error_category);
|
|
// }
|
|
//
|
|
// // test code
|
|
//
|
|
// void check_success(const boost::system::error_code& ec, bool expect)
|
|
// {
|
|
// BOOST_TEST( (ec == boost::system::errc::success) == expect );
|
|
// if (ec == boost::system::errc::success)
|
|
// std::cout << "yes... " << (expect ? "ok" : "fail") << '\n';
|
|
// else
|
|
// std::cout << "no... " << (expect ? "fail" : "ok") << '\n';
|
|
// }
|
|
//
|
|
// void check_permission_denied(const boost::system::error_code& ec, bool expect)
|
|
// {
|
|
// BOOST_TEST( (ec == boost::system::errc::permission_denied) == expect );
|
|
// if (ec == boost::system::errc::permission_denied)
|
|
// std::cout << "yes... " << (expect ? "ok" : "fail") << '\n';
|
|
// else
|
|
// std::cout << "no... " << (expect ? "fail" : "ok") << '\n';
|
|
// }
|
|
//
|
|
// void check_out_of_memory(const boost::system::error_code& ec, bool expect)
|
|
// {
|
|
// BOOST_TEST( (ec == boost::system::errc::not_enough_memory) == expect );
|
|
// if (ec == boost::system::errc::not_enough_memory)
|
|
// std::cout << "yes... " << (expect ? "ok" : "fail") << '\n';
|
|
// else
|
|
// std::cout << "no... " << (expect ? "fail" : "ok") << '\n';
|
|
// }
|
|
//
|
|
// void run()
|
|
// {
|
|
// printf("Test3\n");
|
|
// printf("=====\n");
|
|
// boost::system::error_code ec;
|
|
// check_success(ec, true);
|
|
// check_success(boost::system::errc::success, true);
|
|
// check_success(boost::system::errc::permission_denied, false);
|
|
// check_success(boost::system::errc::not_enough_memory, false);
|
|
// check_success(user_success, true);
|
|
// check_success(user_permission_denied, false);
|
|
// check_success(user_out_of_memory, false);
|
|
// check_permission_denied(ec, false);
|
|
// check_permission_denied(boost::system::errc::success, false);
|
|
// check_permission_denied(boost::system::errc::permission_denied, true);
|
|
// check_permission_denied(boost::system::errc::not_enough_memory, false);
|
|
// check_permission_denied(user_success, false);
|
|
// check_permission_denied(user_permission_denied, true);
|
|
// check_permission_denied(user_out_of_memory, false);
|
|
// check_out_of_memory(ec, false);
|
|
// check_out_of_memory(boost::system::errc::success, false);
|
|
// check_out_of_memory(boost::system::errc::permission_denied, false);
|
|
// check_out_of_memory(boost::system::errc::not_enough_memory, true);
|
|
// check_out_of_memory(user_success, false);
|
|
// check_out_of_memory(user_permission_denied, false);
|
|
// check_out_of_memory(user_out_of_memory, true);
|
|
//
|
|
//# ifdef BOOST_WINDOWS_API
|
|
// check_success(boost::system::windows::success, true);
|
|
// check_success(boost::system::windows::access_denied, false);
|
|
// check_success(boost::system::windows::not_enough_memory, false);
|
|
// check_permission_denied(boost::system::windows::success, false);
|
|
// check_permission_denied(boost::system::windows::access_denied, true);
|
|
// check_permission_denied(boost::system::windows::not_enough_memory, false);
|
|
// check_out_of_memory(boost::system::windows::success, false);
|
|
// check_out_of_memory(boost::system::windows::access_denied, false);
|
|
// check_out_of_memory(boost::system::windows::not_enough_memory, true);
|
|
//# endif
|
|
//
|
|
// printf("\n");
|
|
// }
|
|
//
|
|
//} // namespace test3
|
|
|
|
|
|
|
|
// ------------------------------------------------------------------------ //
|
|
|
|
int main( int, char *[] )
|
|
{
|
|
boost::system::error_code ec;
|
|
|
|
// Library 1 tests:
|
|
|
|
ec = my_mkdir( "/no-such-file-or-directory/will-not-succeed" );
|
|
std::cout << "ec.value() is " << ec.value() << '\n';
|
|
|
|
BOOST_TEST( ec );
|
|
BOOST_TEST( ec == boost::system::errc::no_such_file_or_directory );
|
|
BOOST_TEST( ec.category() == boost::system::system_category() );
|
|
|
|
// Library 2 tests:
|
|
|
|
ec = my_remove( "/no-such-file-or-directory" );
|
|
std::cout << "ec.value() is " << ec.value() << '\n';
|
|
|
|
BOOST_TEST( ec );
|
|
BOOST_TEST( ec == boost::system::errc::no_such_file_or_directory );
|
|
BOOST_TEST( ec.category() == boost::system::generic_category() );
|
|
|
|
// Library 3 tests:
|
|
|
|
ec = boost::lib3::boo_boo;
|
|
std::cout << "ec.value() is " << ec.value() << '\n';
|
|
|
|
BOOST_TEST( ec );
|
|
BOOST_TEST( ec == boost::lib3::boo_boo );
|
|
BOOST_TEST( ec.value() == boost::lib3::boo_boo );
|
|
BOOST_TEST( ec.category() == boost::lib3::lib3_error_category );
|
|
|
|
BOOST_TEST( ec == boost::system::errc::io_error );
|
|
|
|
boost::system::error_code ec3( boost::lib3::boo_boo+100,
|
|
boost::lib3::lib3_error_category );
|
|
BOOST_TEST( ec3.category() == boost::lib3::lib3_error_category );
|
|
BOOST_TEST( ec3.default_error_condition().category()
|
|
== boost::lib3::lib3_error_category );
|
|
|
|
// Library 4 tests:
|
|
|
|
ec = lib4::boo_boo;
|
|
std::cout << "ec.value() is " << ec.value() << '\n';
|
|
|
|
BOOST_TEST( ec );
|
|
BOOST_TEST( ec == lib4::boo_boo );
|
|
BOOST_TEST( ec.value() == lib4::boo_boo.value() );
|
|
BOOST_TEST( ec.category() == lib4::lib4_error_category );
|
|
|
|
BOOST_TEST( ec == boost::system::errc::io_error );
|
|
|
|
boost::system::error_code ec4( lib4::boo_boo.value()+100,
|
|
lib4::lib4_error_category );
|
|
BOOST_TEST( ec4.default_error_condition().category()
|
|
== lib4::lib4_error_category );
|
|
|
|
// Test 3
|
|
|
|
//test3::run();
|
|
|
|
return ::boost::report_errors();
|
|
}
|