entitySelection.minus()

Home

4D v19.8


entitySelection.minus() ( entity \| entitySelection ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
entity \| entitySelection	Entity, EntitySelection	Entity oder Entity-Selection zum Entnehmen
Funktionsergebnis	EntitySelection	Neue Entity-Selection oder neue Referenz auf die vorhandene Entity-Selection

Beschreibung

Die Methode entitySelection.minus() schließt die entity oder Entities von entitySelection aus der Entity-Selection aus, in der sie ausgeführt wird und gibt die resultierende Entity-Selection zurück.

Übergeben Sie entity als Parameter, erstellt die Methode eine neue Entity-Selection ohne entity (wenn entity zu dieser Entity-Selection gehört). Ist entity nicht in der ursprünglichen Entity-Selection enthalten, wird eine neue Referenz auf die Entity-Selection zurückgegeben.
Übergeben Sie entitySelection als Parameter, gibt die Methode eine Entity-Selection mit den Entities der ursprünglichen Entity-Selection ohne die in entitySelection enthaltenen Entities zurück.

Hinweis: Sie können sortierte bzw. unsortierte Entity-Selections vergleichen. Die resultierende Selection ist immer unsortiert. Weitere Informationen dazu finden Sie im Abschnitt Sortierte vs unsortierte Entity-Selections des 4D Developer Guide.

Ist die ursprüngliche Entity-Selection oder sind die ursprüngliche Entity-Selection und der Parameter entitySelection leer, wird eine leere Entity-Selection zurückgegeben.
Ist entitySelection leer oder ist entity Null, wird eine neue Referenz der ursprünglichen Entity-Selection zurückgegeben.

Sind die ursprüngliche Entity-Selection und die Parameter nicht mit der gleichen Dataclass verbunden, wird ein Fehler generiert.

Beispiel 1

 C_OBJECT($employees;$employee;$result)

 

 $employees:=ds.Employee.query("lastName = :1";"H@") // Die Entity-Selection $employees enthält die Entity mit Primärschlüssel 710 und anderen Entities

  // z.B. "Colin Hetrick", "Grady Harness", "Sherlock Holmes" (Primärschlüssel 710)

 

 $employee:=ds.Employee.get(710) // Gibt "Sherlock Holmes" zurück

 

 $result:=$employees.minus($employee) //$result enthält "Colin Hetrick", "Grady Harness"

Beispiel 2

Eine Selection der weiblichen Angestellen mit Namen "Jones" und Wohnsitz New York erhalten:

 C_OBJECT($sel1;$sel2;$sel3)

 $sel1:=ds.Employee.query("name =:1";"Jones")

 $sel2:=ds.Employee.query("city=:1";"New York")

 $sel3:=$sel1.and($sel2).minus(ds.Employee.query("gender='male'"))

Siehe auch

DIFFERENCE
entitySelection.add()