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 valueWeiterführende Informationen
Die Funktion F_VN_IncrementIterator inkrementiert einen Iterator um ein Element. Wenn Sie den Iterator stattdessen dekrementieren oder um mehrere Positionen inkrementieren möchten, nutzen Sie die Funktion F_VN_AdvanceIterator.
Parameter
Iterator
Der Parameter ipIterator ist vom Typ ITcVnForwardIterator. Da ITcVnBidirectionalIterator und ITcVnRandomAccessIterator davon erben, können diese ebenfalls an die Funktion übergeben werden. Falls ein Vorwärts-Iterator dekrementiert werden soll, wird intern versucht, diesen in einen bidirektionalen Iterator umzuwandeln und diesen zu dekrementieren.
Verwandte Funktionen
Required License
TC3 Vision Base
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1. 4024.44 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |