mockpp::ExpectationList< T > Class Template Reference
[Basic Mock Objects]

A class to verify lists of expectations, one after the other as they occur. More...

Inheritance diagram for mockpp::ExpectationList< T >:
Inheritance graph
[legend]

List of all members.

Public Member Functions

 ExpectationList (const String &name, VerifiableList *parent=0)
 Constructs the expectation.
virtual void verify ()
 Verify that the expected values equal the expected ones.
void addActual (const T &actualItem)
 Adds another actual value to the list.
template<class I >
void addActual (I items, I end)
 Adds a sequence of actual values to the list.
ExpectationListaddExpected (const T &expectedItem)
 Adds another expectation value to the list.
void balanceActual ()
 Copy one item from expectation list to actuals at same position.
template<class I >
ExpectationListaddExpected (I items, I end)
 Adds a sequence of expectation values to the list.
virtual void clearActual ()
 Resets the internal state to reflect that there is no actual value set.
virtual void reset ()
 Resets the internal state completely.
unsigned size () const
 Returns the amount of expectation values.
virtual void setExpectNothing ()
 Tell the object to expect nothing to happen to it, perhaps because the test is exercising the handling of an error.

Protected Member Functions

virtual void clearExpectation ()
 Clears the expectation list.
void checkImmediateValue (const T &actualItem) const
 Checks if the actual value matches the expectation.

Detailed Description

template<class T>
class mockpp::ExpectationList< T >

A class to verify lists of expectations, one after the other as they occur.

Definition at line 49 of file ExpectationList.h.


Constructor & Destructor Documentation

template<class T>
mockpp::ExpectationList< T >::ExpectationList ( const String name,
VerifiableList parent = 0 
) [inline]

Constructs the expectation.

Parameters:
name human readable description about the expectation
parent parent verifiable

Definition at line 57 of file ExpectationList.h.


Member Function Documentation

template<class T>
template<class I >
void mockpp::ExpectationList< T >::addActual ( items,
end 
) [inline]

Adds a sequence of actual values to the list.

Parameters:
items start iterator
end terminating iterator (note: one element "behind" as always with STL)

Definition at line 115 of file ExpectationList.h.

template<class T>
void mockpp::ExpectationList< T >::addActual ( const T &  actualItem  )  [inline]

Adds another actual value to the list.

Parameters:
actualItem new value

Definition at line 100 of file ExpectationList.h.

template<class T>
template<class I >
ExpectationList& mockpp::ExpectationList< T >::addExpected ( items,
end 
) [inline]

Adds a sequence of expectation values to the list.

Parameters:
items start iterator
end terminating iterator (note: one element "behind" as always with STL)
Returns:
reference to itself for chaining

Definition at line 154 of file ExpectationList.h.

template<class T>
ExpectationList& mockpp::ExpectationList< T >::addExpected ( const T &  expectedItem  )  [inline]

Adds another expectation value to the list.

Parameters:
expectedItem new value
Returns:
reference to itself for chaining

Definition at line 126 of file ExpectationList.h.

template<class T>
void mockpp::ExpectationList< T >::balanceActual (  )  [inline]

Copy one item from expectation list to actuals at same position.

Useful after recovering from an error at another place.

Definition at line 138 of file ExpectationList.h.

template<class T>
void mockpp::ExpectationList< T >::checkImmediateValue ( const T &  actualItem  )  const [inline, protected, virtual]

Checks if the actual value matches the expectation.

Note: in a list there can be any number of elements of a given value and the order of the elements must match exactly. If it fails, an AssertionFailedError is thrown

Implements mockpp::AbstractExpectationCollection< T >.

Definition at line 227 of file ExpectationList.h.

template<class T>
virtual void mockpp::ExpectationList< T >::setExpectNothing (  )  [inline, virtual]

Tell the object to expect nothing to happen to it, perhaps because the test is exercising the handling of an error.

The Expectation will fail if any actual values are set.

Note that this is not the same as not setting any expectations, in which case verify() will do nothing.

Implements mockpp::Expectation.

Definition at line 201 of file ExpectationList.h.

template<class T>
unsigned mockpp::ExpectationList< T >::size (  )  const [inline]

Returns the amount of expectation values.

Returns:
number of expectation values

Definition at line 188 of file ExpectationList.h.

template<class T>
virtual void mockpp::ExpectationList< T >::verify (  )  [inline, virtual]

Verify that the expected values equal the expected ones.

Note: in a list there can be any number of elements of a given value and the order of the elements must match exactly. If it fails, an AssertionFailedError is thrown

Implements mockpp::AbstractExpectation< T >.

Definition at line 71 of file ExpectationList.h.


The documentation for this class was generated from the following file:
 All Classes Namespaces Files Functions Variables Typedefs Friends Defines

Generated on Tue Jan 5 09:48:58 2010 for mockpp by  doxygen 1.6.1