Mercurial > dive4elements > river
diff artifacts/doc/datacage_ref_de.rst @ 7415:f5948a07f317
Datacage ref doc: More docs for functions.
author | Sascha L. Teichmann <teichmann@intevation.de> |
---|---|
date | Tue, 22 Oct 2013 17:00:47 +0200 |
parents | 0e56d7b4b38c |
children | f26e7d386d8c |
line wrap: on
line diff
--- a/artifacts/doc/datacage_ref_de.rst Tue Oct 22 16:24:08 2013 +0200 +++ b/artifacts/doc/datacage_ref_de.rst Tue Oct 22 17:00:47 2013 +0200 @@ -682,6 +682,29 @@ ``dc:replace-all('KlausGabiPeter', '(Klaus|Peter)', '>$1<')`` resultiert demnach in ``>Klaus<Gabi>Peter<``. +``dc:find-all`` Extraktion von Strings aus einem String anhand eines regulären Ausdrucks +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +``dc:find-all(Nadel, Heuhaufen)`` extrahiert aus einem String Heuhaufen all jene Substrings, +die auf den regulären Ausdruck Nadel passen. Das Resultat dieser Funktion ist eine Liste +von Strings. Sie ist leer, wenn das Muster nicht gefunden wurde. + +``dc:find-all('\d{4}', '1900 1930 1941 1960')`` liefert dem entsprechend die Liste +``'1900'``, ``'1930'``, ``'1941'``, ``'1960'``. + +``dc:date-format`` Formatierte Ausgabe eines Datums +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +``dc:date-format(Format, Datum)`` leifert für ein Datum Datum einen String, der +nach den Formatierungsregeln aus Format formatiert wird. Für die Formatierungen +gelten die in SimpleFormat_ beschriebenen Regeln. + +.. _SimpleFormat: http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html + +``dc::date-format(''dd.MM.yyyy', $datum,)`` liefert für ein ``$datum`` mit dem Wert 1. Dezember 1941 +den String ``01.12.1941``. + + ``dc:group-key`` Wert des aktuellen Gruppierungsschlüssels ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -693,17 +716,19 @@ ``dc:dump-variables()`` liefert einen String mit der aktuellen Belegung aller Variablen. Dies ist zusammen mit ``dc:message`` nützlich, um eine Ablaufverfolgung zu implementieren. -``dc:fromValue`` **TODO** +``dc:get`` Dynamische Variablenauswertung +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -``dc:toValue`` **TODO** - -``dc:date-format`` **TODO** - -``dc:get`` **TODO** +``dc:get(Variablenname)`` ermöglicht es, eine Variable über ihren Namen als String +auszuwerten. Gegenüber der normalen XPath-Variablenauswertung kann die Variable auch +null liefern. Bis auf diese Ausnahme ist der Aufruf ``dc:get('a')`` identisch zu ``$a`` +in XPath-Kontexten. ``dc:max-number`` **TODO** ``dc:min-number`` **TODO** -``dc:find-all`` **TODO** +``dc:fromValue`` **TODO** +``dc:toValue`` **TODO** +