Boost C++ Libraries of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards


Class test_case



// In header: <boost/test/tree/test_unit.hpp>

class test_case : public boost::unit_test::test_unit {
  // types
  typedef std::vector< test_unit_id >                                  id_list;       
  typedef std::vector< test_unit_fixture_ptr >                         fixture_list_t;
  typedef std::vector< decorator::base_ptr >                           decor_list_t;  
  typedef boost::function< test_tools::assertion_result(test_unit_id)> precondition_t;

  enum @1 { type = = TUT_CASE };

  enum @0 { type = = TUT_ANY };


  // construct/copy/destruct
  test_case(const_string, boost::function< void()> const &);
  test_case(const_string, const_string, std::size_t, 
            boost::function< void()> const &);

  // public member functions
  typedef BOOST_READONLY_PROPERTY(boost::function< void()>, (test_case));
  typedef BOOST_READONLY_PROPERTY(test_unit_id, (framework::state));
  typedef BOOST_READONLY_PROPERTY(test_unit_id, (test_suite));
  typedef BOOST_READONLY_PROPERTY(id_list, (test_unit));
  typedef BOOST_READONLY_PROPERTY(std::vector< std::string >, (test_unit));
  typedef BOOST_READONLY_PROPERTY(std::vector< precondition_t >, (test_unit));
  void depends_on(test_unit *);
  void add_precondition(precondition_t const &);
  test_tools::assertion_result check_preconditions() const;
  void add_label(const_string);
  bool has_label(const_string) const;
  void increase_exp_fail(counter_t);
  bool is_enabled() const;
  std::string full_name() const;

  // public data members
  test_func p_test_func;
  test_unit_type const p_type;  // type for this test unit 
  const_string const p_type_name;  // "case"/"suite"/"module" 
  const_string const p_file_name;
  std::size_t const p_line_num;
  id_t p_id;  // unique id for this test unit 
  parent_id_t p_parent_id;  // parent test suite id 
  label_list_t p_labels;  // list of labels associated with this test unit 
  id_list_t p_dependencies;  // list of test units this one depends on 
  precond_list_t p_preconditions;  // user supplied preconditions for this test unit; 
  readwrite_property< std::string > p_name;  // name for this test unit 
  readwrite_property< std::string > p_description;  // description for this test unit 
  readwrite_property< unsigned > p_timeout;  // timeout for the test unit execution in seconds 
  readwrite_property< counter_t > p_expected_failures;  // number of expected failures in this test unit 
  readwrite_property< run_status > p_default_status;  // run status obtained by this unit during setup phase 
  readwrite_property< run_status > p_run_status;  // run status assigned to this unit before execution phase after applying all filters 
  readwrite_property< counter_t > p_sibling_rank;  // rank of this test unit amoung siblings of the same parent 
  readwrite_property< decor_list_t > p_decorators;  // automatically assigned decorators; execution is delayed till framework::finalize_setup_phase function 
  readwrite_property< fixture_list_t > p_fixtures;  // fixtures associated with this test unit 


test_case public construct/copy/destruct

  1. test_case(const_string tc_name, boost::function< void()> const & test_func);
  2. test_case(const_string tc_name, const_string tc_file, std::size_t tc_line, 
              boost::function< void()> const & test_func);
  3. ~test_case();

test_case public member functions

  1. typedef BOOST_READONLY_PROPERTY(boost::function< void()>, (test_case));
  2. typedef BOOST_READONLY_PROPERTY(test_unit_id, (framework::state));
  3. typedef BOOST_READONLY_PROPERTY(test_unit_id, (test_suite));
  4. typedef BOOST_READONLY_PROPERTY(id_list, (test_unit));
  5. typedef BOOST_READONLY_PROPERTY(std::vector< std::string >, (test_unit));
  6. typedef BOOST_READONLY_PROPERTY(std::vector< precondition_t >, (test_unit));
  7. void depends_on(test_unit * tu);
  8. void add_precondition(precondition_t const &);
  9. test_tools::assertion_result check_preconditions() const;
  10. void add_label(const_string l);
  11. bool has_label(const_string l) const;
  12. void increase_exp_fail(counter_t num);
  13. bool is_enabled() const;
  14. std::string full_name() const;