![](../../Home/Icons/Home.gif)
![](../icons/UpCNM.gif)
![](../icons/CNMContext.gif)
![](../../Home/Icons/Search.gif)
Taxonomy Categories:
Member Functions:
Interface Category:
Developer Tool Programmer Interface.
Inherits From:
TTestCollection
Inherited By:
None.
Purpose:
A derived class of TTestCollection that represents a test that contains a set of other TTest derived classes. Derive TTestSet if you have a group of related tests for which the order or execution does not matter.
Instantiation:
Allocate on the heap or the stack.
Deriving Classes:
This class is a framework class. To use it, derive it and override the SetupSubtests function to instantiate each of your subtests and use the AdoptTest function to add them to the set.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
- TTestSet ()
- TTestSet (const TTestSet &)
Interface Category:
Developer Tool Programmer Interface.
Purpose:
- Default constructor.
- Copy constructor.
Calling Context:
- Called by the stream-in operators and RunTest.
- Called to copy an object.
Parameters:
- Takes no parameters.
- const TTestSet & -The object to copy.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TTestSet::operator=
TTestSet & operator =(const TTestSet &)
Interface Category:
Developer Tool Programmer Interface.
Purpose:
Assignment operator.
Calling Context:
Called when an object is assigned to another compatible object.
Parameters:
- const TTestSet & -A const reference to the right-hand side object.
Return Value:
A non-const reference to the left-hand side object.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual ~ TTestSet ()
Interface Category:
Developer Tool Programmer Interface.
Purpose:
Destructor.
Calling Context:
Called to destroy an object.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TTestSet::operator<<=
virtual TStream & operator <<= (TStream & source)
Interface Category:
Developer Tool Programmer Interface.
Purpose:
Stream-in operator.
Calling Context:
Called to stream in data.
Parameters:
- TStream & source -The stream the object is streamed in from.
Return Value:
Returns a reference to the stream the object streams itself in from.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TTestSet::operator>>=
virtual TStream & operator >>=(TStream & destination) const
Interface Category:
Developer Tool Programmer Interface.
Purpose:
Stream-out operator.
Calling Context:
Called to stream out data.
Parameters:
- TStream & destination -The stream the object is streamed out to.
Return Value:
Returns a reference to the stream the object streams itself out to.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TTestSet::RandomlyReorder
virtual void RandomlyReorder (long initialSeed =0)
Interface Category:
Developer Tool Programmer Interface.
Purpose:
Randomly rearranges the order in which subtests are executed by the Test function.
Calling Context:
Call this function directly.
Parameters:
- long initialSeed =0 -The seed value used to generate the random order.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TTestSet::SetSubtestRunCount
virtual void SetSubtestRunCount (unsigned long)
Interface Category:
Developer Tool Programmer Interface.
Purpose:
Sets the number of subtests to run.
Calling Context:
Call this function directly.
Parameters:
- unsigned long -The number of subtests to run.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TTestSet::GetSubtestRunCount
virtual unsigned long GetSubtestRunCount () const
Interface Category:
Developer Tool Programmer Interface.
Purpose:
Gets the number of subtests to run.
Calling Context:
Called by the framework and directly.
Parameters:
Return Value:
Returns the number of subtests to run.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TTestSet::GetNewSubtests
virtual TCollectionOf < TTest > & GetNewSubtests () const
Interface Category:
Developer Tool Programmer Interface.
Purpose:
Returns the collection of subtests. Clients and derived classes should not call or override this function.
Calling Context:
Called by Test framework. Do not call this function directly.
Parameters:
Return Value:
Returns a collection of subtests.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.