replace value by range(a, name of file b, default value c[, comparetype d])
Gruppe |
Sucht in der Properties-Datei b nach dem Schlüssel a und gibt dessen Wert zurück.
Die Schlüssel in der Properties-Datei stellen hierbei zwei durch einen Schrägstrich getrennte Werte von/bis dar. Befindet sich ein Such-Schlüssel innerhalb (und einschließlich) der Grenzen, gilt die Suche als erfolgreich. Wird nichts gefunden, wird der Defaultwert c zurückgegeben.
Die Art des Vergleichs von Suchschlüssel und den Bereichswerten legt Parameter d fest. Folgende Werte sind hierbei möglich.
Vergleichsart |
Bedeutung |
withcase |
Der Vergleich erfolgt lexikalisch mit Beachtung von Groß- und Kleinschreibung. a ist damit größer als A (Unicode-Wert). |
nocase |
Der Vergleich erfolgt lexikalisch. Groß- und Kleinschreibung wird nicht beachtet, a ist damit gleich A. |
numeric |
Der Vergleich erfolgt numerisch, d. h. Buchstaben werden nicht unterstützt. 10 ist damit größer als 2. Hinweis: Nicht-numerische Werte werden als 0 interpretiert. |
Wichtiger Hinweis: Die Reihenfolge, mit der die Vergleiche durchgeführt werden, ist zufällig, d. h. die Bereiche sollten disjunkt sein, d. h. es sollten keine Überschneidungen existieren.
Parameterbeschreibung
Parameter |
Beschreibung |
a |
Schlüssel, nach dem in b gesucht werden soll. |
b |
Name der Properties-Datei. |
c |
Rückgabewert, wenn der Schlüssel nicht gefunden wurde. |
d |
(optional) Art des Bereichsvergleichs. Default: withcase. |
Beispiele
Hinweis: Bitte beachten Sie generell, gerade im Hinblick auf Maskierungszeichen, den Aufbau einer Properties-Datei.
Gegeben seien folgende Properties-Dateien.
aaaa/zzzz=lower alpha
AAAA/ZZZZ=upper alpha
0/9=below ten
AAAA/ZZZZ=alphas
0/9=below ten
0/9=below ten
Parameter a |
Parameter b |
Parameter c |
Parameter d |
Ergebnis |
aaaa |
./conf/withalpha.properties |
unknown |
|
lower alpha |
abcd |
./conf/withalpha.properties |
unknown |
|
lower alpha |
zzzz |
./conf/withalpha.properties |
unknown |
|
lower alpha |
ABCD |
./conf/withalpha.properties |
unknown |
|
upper alpha |
AbCd |
./conf/withalpha.properties |
unknown |
|
upper alpha |
10 |
./conf/withalpha.properties |
unknown |
|
below ten |
$ |
./conf/withalpha.properties |
unknown |
|
unknown |
abcd |
./conf/noalpha.properties |
unknown |
nocase |
alphas |
ABCD |
./conf/noalpha.properties |
unknown |
nocase |
alphas |
AbCd |
./conf/noalpha.properties |
unknown |
nocase |
alphas |
10 |
./conf/noalpha.properties |
unknown |
nocase |
below ten |
0 |
./conf/numbers.properties |
unknown |
numeric |
below ten |
9 |
./conf/numbers.properties |
unknown |
numeric |
below ten |
10 |
./conf/numbers.properties |
unknown |
numeric |
unknown |