Gruppe	Basic Functions

Diese Funktion liest vom lokalen Dateisystem eine Properties-Datei und fügt die Properties als Schlüssel-Wert-Paare in eine Map c ein. Die Map wird vorher nicht geleert. Wenn bisher keine Map mit diesem Namen existierte, wird sie erzeugt.

Parameter a muss den absoluten oder relativen Pfad zur Properties-Datei enthalten. Falls die Datei nicht existiert, erfolgt ein Fehlerabbruch.

Per Definition hat eine Properties-Datei das Zeichen-Encoding ISO-8859-1. Mit dem optionalen Parameter b kann aber auch ein abweichendes Encoding angegeben werden.

Der Rückgabewert der Funktion ist die Anzahl der Schlüssel-Wert-Paare, die nach dem Einfügen der Properties in der Map sind.

Parameter

Parameter	Beschreibung
a	Dateiname.
b	(optional) Encoding. Default: 8859_1
c	Name der Map.

Beispiele

Angenommen, die Map mit dem Namen myMap war vor Ausführung der Funktion leer oder nicht vorhanden und die Datei ./conf/xyz.properties ist eine Properties-Datei im Encoding 8859_1 mit drei Properties mit verschiedenen Schlüsseln.

Parameter a	Parameter b	Parameter c	Ergebnis
./conf/xyz.properties		myMap	3

Das eigentliche Ergebnis der Funktionsausführung ist es, dass nun eine Map mit dem Namen myMap existiert, die drei Schlüssel-Wert-Paare enthält.