F_VN_IncrementIterator
Increment the iterator. (Alternatively use interface method .Increment.)
Syntax
Definition:
FUNCTION F_VN_IncrementIterator : HRESULT
VAR_INPUT
ipIterator : ITcVnForwardIterator;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipIterator |
Iterator | |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueFurther information
The function F_VN_IncrementIterator increments an iterator by one element. If instead of that you wish to decrement the iterator or to increment it by several positions, use the function F_VN_AdvanceIterator.
Parameter
Iterator
The parameter ipIterator is of the type ITcVnForwardIterator. Since ITcVnBidirectionalIterator and ITcVnRandomAccessIterator inherit from it, these can also be transferred to the function. If a forward iterator is to be decremented, an internal attempt is made to transform it into a bidirectional iterator and to decrement it.
Related functions
Required License
TC3 Vision Base
System Requirements
|
Development environment |
Target platform |
PLC libraries to include |
|---|---|---|
|
TwinCAT V3.1.4024.59 or later |
PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU |
Tc3_Vision |