findFirst, findAll (Werte in Listen suchen)

Ermöglicht das Suchen eines oder mehrerer Werte in einer Liste oder Datenprovider.
 HINWEIS  Handelt es sich bei der Quelle um einen Datenprovider, so können nur die bereits geladenen Einträge durchsucht werden. Es werden keine Server seitigen Suchen ausgeführt!

Tooltip

Syntax:
$findFirst(source,boolExpression)
$findAll(source,boolExpression)

Parameter	Beschreibung
source	Die Liste oder der Datenprovider der durchsucht werden soll
boolExpression	Ein Ausdruck, welcher für jeden Eintrag in source gerufen wird. Das Eingabeobjekt ($input) ist dabei der jeweilige Eintrag. Der Ausdruck muss einen bool'schen Wert zurückliefern, welcher darüber entscheidet, ob der Eintrag in das Suchergebnis passt (true) oder nicht (false)

Im Falle von $findFirst wird der Eintrag zurückgeliefert, der als erster der Sucheinschränkung entsprach.
Im Falle von $findAll wird eine Liste mit allen Einträgen zurückgeliefert, welche der Sucheinschränkung entsprochen haben.

Beispiel: $findFirst($input,$cmp({key},=,5)) - Liefert den ersten Eintrag dessen Feld "key" den Wert 5 besitzt

Siehe auch contains (prüfen ob Wert in Liste enthalten ist)

Syntax

$findFirst(source,boolExpression)

$findAll(source,boolExpression)

Parameter

Rückgabewert

Im Falle von $findFirst wird der Eintrag zurückgeliefert, der als erster der Sucheinschränkung entsprach.
Im Falle von $findAll wird eine Liste mit allen Einträgen zurückgeliefert, welche der Sucheinschränkung entsprochen haben.

Beispiele:

Für die Beispiele wird angenommen, dass es sich bei $input um eine Liste mit Tupeln folgenden Formats handelt:

JSON

[
	{
		"key": "1",
		"label": "Item 1",
		"value": 220
	},
	{
		"key": "2",
		"label": "Item 2",
		"value": 95
	},
	{
		"key": "3",
		"label": "Item 3",
		"value": 100
	},
	{
		"key": "4",
		"label": "Item 4",
		"value": 10
	},
	{
		"key": "5",
		"label": "Item 5",
		"value": 5
	}
]