Scl test cclass: Difference between revisions

From STRIDE Wiki
Jump to navigation Jump to search
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
= The scl_test_cclass pragma =
= The scl_test_cclass pragma =


The scl_test_cclass pragma is one of the [[SCL_Pragmas#Test_Units|Test Unit]] pragmas. The scl_test_cclass pragma declares a "C" language struct (class) to be captured as a test unit. Once captured, STRIDE will generate the appropriate code for executing test methods defined for this "C" Class. It is up to the user to specify actual test method code to be executed.
The ''scl_test_cclass'' pragma is one of the [[SCL_Pragmas#Test_Units|Test Unit]] pragmas. It declares a "C" language struct (class) to be captured as a test unit. Once captured, STRIDE will generate the appropriate code for executing test methods defined for this "C" Class. It is up to the user to specify actual test method code to be executed.


== Syntax ==
== Syntax ==
Line 13: Line 13:
|-
|-
| ''cclass-name''
| ''cclass-name''
| Object
| Identifier
| The name of the cclass test. This is a struct name in C. It is a struct or class name in C++.
| The name of the test unit. This is must be the name of an existing struct in C/C++ or a class in C++.
|-
|-
| ''init-function-name''
| ''init-function-name''
Line 26: Line 26:


== Notes ==
== Notes ==
* This pragma:
** requires the inclusion of srtest.h prior to its declaration.
** requires STRIDE version 2.1 or later.
** requires that the host PC have a recent ActiveState Perl distribution installed.
* The cclass-name identified:
* The cclass-name identified:
** may not appear as a specifier of a prior pragma.
** may not appear as a specifier of a prior pragma.
Line 45: Line 41:
** must not have been used in any prior or subsequent SCL pragma.
** must not have been used in any prior or subsequent SCL pragma.
** must have its first parameter declared as a pointer to the identified cclass.
** must have its first parameter declared as a pointer to the identified cclass.
** optionally if desired it may have additional parameters (they must all be of [http://en.wikipedia.org/wiki/Null-terminated_string C-string] and numeric types). For which concrete values could be specified when [[Stride_Runner#Input|running]] the test unit.


* The deinit-function-name:
* The deinit-function-name:
Line 51: Line 48:
** must not have been used in any prior or subsequent SCL pragma.
** must not have been used in any prior or subsequent SCL pragma.
** must have its first parameter declared as a pointer to the identified class.
** must have its first parameter declared as a pointer to the identified class.
* Optionally if desired a set of [[scl_test_setup|setup]]/[[scl_test_teardown|teardown]] fixtures could be applied.


== Examples ==
== Examples ==

Latest revision as of 07:14, 30 November 2014

The scl_test_cclass pragma

The scl_test_cclass pragma is one of the Test Unit pragmas. It declares a "C" language struct (class) to be captured as a test unit. Once captured, STRIDE will generate the appropriate code for executing test methods defined for this "C" Class. It is up to the user to specify actual test method code to be executed.

Syntax

#pragma scl_test_cclass(cclass-name, init-function-name { , deinit-function-name })
Parameters Type Description
cclass-name Identifier The name of the test unit. This is must be the name of an existing struct in C/C++ or a class in C++.
init-function-name Identifier The initialization function name. This is synonymous with a class constructor. There must be a prior user-declared function with this name. The first parameter must be a pointer to cclass-name. Additional parameters are left up to the user's implementation.
deinit-function-name (optional) Identifier The deinitialization function name. This is synonymous with a class destructor. If declared, there must be a user-declared function with this name. The first parameter must be a pointer to cclass-name. Additional parameters are left up to the user's implementation.

Notes

  • The cclass-name identified:
    • may not appear as a specifier of a prior pragma.
    • must be a struct in C.
    • must be either a struct or class in C++.
    • must be POD type.
    • must not be a template class.
    • must not be a nested class.
    • must contain at least one member function pointer with a prototype that:
      • returns integral type: void, int, or bool (bool accepted only for C++).
      • has a first parameter that is a pointer to cclass-name.
  • The init-function-name identified:
    • must be declared prior to this pragma's declaration.
    • must not have been used in any prior or subsequent SCL pragma.
    • must have its first parameter declared as a pointer to the identified cclass.
    • optionally if desired it may have additional parameters (they must all be of C-string and numeric types). For which concrete values could be specified when running the test unit.
  • The deinit-function-name:
    • is optional.
    • must be declared prior to this pragma's declaration if it appears in pragma.
    • must not have been used in any prior or subsequent SCL pragma.
    • must have its first parameter declared as a pointer to the identified class.
  • Optionally if desired a set of setup/teardown fixtures could be applied.

Examples

#include <srtest.h>

typedef struct CClass_Basic_Simple {
  int   (*pf_TestMethod)(struct CClass_Basic_Simple* pcc);
} CClass_Basic_Simple;

#ifdef __cplusplus
extern "C" {
#endif
void CClass_Basic_Simple_init(struct CClass_Basic_Simple* pcc);
#ifdef __cplusplus
}
#endif

#ifdef _SCL
#pragma scl_test_cclass(CClass_Basic_Simple, CClass_Basic_Simple_init)
#endif

See Also

Retrieved from "https://www.stridewiki.com/index.php?title=Scl_test_cclass&oldid=14192"