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.

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.

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

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