entity.indexOf()

Home

4D v19.8

entity.indexOf()


entity.indexOf() ( {entitySelection} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
entitySelection	EntitySelection	Position der Entity wird in Bezug auf ihre Entity-Selection angegeben
Funktionsergebnis	Lange Ganzzahl	Position der Entity in einer Entity-Selection

Beschreibung

Die Methode entity.indexOf() gibt die Position der Entity in einer Entity-Selection zurück.

Standardmäßig, d.h. ohne den Parameter entitySelection, gibt die Methode die Position der Entity in ihrer eigenen Entity-Selection zurück. Sonst gibt sie die Position der Entity innerhalb der in entitySelection angegebenen Entity-Selection zurück.

Der resultierende Wert liegt zwischen 0 und der Länge der Entity-Selection -1.

Hat die Entity keine Entity-Selection oder gehört sie nicht zu entitySelection, gibt die Methode -1 zurück
Ist entitySelection Null oder gehört nicht zur gleichen Dataclass wie die Entity, wird ein Fehler erzeugt

Beispiel

 C_OBJECT($employees;$employee)

 $employees:=ds.Employee.query("lastName = :1";"H@") //Diese Entity-Selection enthält 3 Entities

 $employee:=$employees[1] //Diese Entity gehört zu einer Entity-Selection

 ALERT("Der Index der Entity in ihrer eigenen Entity-Selection ist "+String($employee.indexOf())) //1

 

 C_OBJECT($employee)

 $employee:=ds.Employee.get(725) //Diese Entity gehört nicht zu einer Entity-Selection

 ALERT("Der Index der Entity ist "+String($employee.indexOf())) // -1

Siehe auch

entitySelection.contains()