replace value by range(a, name of file b, default value c[, comparetype d])
Gruppe |
Sucht in der Properties-Datei b nach dem Text a und ersetzt diesen durch den Wert in der Properties-Datei. Die Schlüssel in der Properties-Datei stellen hierbei zwei durch einen Schrägstrich getrennte Werte von/bis dar. Befindet sich ein Wert innerhalb (und einschließlich) der Grenzen, wird er durch den in der Datei festgelegten Wert ersetzt. Konnte keine Ersetzung anhand der Werte in der Datei vorgenommen werden, wird der Defaultwert c zurückgegeben.
Der Art des Vergleichs von Schlüsselwert 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. |
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. |
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. Ebenso muss beachtet werden, dass Buchstaben im Vergleichsmodus numeric als der Wert 0 interpretiert werden und damit potenziell auf eine der Ersetzungsregeln zutreffen können.
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 |
withalpha.properties |
unknown |
lower alpha |
|
abcd |
withalpha.properties |
unknown |
lower alpha |
|
zzzz |
withalpha.properties |
unknown |
lower alpha |
|
ABCD |
withalpha.properties |
unknown |
upper alpha |
|
AbCd |
withalpha.properties |
unknown |
upper alpha |
|
10 |
withalpha.properties |
unknown |
below ten |
|
$ |
withalpha.properties |
unknown |
unknown |
|
abcd |
noalpha.properties |
unknown |
nocase |
alphas |
ABCD |
noalpha.properties |
unknown |
nocase |
alphas |
AbCd |
noalpha.properties |
unknown |
nocase |
alphas |
10 |
noalpha.properties |
unknown |
nocase |
below ten |
0 |
numbers.properties |
unknown |
numeric |
below ten |
9 |
numbers.properties |
unknown |
numeric |
below ten |
10 |
numbers.properties |
unknown |
numeric |
unknown |