replace value by range(a, name of file b, default value c[, comparetype d])


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.

withalpha.properties
aaaa/zzzz=lower alpha
AAAA/ZZZZ=upper alpha
0/9=below ten

noalpha.properties
AAAA/ZZZZ=alphas
0/9=below ten

numbers.properties
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