Create a new TestCase, named test_name.
This API is fairly low level, and calling add or add_func is preferable.
When this test is executed, a fixture structure of size data_size will be automatically allocated and filled with zeros.
Then data_setup is called to initialize the fixture. After fixture setup, the actual test function data_test is
called. Once the test run completes, the fixture structure is torn down by calling data_teardown and after that the memory is
automatically released by the test framework.
Splitting up a test run into fixture setup, test function and fixture teardown is most useful if the same fixture type is used for
multiple tests. In this cases, TestCase will be called with the same type of fixture (the
data_size argument), but varying test_name and data_test arguments.
| test_name |
the name for the test case |
| data_setup |
the function to set up the fixture data |
| data_teardown |
the function to teardown the fixture data |
| data_size |
the size of the fixture data structure |
| data_test |
the actual test function |
| test_data |
test data argument for the test functions |
|
a newly allocated TestCase. |