Merge branch 'F17192_qifprepend' into 'develop'

F17192: Implemented new sql function QIFPREPEND. Added documentation refs #17192

See merge request !629

Documentation/Report.rst

@@ -2168,6 +2168,21 @@ Output::
 
     12-345-678
 
+.. _qifprepend:
+
+QIFPREPEND: if not empty show input with prepend separator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The SQL function QIFPREPEND(separator, input) returns 'input' with prepend separator if 'input' is not 'empty string' / '0'.
+
+Example::
+
+    10.sql = SELECT 'lastName', QIFPREPEND(', ','title'), QIFPREPEND(', ','')
+
+Output::
+
+    lastName, title
+
 .. _strip_tags:
 
 strip_tags: strip html tags

extension/Classes/Sql/function.sql

@@ -401,3 +401,21 @@ BEGIN
     RETURN @highlighted_text;
 END;
 
+###
+#
+# QIFPREPEND(separator, input)
+# If 'input' is not empty|0, prepend separator to given input
+#
+DROP FUNCTION IF EXISTS QIFPREPEND;
+CREATE FUNCTION QIFPREPEND(`separator` VARCHAR(128), `input` TEXT)
+    RETURNS TEXT
+    DETERMINISTIC
+    SQL SECURITY INVOKER
+BEGIN
+    DECLARE output TEXT;
+    SET output =
+            IF(ISNULL(`input`) OR `input` = '' OR `input` = '0',
+               '',
+               CONCAT(`separator`, `input`));
+    RETURN output;
+END;
\ No newline at end of file