createNewIterator

Short summary

This method returns a NEW Iterator instance which can iterate the collection. These iterators can be used parallel independend of each other on the same collection.

Attention: The returned Iterator was created using the __NEW operator and must be destructed to avoid memory leaks!

• Return type: CNM_ReturnTypes.SingleExecutionResult

Parameters

Name	Type	Comment	Kind
iterator	IIterator	The new created iterator or null if allocation fails	output

Code

Declaration

METHOD createNewIterator :CNM_ReturnTypes.SingleExecutionResult
VAR_OUTPUT
	(*The new created iterator or null if allocation fails *)
	iterator :IIterator;
END_VAR