F_VN_CopyContainerElementsConditional_ITcVnForwardIterator
Copys container elements to a new container, depending on a custom condition.
Syntax
Definition:
FUNCTION F_VN_CopyContainerElementsConditional_ITcVnForwardIterator : HRESULT
VAR_INPUT
ipSrcContainer : ITcVnContainer;
ipDestContainer : Reference To ITcVnContainer;
ipConditionFB : ITcVnCustomElementCondition_ITcVnForwardIterator;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcContainer |
Source container | |
|
ipDestContainer |
Reference To ITcVnContainer |
Returns a container with elements, that match the condition |
|
ipConditionFB |
Custom condition | |
|
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_CopyContainerElementsConditional_ITcVnForwardIterator filtert Elemente von mehrdimensionalen Containern. Die Filter-Bedingung ist durch einen Funktionsblock mit dem Interface ITcVnCustomElementCondition_ITcVnForwardIterator anzugeben.
Im Gegensatz zu F_VN_CopyContainerElementsConditional_ITcVnContainer werden nicht die Sub-Container an die Bedingungsmethode Condition übergeben, sondern Iteratoren, die jeweils auf das erste Element des Sub-Containers zeigen.
Parameter
Eingangscontainer
Der Eingangscontainer ipSrcContainer muss ein mehrdimensionaler Container sein; d. h. der Container muss als Elemente Sub-Container enthalten. Somit kommen alle Container vom Typ ContainerType_Vector_Vector_<…> in Frage.
Ergebniscontainer
Der Ergebniscontainer ipDestContainer enthält alle Sub-Container, die die Bedingung in ipConditionFB erfüllen.
Filter-Bedingung
Die Filter-Bedingung muss als Methode Condition eines Funktionsblocks definiert werden. Damit dieser Funktionsblock als Parameter ipConditionFB an die Funktion übergeben werden kann, muss er das Interface ITcVnCustomElementCondition_ITcVnForwardIterator implementieren.
Beispiele
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 |