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.

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).