add format to Decimal type

extend the unit tests to cover new 'format'-setting

Author: saggi-dw

Diff for: _test/types/DecimalTest.php

@@ -102,7 +102,7 @@ public function test_validate_success($value, $min, $max, $decpoint = '.')
     public function valueProvider()
     {
         return [
-            // $value, $expect, $roundto, $decpoint, $thousands, $trimzeros, $prefix='', $postfix='', $engineering = false
+            // $value, $expect, $roundto, $decpoint, $thousands, $trimzeros, $prefix='', $postfix='', $engineering = false, $format = ''
             ['5000', '5 000,00', '2', ',', ' ', false],
             ['5000', '5 000', '2', ',', ' ', true],
             ['5000', '5 000', '0', ',', ' ', false],
@@ -149,6 +149,18 @@ public function valueProvider()
             ['1e15', '1000' . "\xE2\x80\xAF" . 'T', '-1', ',', ' ', true, '', '', true],
             ['1e-21', '0.001' . "\xE2\x80\xAF" . 'a', '-1', ',', ' ', true, '', '', true],
 
+            //format string
+            ['5000', '5 000', '-1', '.', ' ', true, '', '', false, ''],
+            ['5000', '5 000.00', '2', '.', ' ', false, '', '', false, '%s'],
+            ['1.7', '1.70', '-1', '.', ' ', true, '', '', false, '%01.2f'],
+            ['1.7', '1.70' , '-1', '.', ' ', true, '', '', false, '%01.2F'],
+            ['1.7', '0001' , '-1', '.', ' ', true, '', '', false, "%'.04d"],
+            ['15', '1111' , '-1', '.', ' ', true, '', '', false, '%04b'],
+            ['362525200', '3.625e+8' , '-1', '.', ' ', true, '', '', false, '%.3e'],
+            ['362525200', '3.625E+8' , '-1', '.', ' ', true, '', '', false, '%.3E'],
+            ['1', '1' , '-1', '.', ' ', true, '', '', false, '%u'],
+            ['-1', '18446744073709551615' , '-1', '.', ' ', true, '', '', false, '%u'],
+
         ];
     }
 
@@ -158,7 +170,8 @@ public function valueProvider()
     public function test_renderValue(
         $value, $expect, $roundto, $decpoint,
         $thousands, $trimzeros,
-        $prefix = '', $postfix = '', $engineering = false
+        $prefix = '', $postfix = '', $engineering = false,
+        $format = ''
     )
     {
         $decimal = new Decimal([
@@ -168,7 +181,8 @@ public function test_renderValue(
             'trimzeros' => $trimzeros,
             'prefix' => $prefix,
             'postfix' => $postfix,
-            'engineering' => $engineering
+            'engineering' => $engineering,
+            'format' => $format
         ]);
         $R = new \Doku_Renderer_xhtml();
         $R->doc = '';

Diff for: types/Decimal.php

@@ -25,6 +25,7 @@ class Decimal extends AbstractMultiBaseType
         'prefix' => '',
         'postfix' => '',
         'engineering' => false,
+        'format' => '',
     ];
 
     /**
@@ -37,6 +38,10 @@ class Decimal extends AbstractMultiBaseType
      */
     public function renderValue($value, \Doku_Renderer $R, $mode)
     {
+        if (preg_match("/^%(?:['+-:.]?\D?\d*\.?\d*)?[bdeEfFu]$/", $this->config['format'])) {
+            $R->cdata($this->config['prefix'] . sprintf($this->config['format'], $value) . $this->config['postfix']);
+            return true;
+        }
 
         if ($this->config['engineering']) {
             $unitsh = ['', 'k', 'M', 'G', 'T'];