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

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.

Parameter

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