Add docs and tests for decode_uri

m-kuhn · m-kuhn · commit ce271e65d639 · 2018-12-11T15:52:05.000+01:00
diff --git a/resources/function_help/json/decode_uri b/resources/function_help/json/decode_uri
@@ -0,0 +1,12 @@
+{
+  "name": "decode_uri",
+  "type": "function",
+  "description": "Takes a layer and decodes the uri of the undelying data provider. It depends on the dataprovider, which data is available.",
+  "arguments": [ {"arg":"layer","description":"The layer for which the uri should be decoded."},
+                 {"arg":"part","description":"The part of the uri to return. If unspecified, a map with all uri parts will be returned."} ],
+  "examples": [ { "expression":"decode_uri(@layer)", "returns":"{'layerId': '0', 'layerName': '', 'path': '/home/qgis/shapefile.shp'}"},
+                { "expression":"decode_uri(@layer)", "returns":"{'layerId': NULL, 'layerName': 'layer', 'path': '/home/qgis/geopackage.shp'}"},
+                { "expression":"decode_uri(@layer), 'path'", "returns":"'/home/qgis/geopackage.shp'"},
+              ]
+}
+
diff --git a/tests/src/core/testqgsexpression.cpp b/tests/src/core/testqgsexpression.cpp
@@ -1266,6 +1266,8 @@ class TestQgsExpression: public QObject
       QTest::newRow( "layer_property storage_type" ) << QStringLiteral( "layer_property('%1','storage_type')" ).arg( mPointsLayer->name() ) << false << QVariant( "ESRI Shapefile" );
       QTest::newRow( "layer_property geometry_type" ) << QStringLiteral( "layer_property('%1','geometry_type')" ).arg( mPointsLayer->name() ) << false << QVariant( "Point" );
 
+      QTest::newRow( "decode_uri shp path" ) << QStringLiteral( "array_last(string_to_array(replace(decode_uri('@layer'%1', 'path'), '\\\\', '/'), '/'))" ).arg( mPointsLayer->name() ) << false << QVariant( "points.shp" );
+
       // raster_statistic tests
       QTest::newRow( "raster_statistic no layer" ) << "raster_statistic('',1,'min')" << false << QVariant();
       QTest::newRow( "raster_statistic bad layer" ) << "raster_statistic('bad',1,'min')" << false << QVariant();
