Skip to main content

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.

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

Parameters​

NameTypeCommentKind
iteratorCNM_CollectionInterfaces.IIteratorThe new created iterator or null if allocation failsoutput

Code​

Declaration​

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