isUnique

Mit $isUnique kann geprüft werden, ob ein Wert genau einmal (oder keinmal) in einer Liste enthalten ist.
Über einen optionalen, dritten Parameter, kann gesteuert werden, was im Falle von "keinmal" zurückgegeben werden soll, da dies ein undefinierter Fall ist.

Tooltip
Syntax: $isUnique(source,valueToCheck[,notContainedResult=$true[,propertyPath]])
Parameter
Beschreibung
source
Die Liste oder das Array von Werten
valueToCheck
Der Wert, welcher nur einmal in der Quelle vorkommen darf
notContainedResult
Optional (Standardwert = $true) - Gibt an, welcher Wert bei keinem Vorkommen aufgelöst werden soll
propertyPath
Optionaler Feldpfad relativ zu einem Listeneintrag, um auf die Inhalte eines Eintragfeldes prüfen zu können
Gibt true zurück der Wert nur einmal in der Liste vorkommt, bzw. je nach Parameter 3 wenn er nicht in der Liste vorkommt

Syntax

$isUnique(source,valueToCheck[,notContainedResult=$ture[,propertyPath]])

Parameter

Name	Beschreibung
source	Die Liste oder das Array von Werten
valueToCheck	Der Wert, welcher nur einmal in der Quelle vorkommen darf
notContainedResult	Optional (Standardwert = $true) - Gibt an, welcher Wert bei keinem Vorkommen aufgelöst werden soll. Die Rückgabe kann hier gesteuert werden, da der Fall des Nichtvorhandenseins des Wertes (als Antwort auf die Frage "is unique?") nicht definiert ist.
propertyPath	Optionaler Feldpfad relativ zu einem Listeneintrag, um auf die Inhalte eines Eintragfeldes prüfen zu können

Rückgabewert

$true falls der Wert nur einmal in der Liste vorkommt, bzw. je nach Parameter 3 wenn er nicht in der Liste vorkommt

Beispiel

Syntax	Eingabewert	Ergebnis
$isUnique($input,a)	["a", "b", "c", "b"]	$true
$isUnique($input,b)	["a", "b", "c", "b"]	$false
$isUnique($input,d)	["a", "b", "c", "b"]	$true
$isUnique($input,d,$false)	["a", "b", "c", "b"]	$false
$isUnique($input,a,value)	[{"value": "a"}, {"value": "b"}]	$true

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