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