Passed
Push — master ( a3e4b0...6ea7df )
by Sebastian
05:06
created
src/ConvertHelper/String.php 1 patch
Spacing   +16 added lines, -16 removed lines patch added patch discarded remove patch
@@ -19,14 +19,14 @@  discard block
 block discarded – undo
19 19
      * @param bool $caseInsensitive
20 20
      * @return ConvertHelper_StringMatch[]
21 21
      */
22
-    public static function findString(string $needle, string $haystack, bool $caseInsensitive=false): array
22
+    public static function findString(string $needle, string $haystack, bool $caseInsensitive = false): array
23 23
     {
24
-        if($needle === '') {
24
+        if ($needle === '') {
25 25
             return array();
26 26
         }
27 27
 
28 28
         $function = 'mb_strpos';
29
-        if($caseInsensitive) {
29
+        if ($caseInsensitive) {
30 30
             $function = 'mb_stripos';
31 31
         }
32 32
 
@@ -34,7 +34,7 @@  discard block
 block discarded – undo
34 34
         $positions = array();
35 35
         $length = mb_strlen($needle);
36 36
 
37
-        while( ($pos = $function($haystack, $needle, $pos)) !== false)
37
+        while (($pos = $function($haystack, $needle, $pos)) !== false)
38 38
         {
39 39
             $match = mb_substr($haystack, $pos, $length);
40 40
             $positions[] = new ConvertHelper_StringMatch($pos, $match);
@@ -57,7 +57,7 @@  discard block
 block discarded – undo
57 57
     public static function toArray(string $string) : array
58 58
     {
59 59
         $result = preg_split('//u', $string, 0, PREG_SPLIT_NO_EMPTY);
60
-        if($result !== false) {
60
+        if ($result !== false) {
61 61
             return $result;
62 62
         }
63 63
 
@@ -110,7 +110,7 @@  discard block
 block discarded – undo
110 110
      */
111 111
     public static function toUtf8(string $string) : string
112 112
     {
113
-        if(!self::isASCII($string)) {
113
+        if (!self::isASCII($string)) {
114 114
             return Encoding::toUTF8($string);
115 115
         }
116 116
 
@@ -128,11 +128,11 @@  discard block
 block discarded – undo
128 128
      */
129 129
     public static function isASCII(string $string) : bool
130 130
     {
131
-        if($string === '' || $string === NULL) {
131
+        if ($string === '' || $string === NULL) {
132 132
             return true;
133 133
         }
134 134
 
135
-        if(!is_string($string)) {
135
+        if (!is_string($string)) {
136 136
             return false;
137 137
         }
138 138
 
@@ -147,12 +147,12 @@  discard block
 block discarded – undo
147 147
      */
148 148
     public static function isHTML(string $string) : bool
149 149
     {
150
-        if(preg_match('%<[a-z/][\s\S]*>%siU', $string)) {
150
+        if (preg_match('%<[a-z/][\s\S]*>%siU', $string)) {
151 151
             return true;
152 152
         }
153 153
 
154 154
         $decoded = html_entity_decode($string);
155
-        if($decoded !== $string) {
155
+        if ($decoded !== $string) {
156 156
             return true;
157 157
         }
158 158
 
@@ -184,7 +184,7 @@  discard block
 block discarded – undo
184 184
      * @param int $tabSize The amount of spaces per tab.
185 185
      * @return string
186 186
      */
187
-    public static function tabs2spaces(string $string, int $tabSize=4) : string
187
+    public static function tabs2spaces(string $string, int $tabSize = 4) : string
188 188
     {
189 189
         return str_replace("\t", str_repeat(' ', $tabSize), $string);
190 190
     }
@@ -196,7 +196,7 @@  discard block
 block discarded – undo
196 196
      * @param int $tabSize The amount of spaces per tab in the source string.
197 197
      * @return string
198 198
      */
199
-    public static function spaces2tabs(string $string, int $tabSize=4) : string
199
+    public static function spaces2tabs(string $string, int $tabSize = 4) : string
200 200
     {
201 201
         return str_replace(str_repeat(' ', $tabSize), "\t", $string);
202 202
     }
@@ -273,7 +273,7 @@  discard block
 block discarded – undo
273 273
             return $text;
274 274
         }
275 275
 
276
-        $text = trim(mb_substr($text, 0, $targetLength)) . $append;
276
+        $text = trim(mb_substr($text, 0, $targetLength)).$append;
277 277
 
278 278
         return $text;
279 279
     }
@@ -288,7 +288,7 @@  discard block
 block discarded – undo
288 288
      */
289 289
     public static function explodeTrim(string $delimiter, string $string) : array
290 290
     {
291
-        if(empty($string) || empty($delimiter)) {
291
+        if (empty($string) || empty($delimiter)) {
292 292
             return array();
293 293
         }
294 294
 
@@ -296,8 +296,8 @@  discard block
 block discarded – undo
296 296
         $tokens = array_map('trim', $tokens);
297 297
 
298 298
         $keep = array();
299
-        foreach($tokens as $token) {
300
-            if($token !== '') {
299
+        foreach ($tokens as $token) {
300
+            if ($token !== '') {
301 301
                 $keep[] = $token;
302 302
             }
303 303
         }
Please login to merge, or discard this patch.
src/ConvertHelper/EOL.php 2 patches
Indentation   +26 added lines, -26 removed lines patch added patch discarded remove patch
@@ -29,19 +29,19 @@  discard block
 block discarded – undo
29 29
     const TYPE_LF = 'LF';
30 30
     const TYPE_CR = 'CR';
31 31
     
32
-   /**
33
-    * @var string
34
-    */
32
+    /**
33
+     * @var string
34
+     */
35 35
     protected $char;
36 36
     
37
-   /**
38
-    * @var string
39
-    */
37
+    /**
38
+     * @var string
39
+     */
40 40
     protected $type;
41 41
     
42
-   /**
43
-    * @var string
44
-    */
42
+    /**
43
+     * @var string
44
+     */
45 45
     protected $description;
46 46
 
47 47
     protected static $eolChars = null;
@@ -53,33 +53,33 @@  discard block
 block discarded – undo
53 53
         $this->description = $description;
54 54
     }
55 55
     
56
-   /**
57
-    * The actual EOL character.
58
-    * @return string
59
-    */
56
+    /**
57
+     * The actual EOL character.
58
+     * @return string
59
+     */
60 60
     public function getCharacter() : string
61 61
     {
62 62
         return $this->char;
63 63
     }
64 64
     
65
-   /**
66
-    * A more detailed, human readable description of the character.
67
-    * @return string
68
-    */
65
+    /**
66
+     * A more detailed, human readable description of the character.
67
+     * @return string
68
+     */
69 69
     public function getDescription() : string
70 70
     {
71 71
         return $this->description;
72 72
     }
73 73
     
74
-   /**
75
-    * The EOL character type, e.g. "CR+LF", "CR"...
76
-    * @return string
77
-    * 
78
-    * @see ConvertHelper_EOL::TYPE_CR
79
-    * @see ConvertHelper_EOL::TYPE_CRLF
80
-    * @see ConvertHelper_EOL::TYPE_LF
81
-    * @see ConvertHelper_EOL::TYPE_LFCR
82
-    */
74
+    /**
75
+     * The EOL character type, e.g. "CR+LF", "CR"...
76
+     * @return string
77
+     * 
78
+     * @see ConvertHelper_EOL::TYPE_CR
79
+     * @see ConvertHelper_EOL::TYPE_CRLF
80
+     * @see ConvertHelper_EOL::TYPE_LF
81
+     * @see ConvertHelper_EOL::TYPE_LFCR
82
+     */
83 83
     public function getType() : string
84 84
     {
85 85
         return $this->type;
Please login to merge, or discard this patch.
Spacing   +5 added lines, -5 removed lines patch added patch discarded remove patch
@@ -118,11 +118,11 @@  discard block
 block discarded – undo
118 118
      */
119 119
     public static function detect(string $subjectString) : ?ConvertHelper_EOL
120 120
     {
121
-        if(empty($subjectString)) {
121
+        if (empty($subjectString)) {
122 122
             return null;
123 123
         }
124 124
 
125
-        if(!isset(self::$eolChars))
125
+        if (!isset(self::$eolChars))
126 126
         {
127 127
             $cr = chr((int)hexdec('0d'));
128 128
             $lf = chr((int)hexdec('0a'));
@@ -153,18 +153,18 @@  discard block
 block discarded – undo
153 153
 
154 154
         $max = 0;
155 155
         $results = array();
156
-        foreach(self::$eolChars as $def)
156
+        foreach (self::$eolChars as $def)
157 157
         {
158 158
             $amount = substr_count($subjectString, $def['char']);
159 159
 
160
-            if($amount > $max)
160
+            if ($amount > $max)
161 161
             {
162 162
                 $max = $amount;
163 163
                 $results[] = $def;
164 164
             }
165 165
         }
166 166
 
167
-        if(empty($results)) {
167
+        if (empty($results)) {
168 168
             return null;
169 169
         }
170 170
 
Please login to merge, or discard this patch.
src/ConvertHelper/Array.php 1 patch
Spacing   +14 added lines, -14 removed lines patch added patch discarded remove patch
@@ -15,9 +15,9 @@  discard block
 block discarded – undo
15 15
      */
16 16
     public static function removeKeys(array &$sourceArray, array $keys) : void
17 17
     {
18
-        foreach($keys as $key)
18
+        foreach ($keys as $key)
19 19
         {
20
-            if(array_key_exists($key, $sourceArray)) {
20
+            if (array_key_exists($key, $sourceArray)) {
21 21
                 unset($sourceArray[$key]);
22 22
             }
23 23
         }
@@ -30,18 +30,18 @@  discard block
 block discarded – undo
30 30
      * @param bool $keepKeys Whether to maintain index association
31 31
      * @return array
32 32
      */
33
-    public static function removeValues(array $sourceArray, array $values, bool $keepKeys=false) : array
33
+    public static function removeValues(array $sourceArray, array $values, bool $keepKeys = false) : array
34 34
     {
35 35
         $result = array();
36 36
         $values = array_values($values);
37 37
 
38
-        foreach($sourceArray as $key => $value)
38
+        foreach ($sourceArray as $key => $value)
39 39
         {
40
-            if(in_array($value, $values, true)) {
40
+            if (in_array($value, $values, true)) {
41 41
                 continue;
42 42
             }
43 43
 
44
-            if($keepKeys) {
44
+            if ($keepKeys) {
45 45
                 $result[$key] = $value;
46 46
                 continue;
47 47
             }
@@ -74,7 +74,7 @@  discard block
 block discarded – undo
74 74
     public static function toStyleString(array $subject) : string
75 75
     {
76 76
         $tokens = array();
77
-        foreach($subject as $name => $value) {
77
+        foreach ($subject as $name => $value) {
78 78
             $tokens[] = $name.':'.strval($value);
79 79
         }
80 80
 
@@ -103,18 +103,18 @@  discard block
 block discarded – undo
103 103
     public static function toAttributeString(array $array) : string
104 104
     {
105 105
         $tokens = array();
106
-        foreach($array as $attr => $value)
106
+        foreach ($array as $attr => $value)
107 107
         {
108 108
             $value = strval($value);
109 109
 
110
-            if($value === '') {
110
+            if ($value === '') {
111 111
                 continue;
112 112
             }
113 113
 
114 114
             $tokens[] = $attr.'="'.htmlspecialchars($value, ENT_QUOTES, 'UTF-8').'"';
115 115
         }
116 116
 
117
-        if(empty($tokens)) {
117
+        if (empty($tokens)) {
118 118
             return '';
119 119
         }
120 120
 
@@ -135,17 +135,17 @@  discard block
 block discarded – undo
135 135
      */
136 136
     public static function implodeWithAnd(array $list, string $sep = ', ', string $conjunction = '') : string
137 137
     {
138
-        if(empty($list)) {
138
+        if (empty($list)) {
139 139
             return '';
140 140
         }
141 141
 
142
-        if(empty($conjunction)) {
142
+        if (empty($conjunction)) {
143 143
             $conjunction = ' '.t('and').' ';
144 144
         }
145 145
 
146 146
         $last = array_pop($list);
147
-        if($list) {
148
-            return implode($sep, $list) . $conjunction . $last;
147
+        if ($list) {
148
+            return implode($sep, $list).$conjunction.$last;
149 149
         }
150 150
 
151 151
         return $last;
Please login to merge, or discard this patch.
src/ConvertHelper/Bool.php 1 patch
Spacing   +6 added lines, -6 removed lines patch added patch discarded remove patch
@@ -29,17 +29,17 @@  discard block
 block discarded – undo
29 29
      */
30 30
     public static function fromString($string) : bool
31 31
     {
32
-        if($string === '' || $string === null || !is_scalar($string))
32
+        if ($string === '' || $string === null || !is_scalar($string))
33 33
         {
34 34
             return false;
35 35
         }
36 36
 
37
-        if(is_bool($string))
37
+        if (is_bool($string))
38 38
         {
39 39
             return $string;
40 40
         }
41 41
 
42
-        if(array_key_exists($string, self::$booleanStrings))
42
+        if (array_key_exists($string, self::$booleanStrings))
43 43
         {
44 44
             return self::$booleanStrings[$string];
45 45
         }
@@ -67,7 +67,7 @@  discard block
 block discarded – undo
67 67
     public static function toString($boolean, bool $yesno = false) : string
68 68
     {
69 69
         // allow 'yes', 'true', 'no', 'false' string notations as well
70
-        if(!is_bool($boolean)) {
70
+        if (!is_bool($boolean)) {
71 71
             $boolean = self::fromString($boolean);
72 72
         }
73 73
 
@@ -97,11 +97,11 @@  discard block
 block discarded – undo
97 97
      */
98 98
     public static function isBoolean($value) : bool
99 99
     {
100
-        if(is_bool($value)) {
100
+        if (is_bool($value)) {
101 101
             return true;
102 102
         }
103 103
 
104
-        if(!is_scalar($value)) {
104
+        if (!is_scalar($value)) {
105 105
             return false;
106 106
         }
107 107
 
Please login to merge, or discard this patch.
src/ConvertHelper.php 3 patches
Indentation   +496 added lines, -496 removed lines patch added patch discarded remove patch
@@ -54,13 +54,13 @@  discard block
 block discarded – undo
54 54
         return ConvertHelper_String::tabs2spaces($string, $tabSize);
55 55
     }
56 56
     
57
-   /**
58
-    * Converts spaces to tabs in the specified string.
59
-    * 
60
-    * @param string $string
61
-    * @param int $tabSize The amount of spaces per tab in the source string.
62
-    * @return string
63
-    */
57
+    /**
58
+     * Converts spaces to tabs in the specified string.
59
+     * 
60
+     * @param string $string
61
+     * @param int $tabSize The amount of spaces per tab in the source string.
62
+     * @return string
63
+     */
64 64
     public static function spaces2tabs(string $string, int $tabSize=4) : string
65 65
     {
66 66
         return ConvertHelper_String::spaces2tabs($string, $tabSize);
@@ -78,133 +78,133 @@  discard block
 block discarded – undo
78 78
         return ConvertHelper_String::hidden2visible($string);
79 79
     }
80 80
     
81
-   /**
82
-    * Converts the specified amount of seconds into
83
-    * a human readable string split in months, weeks,
84
-    * days, hours, minutes and seconds.
85
-    *
86
-    * @param float $seconds
87
-    * @return string
88
-    */
81
+    /**
82
+     * Converts the specified amount of seconds into
83
+     * a human readable string split in months, weeks,
84
+     * days, hours, minutes and seconds.
85
+     *
86
+     * @param float $seconds
87
+     * @return string
88
+     */
89 89
     public static function time2string($seconds) : string
90 90
     {
91 91
         $converter = new ConvertHelper_TimeConverter($seconds);
92 92
         return $converter->toString();
93 93
     }
94 94
 
95
-   /**
96
-    * Converts a timestamp into an easily understandable
97
-    * format, e.g. "2 hours", "1 day", "3 months"
98
-    *
99
-    * If you set the date to parameter, the difference
100
-    * will be calculated between the two dates and not
101
-    * the current time.
102
-    *
103
-    * @param integer|DateTime $datefrom
104
-    * @param integer|DateTime $dateto
105
-    * @return string
106
-    */
95
+    /**
96
+     * Converts a timestamp into an easily understandable
97
+     * format, e.g. "2 hours", "1 day", "3 months"
98
+     *
99
+     * If you set the date to parameter, the difference
100
+     * will be calculated between the two dates and not
101
+     * the current time.
102
+     *
103
+     * @param integer|DateTime $datefrom
104
+     * @param integer|DateTime $dateto
105
+     * @return string
106
+     */
107 107
     public static function duration2string($datefrom, $dateto = -1) : string
108 108
     {
109
-         $converter = new ConvertHelper_DurationConverter();
109
+            $converter = new ConvertHelper_DurationConverter();
110 110
          
111
-         if($datefrom instanceof DateTime)
112
-         {
113
-             $converter->setDateFrom($datefrom);
114
-         }
115
-         else
116
-         {
117
-             $converter->setDateFrom(self::timestamp2date($datefrom)); 
118
-         }
111
+            if($datefrom instanceof DateTime)
112
+            {
113
+                $converter->setDateFrom($datefrom);
114
+            }
115
+            else
116
+            {
117
+                $converter->setDateFrom(self::timestamp2date($datefrom)); 
118
+            }
119 119
 
120
-         if($dateto instanceof DateTime)
121
-         {
122
-             $converter->setDateTo($dateto);
123
-         }
124
-         else if($dateto > 0)
125
-         {
126
-             $converter->setDateTo(self::timestamp2date($dateto));
127
-         }
120
+            if($dateto instanceof DateTime)
121
+            {
122
+                $converter->setDateTo($dateto);
123
+            }
124
+            else if($dateto > 0)
125
+            {
126
+                $converter->setDateTo(self::timestamp2date($dateto));
127
+            }
128 128
 
129
-         return $converter->convert();
129
+            return $converter->convert();
130 130
     }
131 131
 
132
-   /**
133
-    * Adds HTML syntax highlighting to the specified SQL string.
134
-    * 
135
-    * @param string $sql
136
-    * @return string
137
-    * @deprecated Use the Highlighter class directly instead.
138
-    * @see Highlighter::sql()
139
-    */
132
+    /**
133
+     * Adds HTML syntax highlighting to the specified SQL string.
134
+     * 
135
+     * @param string $sql
136
+     * @return string
137
+     * @deprecated Use the Highlighter class directly instead.
138
+     * @see Highlighter::sql()
139
+     */
140 140
     public static function highlight_sql(string $sql) : string
141 141
     {
142 142
         return Highlighter::sql($sql);
143 143
     }
144 144
 
145
-   /**
146
-    * Adds HTML syntax highlighting to the specified XML code.
147
-    * 
148
-    * @param string $xml The XML to highlight.
149
-    * @param bool $formatSource Whether to format the source with indentation to make it readable.
150
-    * @return string
151
-    * @deprecated Use the Highlighter class directly instead.
152
-    * @see Highlighter::xml()
153
-    */
145
+    /**
146
+     * Adds HTML syntax highlighting to the specified XML code.
147
+     * 
148
+     * @param string $xml The XML to highlight.
149
+     * @param bool $formatSource Whether to format the source with indentation to make it readable.
150
+     * @return string
151
+     * @deprecated Use the Highlighter class directly instead.
152
+     * @see Highlighter::xml()
153
+     */
154 154
     public static function highlight_xml(string $xml, bool $formatSource=false) : string
155 155
     {
156 156
         return Highlighter::xml($xml, $formatSource);
157 157
     }
158 158
 
159
-   /**
160
-    * @param string $phpCode
161
-    * @return string
162
-    * @deprecated Use the Highlighter class directly instead.
163
-    * @see Highlighter::php()
164
-    */
159
+    /**
160
+     * @param string $phpCode
161
+     * @return string
162
+     * @deprecated Use the Highlighter class directly instead.
163
+     * @see Highlighter::php()
164
+     */
165 165
     public static function highlight_php(string $phpCode) : string
166 166
     {
167 167
         return Highlighter::php($phpCode);
168 168
     }
169 169
     
170
-   /**
171
-    * Converts a number of bytes to a human readable form,
172
-    * e.g. xx Kb / xx Mb / xx Gb
173
-    *
174
-    * @param int $bytes The amount of bytes to convert.
175
-    * @param int $precision The amount of decimals
176
-    * @param int $base The base to calculate with: Base 10 is default (=1000 Bytes in a KB), Base 2 is mainly used for Windows memory (=1024 Bytes in a KB).
177
-    * @return string
178
-    * 
179
-    * @see https://en.m.wikipedia.org/wiki/Megabyte#Definitions
180
-    */
170
+    /**
171
+     * Converts a number of bytes to a human readable form,
172
+     * e.g. xx Kb / xx Mb / xx Gb
173
+     *
174
+     * @param int $bytes The amount of bytes to convert.
175
+     * @param int $precision The amount of decimals
176
+     * @param int $base The base to calculate with: Base 10 is default (=1000 Bytes in a KB), Base 2 is mainly used for Windows memory (=1024 Bytes in a KB).
177
+     * @return string
178
+     * 
179
+     * @see https://en.m.wikipedia.org/wiki/Megabyte#Definitions
180
+     */
181 181
     public static function bytes2readable(int $bytes, int $precision = 1, int $base = ConvertHelper_StorageSizeEnum::BASE_10) : string
182 182
     {
183 183
         return self::parseBytes($bytes)->toString($precision, $base);
184 184
     }
185 185
     
186
-   /**
187
-    * Parses a number of bytes, and creates a converter instance which
188
-    * allows doing common operations with it.
189
-    * 
190
-    * @param int $bytes
191
-    * @return ConvertHelper_ByteConverter
192
-    */
186
+    /**
187
+     * Parses a number of bytes, and creates a converter instance which
188
+     * allows doing common operations with it.
189
+     * 
190
+     * @param int $bytes
191
+     * @return ConvertHelper_ByteConverter
192
+     */
193 193
     public static function parseBytes(int $bytes) : ConvertHelper_ByteConverter
194 194
     {
195 195
         return new ConvertHelper_ByteConverter($bytes);
196 196
     }
197 197
 
198
-   /**
199
-    * Cuts a text to the specified length if it is longer than the
200
-    * target length. Appends a text to signify it has been cut at 
201
-    * the end of the string.
202
-    * 
203
-    * @param string $text
204
-    * @param int $targetLength
205
-    * @param string $append
206
-    * @return string
207
-    */
198
+    /**
199
+     * Cuts a text to the specified length if it is longer than the
200
+     * target length. Appends a text to signify it has been cut at 
201
+     * the end of the string.
202
+     * 
203
+     * @param string $text
204
+     * @param int $targetLength
205
+     * @param string $append
206
+     * @return string
207
+     */
208 208
     public static function text_cut(string $text, int $targetLength, string $append = '...') : string
209 209
     {
210 210
         return ConvertHelper_String::cutText($text, $targetLength, $append);
@@ -221,14 +221,14 @@  discard block
 block discarded – undo
221 221
         return $info->toString();
222 222
     }
223 223
     
224
-   /**
225
-    * Pretty print_r.
226
-    * 
227
-    * @param mixed $var The variable to dump.
228
-    * @param bool $return Whether to return the dumped code.
229
-    * @param bool $html Whether to style the dump as HTML.
230
-    * @return string
231
-    */
224
+    /**
225
+     * Pretty print_r.
226
+     * 
227
+     * @param mixed $var The variable to dump.
228
+     * @param bool $return Whether to return the dumped code.
229
+     * @param bool $html Whether to style the dump as HTML.
230
+     * @return string
231
+     */
232 232
     public static function print_r($var, bool $return=false, bool $html=true) : string
233 233
     {
234 234
         $result = parseVariable($var)->enableType()->toString();
@@ -249,41 +249,41 @@  discard block
 block discarded – undo
249 249
         return $result;
250 250
     }
251 251
     
252
-   /**
253
-    * Converts a string, number or boolean value to a boolean value.
254
-    *
255
-    * @param mixed $string
256
-    * @throws ConvertHelper_Exception
257
-    * @return bool
258
-    *
259
-    * @see ConvertHelper::ERROR_INVALID_BOOLEAN_STRING
260
-    */
252
+    /**
253
+     * Converts a string, number or boolean value to a boolean value.
254
+     *
255
+     * @param mixed $string
256
+     * @throws ConvertHelper_Exception
257
+     * @return bool
258
+     *
259
+     * @see ConvertHelper::ERROR_INVALID_BOOLEAN_STRING
260
+     */
261 261
     public static function string2bool($string) : bool
262 262
     {
263 263
         return ConvertHelper_Bool::fromString($string);
264 264
     }
265 265
 
266
-   /**
267
-    * Whether the specified string is a boolean string or boolean value.
268
-    * Alias for {@link ConvertHelper::isBoolean()}.
269
-    *
270
-    * @param mixed $string
271
-    * @return bool
272
-    * @deprecated
273
-    * @see ConvertHelper::isBoolean()
274
-    */
266
+    /**
267
+     * Whether the specified string is a boolean string or boolean value.
268
+     * Alias for {@link ConvertHelper::isBoolean()}.
269
+     *
270
+     * @param mixed $string
271
+     * @return bool
272
+     * @deprecated
273
+     * @see ConvertHelper::isBoolean()
274
+     */
275 275
     public static function isBooleanString($string) : bool
276 276
     {
277 277
         return self::isBoolean($string);
278 278
     }
279 279
 
280
-   /**
281
-    * Alias for the {@\AppUtils\XMLHelper::string2xml()} method.
282
-    * 
283
-    * @param string $text
284
-    * @return string
285
-    * @deprecated
286
-    */
280
+    /**
281
+     * Alias for the {@\AppUtils\XMLHelper::string2xml()} method.
282
+     * 
283
+     * @param string $text
284
+     * @return string
285
+     * @deprecated
286
+     */
287 287
     public static function text_makeXMLCompliant($text)
288 288
     {
289 289
         return XMLHelper::string2xml($text);
@@ -379,36 +379,36 @@  discard block
 block discarded – undo
379 379
         return ConvertHelper_String::transliterate($string, $spaceChar, $lowercase);
380 380
     }
381 381
     
382
-   /**
383
-    * Retrieves the HEX character codes for all control
384
-    * characters that the {@link stripControlCharacters()} 
385
-    * method will remove.
386
-    * 
387
-    * @return string[]
388
-    */
382
+    /**
383
+     * Retrieves the HEX character codes for all control
384
+     * characters that the {@link stripControlCharacters()} 
385
+     * method will remove.
386
+     * 
387
+     * @return string[]
388
+     */
389 389
     public static function getControlCharactersAsHex()
390 390
     {
391 391
         return self::createControlCharacters()->getCharsAsHex();
392 392
     }
393 393
     
394
-   /**
395
-    * Retrieves an array of all control characters that
396
-    * the {@link stripControlCharacters()} method will 
397
-    * remove, as the actual UTF-8 characters.
398
-    * 
399
-    * @return string[]
400
-    */
394
+    /**
395
+     * Retrieves an array of all control characters that
396
+     * the {@link stripControlCharacters()} method will 
397
+     * remove, as the actual UTF-8 characters.
398
+     * 
399
+     * @return string[]
400
+     */
401 401
     public static function getControlCharactersAsUTF8()
402 402
     {
403 403
         return self::createControlCharacters()->getCharsAsUTF8();
404 404
     }
405 405
     
406
-   /**
407
-    * Retrieves all control characters as JSON encoded
408
-    * characters, e.g. "\u200b".
409
-    * 
410
-    * @return string[]
411
-    */
406
+    /**
407
+     * Retrieves all control characters as JSON encoded
408
+     * characters, e.g. "\u200b".
409
+     * 
410
+     * @return string[]
411
+     */
412 412
     public static function getControlCharactersAsJSON()
413 413
     {
414 414
         return self::createControlCharacters()->getCharsAsJSON();
@@ -429,31 +429,31 @@  discard block
 block discarded – undo
429 429
         return self::createControlCharacters()->stripControlCharacters($string);
430 430
     }
431 431
     
432
-   /**
433
-    * Creates the control characters class, used to 
434
-    * work with control characters in strings.
435
-    * 
436
-    * @return ConvertHelper_ControlCharacters
437
-    */
432
+    /**
433
+     * Creates the control characters class, used to 
434
+     * work with control characters in strings.
435
+     * 
436
+     * @return ConvertHelper_ControlCharacters
437
+     */
438 438
     public static function createControlCharacters() : ConvertHelper_ControlCharacters
439 439
     {
440 440
         return new ConvertHelper_ControlCharacters();
441 441
     }
442 442
 
443
-   /**
444
-    * Converts a unicode character to the PHPO notation.
445
-    * 
446
-    * Example:
447
-    * 
448
-    * <pre>unicodeChar2php('"\u0000"')</pre>
449
-    * 
450
-    * Returns
451
-    * 
452
-    * <pre>\x0</pre>
453
-    * 
454
-    * @param string $unicodeChar
455
-    * @return string
456
-    */
443
+    /**
444
+     * Converts a unicode character to the PHPO notation.
445
+     * 
446
+     * Example:
447
+     * 
448
+     * <pre>unicodeChar2php('"\u0000"')</pre>
449
+     * 
450
+     * Returns
451
+     * 
452
+     * <pre>\x0</pre>
453
+     * 
454
+     * @param string $unicodeChar
455
+     * @return string
456
+     */
457 457
     public static function unicodeChar2php(string $unicodeChar) : string 
458 458
     {
459 459
         $unicodeChar = json_decode($unicodeChar);
@@ -563,87 +563,87 @@  discard block
 block discarded – undo
563 563
         return ConvertHelper_Bool::toString($boolean, $yesno);
564 564
     }
565 565
     
566
-   /**
567
-    * Converts an associative array with attribute name > value pairs
568
-    * to an attribute string that can be used in an HTML tag. Empty 
569
-    * attribute values are ignored.
570
-    * 
571
-    * Example:
572
-    * 
573
-    * array2attributeString(array(
574
-    *     'id' => 45,
575
-    *     'href' => 'http://www.mistralys.com'
576
-    * ));
577
-    * 
578
-    * Result:
579
-    * 
580
-    * id="45" href="http://www.mistralys.com"
581
-    * 
582
-    * @param array<string,mixed> $array
583
-    * @return string
584
-    */
566
+    /**
567
+     * Converts an associative array with attribute name > value pairs
568
+     * to an attribute string that can be used in an HTML tag. Empty 
569
+     * attribute values are ignored.
570
+     * 
571
+     * Example:
572
+     * 
573
+     * array2attributeString(array(
574
+     *     'id' => 45,
575
+     *     'href' => 'http://www.mistralys.com'
576
+     * ));
577
+     * 
578
+     * Result:
579
+     * 
580
+     * id="45" href="http://www.mistralys.com"
581
+     * 
582
+     * @param array<string,mixed> $array
583
+     * @return string
584
+     */
585 585
     public static function array2attributeString(array $array) : string
586 586
     {
587 587
         return ConvertHelper_Array::toAttributeString($array);
588 588
     }
589 589
     
590
-   /**
591
-    * Converts a string so it can safely be used in a javascript
592
-    * statement in an HTML tag: uses single quotes around the string
593
-    * and encodes all special characters as needed.
594
-    * 
595
-    * @param string $string
596
-    * @return string
597
-    * @deprecated Use the JSHelper class instead.
598
-    * @see JSHelper::phpVariable2AttributeJS()
599
-    */
590
+    /**
591
+     * Converts a string so it can safely be used in a javascript
592
+     * statement in an HTML tag: uses single quotes around the string
593
+     * and encodes all special characters as needed.
594
+     * 
595
+     * @param string $string
596
+     * @return string
597
+     * @deprecated Use the JSHelper class instead.
598
+     * @see JSHelper::phpVariable2AttributeJS()
599
+     */
600 600
     public static function string2attributeJS(string $string) : string
601 601
     {
602 602
         return JSHelper::phpVariable2AttributeJS($string);
603 603
     }
604 604
     
605
-   /**
606
-    * Checks if the specified string is a boolean value, which
607
-    * includes string representations of boolean values, like 
608
-    * <code>yes</code> or <code>no</code>, and <code>true</code>
609
-    * or <code>false</code>.
610
-    * 
611
-    * @param mixed $value
612
-    * @return boolean
613
-    */
605
+    /**
606
+     * Checks if the specified string is a boolean value, which
607
+     * includes string representations of boolean values, like 
608
+     * <code>yes</code> or <code>no</code>, and <code>true</code>
609
+     * or <code>false</code>.
610
+     * 
611
+     * @param mixed $value
612
+     * @return boolean
613
+     */
614 614
     public static function isBoolean($value) : bool
615 615
     {
616 616
         return ConvertHelper_Bool::isBoolean($value);
617 617
     }
618 618
     
619
-   /**
620
-    * Converts an associative array to an HTML style attribute value string.
621
-    * 
622
-    * @param array<string,mixed> $subject
623
-    * @return string
624
-    */
619
+    /**
620
+     * Converts an associative array to an HTML style attribute value string.
621
+     * 
622
+     * @param array<string,mixed> $subject
623
+     * @return string
624
+     */
625 625
     public static function array2styleString(array $subject) : string
626 626
     {
627 627
         return ConvertHelper_Array::toStyleString($subject);
628 628
     }
629 629
     
630
-   /**
631
-    * Converts a DateTime object to a timestamp, which
632
-    * is PHP 5.2 compatible.
633
-    * 
634
-    * @param DateTime $date
635
-    * @return integer
636
-    */
630
+    /**
631
+     * Converts a DateTime object to a timestamp, which
632
+     * is PHP 5.2 compatible.
633
+     * 
634
+     * @param DateTime $date
635
+     * @return integer
636
+     */
637 637
     public static function date2timestamp(DateTime $date) : int
638 638
     {
639 639
         return (int)$date->format('U');
640 640
     }
641 641
     
642
-   /**
643
-    * Converts a timestamp into a DateTime instance.
644
-    * @param int $timestamp
645
-    * @return DateTime
646
-    */
642
+    /**
643
+     * Converts a timestamp into a DateTime instance.
644
+     * @param int $timestamp
645
+     * @return DateTime
646
+     */
647 647
     public static function timestamp2date(int $timestamp) : DateTime
648 648
     {
649 649
         $date = new DateTime();
@@ -651,50 +651,50 @@  discard block
 block discarded – undo
651 651
         return $date;
652 652
     }
653 653
     
654
-   /**
655
-    * Strips an absolute path to a file within the application
656
-    * to make the path relative to the application root path.
657
-    * 
658
-    * @param string $path
659
-    * @return string
660
-    * 
661
-    * @see FileHelper::relativizePath()
662
-    * @see FileHelper::relativizePathByDepth()
663
-    */
654
+    /**
655
+     * Strips an absolute path to a file within the application
656
+     * to make the path relative to the application root path.
657
+     * 
658
+     * @param string $path
659
+     * @return string
660
+     * 
661
+     * @see FileHelper::relativizePath()
662
+     * @see FileHelper::relativizePathByDepth()
663
+     */
664 664
     public static function fileRelativize(string $path) : string
665 665
     {
666 666
         return FileHelper::relativizePathByDepth($path);
667 667
     }
668 668
     
669 669
     /**
670
-    * Converts a PHP regex to a javascript RegExp object statement.
671
-    * 
672
-    * NOTE: This is an alias for the JSHelper's `convertRegex` method. 
673
-    * More details are available on its usage there.
674
-    *
675
-    * @param string $regex A PHP preg regex
676
-    * @param string $statementType The type of statement to return: Defaults to a statement to create a RegExp object.
677
-    * @return array|string Depending on the specified return type.
678
-    * 
679
-    * @see JSHelper::buildRegexStatement()
680
-    */
670
+     * Converts a PHP regex to a javascript RegExp object statement.
671
+     * 
672
+     * NOTE: This is an alias for the JSHelper's `convertRegex` method. 
673
+     * More details are available on its usage there.
674
+     *
675
+     * @param string $regex A PHP preg regex
676
+     * @param string $statementType The type of statement to return: Defaults to a statement to create a RegExp object.
677
+     * @return array|string Depending on the specified return type.
678
+     * 
679
+     * @see JSHelper::buildRegexStatement()
680
+     */
681 681
     public static function regex2js(string $regex, string $statementType=JSHelper::JS_REGEX_OBJECT)
682 682
     {
683 683
         return JSHelper::buildRegexStatement($regex, $statementType);
684 684
     }
685 685
     
686
-   /**
687
-    * Converts the specified variable to JSON. Works just
688
-    * like the native `json_encode` method, except that it
689
-    * will trigger an exception on failure, which has the 
690
-    * json error details included in its developer details.
691
-    * 
692
-    * @param mixed $variable
693
-    * @param int $options JSON encode options.
694
-    * @param int $depth 
695
-    * @throws ConvertHelper_Exception
696
-    * @return string
697
-    */
686
+    /**
687
+     * Converts the specified variable to JSON. Works just
688
+     * like the native `json_encode` method, except that it
689
+     * will trigger an exception on failure, which has the 
690
+     * json error details included in its developer details.
691
+     * 
692
+     * @param mixed $variable
693
+     * @param int $options JSON encode options.
694
+     * @param int $depth 
695
+     * @throws ConvertHelper_Exception
696
+     * @return string
697
+     */
698 698
     public static function var2json($variable, int $options=0, int $depth=512) : string
699 699
     {
700 700
         $result = json_encode($variable, $options, $depth);
@@ -715,12 +715,12 @@  discard block
 block discarded – undo
715 715
         );
716 716
     }
717 717
     
718
-   /**
719
-    * Strips all known UTF byte order marks from the specified string.
720
-    * 
721
-    * @param string $string
722
-    * @return string
723
-    */
718
+    /**
719
+     * Strips all known UTF byte order marks from the specified string.
720
+     * 
721
+     * @param string $string
722
+     * @return string
723
+     */
724 724
     public static function stripUTFBom($string)
725 725
     {
726 726
         $boms = FileHelper::getUTFBOMs();
@@ -735,65 +735,65 @@  discard block
 block discarded – undo
735 735
         return $string;
736 736
     }
737 737
 
738
-   /**
739
-    * Converts a string to valid utf8, regardless
740
-    * of the string's encoding(s).
741
-    * 
742
-    * @param string $string
743
-    * @return string
744
-    */
738
+    /**
739
+     * Converts a string to valid utf8, regardless
740
+     * of the string's encoding(s).
741
+     * 
742
+     * @param string $string
743
+     * @return string
744
+     */
745 745
     public static function string2utf8(string $string) : string
746 746
     {
747 747
         return ConvertHelper_String::toUtf8($string);
748 748
     }
749 749
     
750
-   /**
751
-    * Checks whether the specified string is an ASCII
752
-    * string, without any special or UTF8 characters.
753
-    * Note: empty strings and NULL are considered ASCII.
754
-    * Any variable types other than strings are not.
755
-    * 
756
-    * @param string|float|int|NULL $string
757
-    * @return boolean
758
-    */
750
+    /**
751
+     * Checks whether the specified string is an ASCII
752
+     * string, without any special or UTF8 characters.
753
+     * Note: empty strings and NULL are considered ASCII.
754
+     * Any variable types other than strings are not.
755
+     * 
756
+     * @param string|float|int|NULL $string
757
+     * @return boolean
758
+     */
759 759
     public static function isStringASCII($string) : bool
760 760
     {
761 761
         return ConvertHelper_String::isASCII(strval($string));
762 762
     }
763 763
     
764
-   /**
765
-    * Adds HTML syntax highlighting to an URL.
766
-    * 
767
-    * NOTE: Includes the necessary CSS styles. When
768
-    * highlighting several URLs in the same page,
769
-    * prefer using the `parseURL` function instead.
770
-    * 
771
-    * @param string $url
772
-    * @return string
773
-    * @deprecated Use the Highlighter class directly instead.
774
-    * @see Highlighter
775
-    */
764
+    /**
765
+     * Adds HTML syntax highlighting to an URL.
766
+     * 
767
+     * NOTE: Includes the necessary CSS styles. When
768
+     * highlighting several URLs in the same page,
769
+     * prefer using the `parseURL` function instead.
770
+     * 
771
+     * @param string $url
772
+     * @return string
773
+     * @deprecated Use the Highlighter class directly instead.
774
+     * @see Highlighter
775
+     */
776 776
     public static function highlight_url(string $url) : string
777 777
     {
778 778
         return Highlighter::url($url);
779 779
     }
780 780
 
781
-   /**
782
-    * Calculates a percentage match of the source string with the target string.
783
-    * 
784
-    * Options are:
785
-    * 
786
-    * - maxLevenshtein, default: 10
787
-    *   Any levenshtein results above this value are ignored.
788
-    *   
789
-    * - precision, default: 1
790
-    *   The precision of the percentage float value
791
-    * 
792
-    * @param string $source
793
-    * @param string $target
794
-    * @param array $options
795
-    * @return float
796
-    */
781
+    /**
782
+     * Calculates a percentage match of the source string with the target string.
783
+     * 
784
+     * Options are:
785
+     * 
786
+     * - maxLevenshtein, default: 10
787
+     *   Any levenshtein results above this value are ignored.
788
+     *   
789
+     * - precision, default: 1
790
+     *   The precision of the percentage float value
791
+     * 
792
+     * @param string $source
793
+     * @param string $target
794
+     * @param array $options
795
+     * @return float
796
+     */
797 797
     public static function matchString($source, $target, $options=array())
798 798
     {
799 799
         $defaults = array(
@@ -817,14 +817,14 @@  discard block
 block discarded – undo
817 817
         return round(100 - $percent, $options['precision']);
818 818
     }
819 819
     
820
-   /**
821
-    * Converts a date interval to a human readable string with
822
-    * all necessary time components, e.g. "1 year, 2 months and 4 days".
823
-    * 
824
-    * @param \DateInterval $interval
825
-    * @return string
826
-    * @see ConvertHelper_IntervalConverter
827
-    */
820
+    /**
821
+     * Converts a date interval to a human readable string with
822
+     * all necessary time components, e.g. "1 year, 2 months and 4 days".
823
+     * 
824
+     * @param \DateInterval $interval
825
+     * @return string
826
+     * @see ConvertHelper_IntervalConverter
827
+     */
828 828
     public static function interval2string(\DateInterval $interval) : string
829 829
     {
830 830
         $converter = new ConvertHelper_IntervalConverter();
@@ -839,60 +839,60 @@  discard block
 block discarded – undo
839 839
     
840 840
     const INTERVAL_SECONDS = 'seconds';
841 841
     
842
-   /**
843
-    * Converts an interval to its total amount of days.
844
-    * @param \DateInterval $interval
845
-    * @return int
846
-    */
842
+    /**
843
+     * Converts an interval to its total amount of days.
844
+     * @param \DateInterval $interval
845
+     * @return int
846
+     */
847 847
     public static function interval2days(\DateInterval $interval) : int
848 848
     {
849 849
         return self::interval2total($interval, self::INTERVAL_DAYS);
850 850
     }
851 851
 
852
-   /**
853
-    * Converts an interval to its total amount of hours.
854
-    * @param \DateInterval $interval
855
-    * @return int
856
-    */
852
+    /**
853
+     * Converts an interval to its total amount of hours.
854
+     * @param \DateInterval $interval
855
+     * @return int
856
+     */
857 857
     public static function interval2hours(\DateInterval $interval) : int
858 858
     {
859 859
         return self::interval2total($interval, self::INTERVAL_HOURS);
860 860
     }
861 861
     
862
-   /**
863
-    * Converts an interval to its total amount of minutes. 
864
-    * @param \DateInterval $interval
865
-    * @return int
866
-    */
862
+    /**
863
+     * Converts an interval to its total amount of minutes. 
864
+     * @param \DateInterval $interval
865
+     * @return int
866
+     */
867 867
     public static function interval2minutes(\DateInterval $interval) : int
868 868
     {
869 869
         return self::interval2total($interval, self::INTERVAL_MINUTES);
870 870
     }
871 871
     
872
-   /**
873
-    * Converts an interval to its total amount of seconds.
874
-    * @param \DateInterval $interval
875
-    * @return int
876
-    */    
872
+    /**
873
+     * Converts an interval to its total amount of seconds.
874
+     * @param \DateInterval $interval
875
+     * @return int
876
+     */    
877 877
     public static function interval2seconds(\DateInterval $interval) : int
878 878
     {
879 879
         return self::interval2total($interval, self::INTERVAL_SECONDS);
880 880
     }
881 881
     
882
-   /**
883
-    * Calculates the total amount of days / hours / minutes or seconds
884
-    * of a date interval object (depending in the specified units), and 
885
-    * returns the total amount.
886
-    * 
887
-    * @param \DateInterval $interval
888
-    * @param string $unit What total value to calculate.
889
-    * @return integer
890
-    * 
891
-    * @see ConvertHelper::INTERVAL_SECONDS
892
-    * @see ConvertHelper::INTERVAL_MINUTES
893
-    * @see ConvertHelper::INTERVAL_HOURS
894
-    * @see ConvertHelper::INTERVAL_DAYS
895
-    */
882
+    /**
883
+     * Calculates the total amount of days / hours / minutes or seconds
884
+     * of a date interval object (depending in the specified units), and 
885
+     * returns the total amount.
886
+     * 
887
+     * @param \DateInterval $interval
888
+     * @param string $unit What total value to calculate.
889
+     * @return integer
890
+     * 
891
+     * @see ConvertHelper::INTERVAL_SECONDS
892
+     * @see ConvertHelper::INTERVAL_MINUTES
893
+     * @see ConvertHelper::INTERVAL_HOURS
894
+     * @see ConvertHelper::INTERVAL_DAYS
895
+     */
896 896
     public static function interval2total(\DateInterval $interval, $unit=self::INTERVAL_SECONDS) : int
897 897
     {
898 898
         $total = (int)$interval->format('%a');
@@ -932,13 +932,13 @@  discard block
 block discarded – undo
932 932
         'Sunday'
933 933
     );
934 934
     
935
-   /**
936
-    * Converts a date to the corresponding day name.
937
-    * 
938
-    * @param DateTime $date
939
-    * @param bool $short
940
-    * @return string|NULL
941
-    */
935
+    /**
936
+     * Converts a date to the corresponding day name.
937
+     * 
938
+     * @param DateTime $date
939
+     * @param bool $short
940
+     * @return string|NULL
941
+     */
942 942
     public static function date2dayName(DateTime $date, bool $short=false)
943 943
     {
944 944
         $day = $date->format('l');
@@ -953,21 +953,21 @@  discard block
 block discarded – undo
953 953
         return null;
954 954
     }
955 955
     
956
-   /**
957
-    * Retrieves a list of english day names.
958
-    * @return string[]
959
-    */
956
+    /**
957
+     * Retrieves a list of english day names.
958
+     * @return string[]
959
+     */
960 960
     public static function getDayNamesInvariant()
961 961
     {
962 962
         return self::$daysInvariant;
963 963
     }
964 964
     
965
-   /**
966
-    * Retrieves the day names list for the current locale.
967
-    * 
968
-    * @param bool $short
969
-    * @return array
970
-    */
965
+    /**
966
+     * Retrieves the day names list for the current locale.
967
+     * 
968
+     * @param bool $short
969
+     * @return array
970
+     */
971 971
     public static function getDayNames(bool $short=false) : array
972 972
     {
973 973
         if($short) {
@@ -1014,68 +1014,68 @@  discard block
 block discarded – undo
1014 1014
         return ConvertHelper_Array::implodeWithAnd($list, $sep, $conjunction);
1015 1015
     }
1016 1016
     
1017
-   /**
1018
-    * Splits a string into an array of all characters it is composed of.
1019
-    * Unicode character safe.
1020
-    * 
1021
-    * NOTE: Spaces and newlines (both \r and \n) are also considered single
1022
-    * characters.
1023
-    * 
1024
-    * @param string $string
1025
-    * @return string[]
1026
-    */
1017
+    /**
1018
+     * Splits a string into an array of all characters it is composed of.
1019
+     * Unicode character safe.
1020
+     * 
1021
+     * NOTE: Spaces and newlines (both \r and \n) are also considered single
1022
+     * characters.
1023
+     * 
1024
+     * @param string $string
1025
+     * @return string[]
1026
+     */
1027 1027
     public static function string2array(string $string) : array
1028 1028
     {
1029 1029
         return ConvertHelper_String::toArray($string);
1030 1030
     }
1031 1031
     
1032
-   /**
1033
-    * Checks whether the specified string contains HTML code.
1034
-    * 
1035
-    * @param string $string
1036
-    * @return boolean
1037
-    */
1032
+    /**
1033
+     * Checks whether the specified string contains HTML code.
1034
+     * 
1035
+     * @param string $string
1036
+     * @return boolean
1037
+     */
1038 1038
     public static function isStringHTML(string $string) : bool
1039 1039
     {
1040 1040
         return ConvertHelper_String::isHTML($string);
1041 1041
     }
1042 1042
     
1043
-   /**
1044
-    * UTF8-safe wordwrap method: works like the regular wordwrap
1045
-    * PHP function but compatible with UTF8. Otherwise the lengths
1046
-    * are not calculated correctly.
1047
-    * 
1048
-    * @param string $str
1049
-    * @param int $width
1050
-    * @param string $break
1051
-    * @param bool $cut
1052
-    * @return string
1053
-    */
1043
+    /**
1044
+     * UTF8-safe wordwrap method: works like the regular wordwrap
1045
+     * PHP function but compatible with UTF8. Otherwise the lengths
1046
+     * are not calculated correctly.
1047
+     * 
1048
+     * @param string $str
1049
+     * @param int $width
1050
+     * @param string $break
1051
+     * @param bool $cut
1052
+     * @return string
1053
+     */
1054 1054
     public static function wordwrap(string $str, int $width = 75, string $break = "\n", bool $cut = false) : string 
1055 1055
     {
1056 1056
         return ConvertHelper_String::wordwrap($str, $width, $break, $cut);
1057 1057
     }
1058 1058
     
1059
-   /**
1060
-    * Calculates the byte length of a string, taking into 
1061
-    * account any unicode characters.
1062
-    * 
1063
-    * @param string $string
1064
-    * @return int
1065
-    */
1059
+    /**
1060
+     * Calculates the byte length of a string, taking into 
1061
+     * account any unicode characters.
1062
+     * 
1063
+     * @param string $string
1064
+     * @return int
1065
+     */
1066 1066
     public static function string2bytes(string $string): int
1067 1067
     {
1068 1068
         return ConvertHelper_String::toBytes($string);
1069 1069
     }
1070 1070
     
1071
-   /**
1072
-    * Creates a short, 8-character long hash for the specified string.
1073
-    * 
1074
-    * WARNING: Not cryptographically safe.
1075
-    * 
1076
-    * @param string $string
1077
-    * @return string
1078
-    */
1071
+    /**
1072
+     * Creates a short, 8-character long hash for the specified string.
1073
+     * 
1074
+     * WARNING: Not cryptographically safe.
1075
+     * 
1076
+     * @param string $string
1077
+     * @return string
1078
+     */
1079 1079
     public static function string2shortHash(string $string) : string
1080 1080
     {
1081 1081
         return ConvertHelper_String::toShortHash($string);
@@ -1107,88 +1107,88 @@  discard block
 block discarded – undo
1107 1107
         return ConvertHelper_ThrowableInfo::fromThrowable($e);
1108 1108
     }
1109 1109
     
1110
-   /**
1111
-    * Parses the specified query string like the native 
1112
-    * function <code>parse_str</code>, without the key
1113
-    * naming limitations.
1114
-    * 
1115
-    * Using parse_str, dots or spaces in key names are 
1116
-    * replaced by underscores. This method keeps all names
1117
-    * intact.
1118
-    * 
1119
-    * It still uses the parse_str implementation as it 
1120
-    * is tested and tried, but fixes the parameter names
1121
-    * after parsing, as needed.
1122
-    * 
1123
-    * @param string $queryString
1124
-    * @return array
1125
-    * @see ConvertHelper_QueryParser
1126
-    */
1110
+    /**
1111
+     * Parses the specified query string like the native 
1112
+     * function <code>parse_str</code>, without the key
1113
+     * naming limitations.
1114
+     * 
1115
+     * Using parse_str, dots or spaces in key names are 
1116
+     * replaced by underscores. This method keeps all names
1117
+     * intact.
1118
+     * 
1119
+     * It still uses the parse_str implementation as it 
1120
+     * is tested and tried, but fixes the parameter names
1121
+     * after parsing, as needed.
1122
+     * 
1123
+     * @param string $queryString
1124
+     * @return array
1125
+     * @see ConvertHelper_QueryParser
1126
+     */
1127 1127
     public static function parseQueryString(string $queryString) : array
1128 1128
     {
1129 1129
         $parser = new ConvertHelper_QueryParser();
1130 1130
         return $parser->parse($queryString);
1131 1131
     }
1132 1132
 
1133
-   /**
1134
-    * Searches for needle in the specified string, and returns a list
1135
-    * of all occurrences, including the matched string. The matched 
1136
-    * string is useful when doing a case insensitive search, as it 
1137
-    * shows the exact matched case of needle.
1138
-    *   
1139
-    * @param string $needle
1140
-    * @param string $haystack
1141
-    * @param bool $caseInsensitive
1142
-    * @return ConvertHelper_StringMatch[]
1143
-    */
1133
+    /**
1134
+     * Searches for needle in the specified string, and returns a list
1135
+     * of all occurrences, including the matched string. The matched 
1136
+     * string is useful when doing a case insensitive search, as it 
1137
+     * shows the exact matched case of needle.
1138
+     *   
1139
+     * @param string $needle
1140
+     * @param string $haystack
1141
+     * @param bool $caseInsensitive
1142
+     * @return ConvertHelper_StringMatch[]
1143
+     */
1144 1144
     public static function findString(string $needle, string $haystack, bool $caseInsensitive=false): array
1145 1145
     {
1146 1146
         return ConvertHelper_String::findString($needle, $haystack, $caseInsensitive);
1147 1147
     }
1148 1148
     
1149
-   /**
1150
-    * Like explode, but trims all entries, and removes 
1151
-    * empty entries from the resulting array.
1152
-    * 
1153
-    * @param string $delimiter
1154
-    * @param string $string
1155
-    * @return string[]
1156
-    */
1149
+    /**
1150
+     * Like explode, but trims all entries, and removes 
1151
+     * empty entries from the resulting array.
1152
+     * 
1153
+     * @param string $delimiter
1154
+     * @param string $string
1155
+     * @return string[]
1156
+     */
1157 1157
     public static function explodeTrim(string $delimiter, string $string) : array
1158 1158
     {
1159 1159
         return ConvertHelper_String::explodeTrim($delimiter, $string);
1160 1160
     }
1161 1161
     
1162
-   /**
1163
-    * Detects the most used end-of-line character in the subject string.
1164
-    * 
1165
-    * @param string $subjectString The string to check.
1166
-    * @return NULL|ConvertHelper_EOL The detected EOL instance, or NULL if none has been detected.
1167
-    */
1162
+    /**
1163
+     * Detects the most used end-of-line character in the subject string.
1164
+     * 
1165
+     * @param string $subjectString The string to check.
1166
+     * @return NULL|ConvertHelper_EOL The detected EOL instance, or NULL if none has been detected.
1167
+     */
1168 1168
     public static function detectEOLCharacter(string $subjectString) : ?ConvertHelper_EOL
1169 1169
     {
1170 1170
         return ConvertHelper_EOL::detect($subjectString);
1171 1171
     }
1172 1172
 
1173
-   /**
1174
-    * Removes the specified keys from the target array,
1175
-    * if they exist.
1176
-    * 
1177
-    * @param array $array
1178
-    * @param array $keys
1179
-    */
1173
+    /**
1174
+     * Removes the specified keys from the target array,
1175
+     * if they exist.
1176
+     * 
1177
+     * @param array $array
1178
+     * @param array $keys
1179
+     */
1180 1180
     public static function arrayRemoveKeys(array &$array, array $keys) : void
1181 1181
     {
1182 1182
         ConvertHelper_Array::removeKeys($array, $keys);
1183 1183
     }
1184 1184
     
1185
-   /**
1186
-    * Checks if the specified variable is an integer or a string containing an integer.
1187
-    * Accepts both positive and negative integers.
1188
-    * 
1189
-    * @param mixed $value
1190
-    * @return bool
1191
-    */
1185
+    /**
1186
+     * Checks if the specified variable is an integer or a string containing an integer.
1187
+     * Accepts both positive and negative integers.
1188
+     * 
1189
+     * @param mixed $value
1190
+     * @return bool
1191
+     */
1192 1192
     public static function isInteger($value) : bool
1193 1193
     {
1194 1194
         if(is_int($value)) {
@@ -1208,52 +1208,52 @@  discard block
 block discarded – undo
1208 1208
         return false;    
1209 1209
     }
1210 1210
     
1211
-   /**
1212
-    * Converts an amount of seconds to a DateInterval object.
1213
-    * 
1214
-    * @param int $seconds
1215
-    * @return \DateInterval
1216
-    * @throws ConvertHelper_Exception If the date interval cannot be created.
1217
-    * 
1218
-    * @see ConvertHelper::ERROR_CANNOT_GET_DATE_DIFF
1219
-    */
1211
+    /**
1212
+     * Converts an amount of seconds to a DateInterval object.
1213
+     * 
1214
+     * @param int $seconds
1215
+     * @return \DateInterval
1216
+     * @throws ConvertHelper_Exception If the date interval cannot be created.
1217
+     * 
1218
+     * @see ConvertHelper::ERROR_CANNOT_GET_DATE_DIFF
1219
+     */
1220 1220
     public static function seconds2interval(int $seconds) : \DateInterval
1221 1221
     {
1222 1222
         return ConvertHelper_DateInterval::fromSeconds($seconds)->getInterval();
1223 1223
     }
1224 1224
     
1225
-   /**
1226
-    * Converts a size string like "50 MB" to the corresponding byte size.
1227
-    * It is case insensitive, ignores spaces, and supports both traditional
1228
-    * "MB" and "MiB" notations.
1229
-    * 
1230
-    * @param string $size
1231
-    * @return int
1232
-    */
1225
+    /**
1226
+     * Converts a size string like "50 MB" to the corresponding byte size.
1227
+     * It is case insensitive, ignores spaces, and supports both traditional
1228
+     * "MB" and "MiB" notations.
1229
+     * 
1230
+     * @param string $size
1231
+     * @return int
1232
+     */
1233 1233
     public static function size2bytes(string $size) : int
1234 1234
     {
1235 1235
         return self::parseSize($size)->toBytes();
1236 1236
     }
1237 1237
     
1238
-   /**
1239
-    * Parses a size string like "50 MB" and returns a size notation instance
1240
-    * that has utility methods to access information on it, and convert it.
1241
-    * 
1242
-    * @param string $size
1243
-    * @return ConvertHelper_SizeNotation
1244
-    */
1238
+    /**
1239
+     * Parses a size string like "50 MB" and returns a size notation instance
1240
+     * that has utility methods to access information on it, and convert it.
1241
+     * 
1242
+     * @param string $size
1243
+     * @return ConvertHelper_SizeNotation
1244
+     */
1245 1245
     public static function parseSize(string $size) : ConvertHelper_SizeNotation
1246 1246
     {
1247 1247
         return new ConvertHelper_SizeNotation($size);
1248 1248
     }
1249 1249
     
1250
-   /**
1251
-    * Creates a URL finder instance, which can be used to find
1252
-    * URLs in a string - be it plain text, or HTML.
1253
-    * 
1254
-    * @param string $subject
1255
-    * @return ConvertHelper_URLFinder
1256
-    */
1250
+    /**
1251
+     * Creates a URL finder instance, which can be used to find
1252
+     * URLs in a string - be it plain text, or HTML.
1253
+     * 
1254
+     * @param string $subject
1255
+     * @return ConvertHelper_URLFinder
1256
+     */
1257 1257
     public static function createURLFinder(string $subject) : ConvertHelper_URLFinder
1258 1258
     {
1259 1259
         return new ConvertHelper_URLFinder($subject);
Please login to merge, or discard this patch.
Spacing   +42 added lines, -42 removed lines patch added patch discarded remove patch
@@ -49,7 +49,7 @@  discard block
 block discarded – undo
49 49
      * @param int $tabSize The amount of spaces per tab.
50 50
      * @return string
51 51
      */
52
-    public static function tabs2spaces(string $string, int $tabSize=4) : string
52
+    public static function tabs2spaces(string $string, int $tabSize = 4) : string
53 53
     {
54 54
         return ConvertHelper_String::tabs2spaces($string, $tabSize);
55 55
     }
@@ -61,7 +61,7 @@  discard block
 block discarded – undo
61 61
     * @param int $tabSize The amount of spaces per tab in the source string.
62 62
     * @return string
63 63
     */
64
-    public static function spaces2tabs(string $string, int $tabSize=4) : string
64
+    public static function spaces2tabs(string $string, int $tabSize = 4) : string
65 65
     {
66 66
         return ConvertHelper_String::spaces2tabs($string, $tabSize);
67 67
     }
@@ -108,7 +108,7 @@  discard block
 block discarded – undo
108 108
     {
109 109
          $converter = new ConvertHelper_DurationConverter();
110 110
          
111
-         if($datefrom instanceof DateTime)
111
+         if ($datefrom instanceof DateTime)
112 112
          {
113 113
              $converter->setDateFrom($datefrom);
114 114
          }
@@ -117,11 +117,11 @@  discard block
 block discarded – undo
117 117
              $converter->setDateFrom(self::timestamp2date($datefrom)); 
118 118
          }
119 119
 
120
-         if($dateto instanceof DateTime)
120
+         if ($dateto instanceof DateTime)
121 121
          {
122 122
              $converter->setDateTo($dateto);
123 123
          }
124
-         else if($dateto > 0)
124
+         else if ($dateto > 0)
125 125
          {
126 126
              $converter->setDateTo(self::timestamp2date($dateto));
127 127
          }
@@ -151,7 +151,7 @@  discard block
 block discarded – undo
151 151
     * @deprecated Use the Highlighter class directly instead.
152 152
     * @see Highlighter::xml()
153 153
     */
154
-    public static function highlight_xml(string $xml, bool $formatSource=false) : string
154
+    public static function highlight_xml(string $xml, bool $formatSource = false) : string
155 155
     {
156 156
         return Highlighter::xml($xml, $formatSource);
157 157
     }
@@ -210,11 +210,11 @@  discard block
 block discarded – undo
210 210
         return ConvertHelper_String::cutText($text, $targetLength, $append);
211 211
     }
212 212
 
213
-    public static function var_dump($var, $html=true) : string
213
+    public static function var_dump($var, $html = true) : string
214 214
     {
215 215
         $info = parseVariable($var);
216 216
         
217
-        if($html) {
217
+        if ($html) {
218 218
             return $info->toHTML();
219 219
         }
220 220
         
@@ -229,11 +229,11 @@  discard block
 block discarded – undo
229 229
     * @param bool $html Whether to style the dump as HTML.
230 230
     * @return string
231 231
     */
232
-    public static function print_r($var, bool $return=false, bool $html=true) : string
232
+    public static function print_r($var, bool $return = false, bool $html = true) : string
233 233
     {
234 234
         $result = parseVariable($var)->enableType()->toString();
235 235
         
236
-        if($html) 
236
+        if ($html) 
237 237
         {
238 238
             $result = 
239 239
             '<pre style="background:#fff;color:#333;padding:16px;border:solid 1px #bbb;border-radius:4px">'.
@@ -241,7 +241,7 @@  discard block
 block discarded – undo
241 241
             '</pre>';
242 242
         }
243 243
         
244
-        if(!$return) 
244
+        if (!$return) 
245 245
         {
246 246
             echo $result;
247 247
         }
@@ -303,10 +303,10 @@  discard block
 block discarded – undo
303 303
     public static function date2listLabel(DateTime $date, $includeTime = false, $shortMonth = false)
304 304
     {
305 305
         $today = new DateTime();
306
-        if($date->format('d.m.Y') == $today->format('d.m.Y')) {
306
+        if ($date->format('d.m.Y') == $today->format('d.m.Y')) {
307 307
             $label = t('Today');
308 308
         } else {
309
-            $label = $date->format('d') . '. ' . self::month2string((int)$date->format('m'), $shortMonth) . ' ';
309
+            $label = $date->format('d').'. '.self::month2string((int)$date->format('m'), $shortMonth).' ';
310 310
             if ($date->format('Y') != date('Y')) {
311 311
                 $label .= $date->format('Y');
312 312
             }
@@ -461,12 +461,12 @@  discard block
 block discarded – undo
461 461
         $output = '';
462 462
         $split = str_split($unicodeChar);
463 463
         
464
-        foreach($split as $octet) 
464
+        foreach ($split as $octet) 
465 465
         {
466 466
             $ordInt = ord($octet);
467 467
             // Convert from int (base 10) to hex (base 16), for PHP \x syntax
468 468
             $ordHex = base_convert((string)$ordInt, 10, 16);
469
-            $output .= '\x' . $ordHex;
469
+            $output .= '\x'.$ordHex;
470 470
         }
471 471
         
472 472
         return $output;
@@ -499,19 +499,19 @@  discard block
 block discarded – undo
499 499
     
500 500
     protected static function convertScalarForComparison($scalar)
501 501
     {
502
-        if($scalar === '' || is_null($scalar)) {
502
+        if ($scalar === '' || is_null($scalar)) {
503 503
             return null;
504 504
         }
505 505
         
506
-        if(is_bool($scalar)) {
506
+        if (is_bool($scalar)) {
507 507
             return self::bool2string($scalar);
508 508
         }
509 509
         
510
-        if(is_array($scalar)) {
510
+        if (is_array($scalar)) {
511 511
             $scalar = md5(serialize($scalar));
512 512
         }
513 513
         
514
-        if($scalar !== null && !is_scalar($scalar)) {
514
+        if ($scalar !== null && !is_scalar($scalar)) {
515 515
             throw new ConvertHelper_Exception(
516 516
                 'Not a scalar value in comparison',
517 517
                 null,
@@ -678,7 +678,7 @@  discard block
 block discarded – undo
678 678
     * 
679 679
     * @see JSHelper::buildRegexStatement()
680 680
     */
681
-    public static function regex2js(string $regex, string $statementType=JSHelper::JS_REGEX_OBJECT)
681
+    public static function regex2js(string $regex, string $statementType = JSHelper::JS_REGEX_OBJECT)
682 682
     {
683 683
         return JSHelper::buildRegexStatement($regex, $statementType);
684 684
     }
@@ -695,11 +695,11 @@  discard block
 block discarded – undo
695 695
     * @throws ConvertHelper_Exception
696 696
     * @return string
697 697
     */
698
-    public static function var2json($variable, int $options=0, int $depth=512) : string
698
+    public static function var2json($variable, int $options = 0, int $depth = 512) : string
699 699
     {
700 700
         $result = json_encode($variable, $options, $depth);
701 701
         
702
-        if($result !== false) {
702
+        if ($result !== false) {
703 703
             return $result;
704 704
         }
705 705
         
@@ -724,10 +724,10 @@  discard block
 block discarded – undo
724 724
     public static function stripUTFBom($string)
725 725
     {
726 726
         $boms = FileHelper::getUTFBOMs();
727
-        foreach($boms as $bomChars) {
727
+        foreach ($boms as $bomChars) {
728 728
             $length = mb_strlen($bomChars);
729 729
             $text = mb_substr($string, 0, $length);
730
-            if($text==$bomChars) {
730
+            if ($text == $bomChars) {
731 731
                 return mb_substr($string, $length);
732 732
             }
733 733
         }
@@ -794,7 +794,7 @@  discard block
 block discarded – undo
794 794
     * @param array $options
795 795
     * @return float
796 796
     */
797
-    public static function matchString($source, $target, $options=array())
797
+    public static function matchString($source, $target, $options = array())
798 798
     {
799 799
         $defaults = array(
800 800
             'maxLevenshtein' => 10,
@@ -804,12 +804,12 @@  discard block
 block discarded – undo
804 804
         $options = array_merge($defaults, $options);
805 805
         
806 806
         // avoid doing this via levenshtein
807
-        if($source == $target) {
807
+        if ($source == $target) {
808 808
             return 100;
809 809
         }
810 810
         
811 811
         $diff = levenshtein($source, $target);
812
-        if($diff > $options['maxLevenshtein']) {
812
+        if ($diff > $options['maxLevenshtein']) {
813 813
             return 0;
814 814
         }
815 815
         
@@ -893,24 +893,24 @@  discard block
 block discarded – undo
893 893
     * @see ConvertHelper::INTERVAL_HOURS
894 894
     * @see ConvertHelper::INTERVAL_DAYS
895 895
     */
896
-    public static function interval2total(\DateInterval $interval, $unit=self::INTERVAL_SECONDS) : int
896
+    public static function interval2total(\DateInterval $interval, $unit = self::INTERVAL_SECONDS) : int
897 897
     {
898 898
         $total = (int)$interval->format('%a');
899 899
         if ($unit == self::INTERVAL_DAYS) {
900 900
             return $total;
901 901
         }
902 902
         
903
-        $total = ($total * 24) + ((int)$interval->h );
903
+        $total = ($total * 24) + ((int)$interval->h);
904 904
         if ($unit == self::INTERVAL_HOURS) {
905 905
             return $total;
906 906
         }
907 907
     
908
-        $total = ($total * 60) + ((int)$interval->i );
908
+        $total = ($total * 60) + ((int)$interval->i);
909 909
         if ($unit == self::INTERVAL_MINUTES) {
910 910
             return $total;
911 911
         }
912 912
 
913
-        $total = ($total * 60) + ((int)$interval->s );
913
+        $total = ($total * 60) + ((int)$interval->s);
914 914
         if ($unit == self::INTERVAL_SECONDS) {
915 915
             return $total;
916 916
         }
@@ -939,13 +939,13 @@  discard block
 block discarded – undo
939 939
     * @param bool $short
940 940
     * @return string|NULL
941 941
     */
942
-    public static function date2dayName(DateTime $date, bool $short=false)
942
+    public static function date2dayName(DateTime $date, bool $short = false)
943 943
     {
944 944
         $day = $date->format('l');
945 945
         $invariant = self::getDayNamesInvariant();
946 946
         
947 947
         $idx = array_search($day, $invariant);
948
-        if($idx !== false) {
948
+        if ($idx !== false) {
949 949
             $localized = self::getDayNames($short);
950 950
             return $localized[$idx];
951 951
         }
@@ -968,10 +968,10 @@  discard block
 block discarded – undo
968 968
     * @param bool $short
969 969
     * @return array
970 970
     */
971
-    public static function getDayNames(bool $short=false) : array
971
+    public static function getDayNames(bool $short = false) : array
972 972
     {
973
-        if($short) {
974
-            if(!isset(self::$daysShort)) {
973
+        if ($short) {
974
+            if (!isset(self::$daysShort)) {
975 975
                 self::$daysShort = array(
976 976
                     t('Mon'),
977 977
                     t('Tue'),
@@ -986,7 +986,7 @@  discard block
 block discarded – undo
986 986
             return self::$daysShort;
987 987
         }
988 988
         
989
-        if(!isset(self::$days)) {
989
+        if (!isset(self::$days)) {
990 990
             self::$days = array(
991 991
                 t('Monday'),
992 992
                 t('Tuesday'),
@@ -1141,7 +1141,7 @@  discard block
 block discarded – undo
1141 1141
     * @param bool $caseInsensitive
1142 1142
     * @return ConvertHelper_StringMatch[]
1143 1143
     */
1144
-    public static function findString(string $needle, string $haystack, bool $caseInsensitive=false): array
1144
+    public static function findString(string $needle, string $haystack, bool $caseInsensitive = false): array
1145 1145
     {
1146 1146
         return ConvertHelper_String::findString($needle, $haystack, $caseInsensitive);
1147 1147
     }
@@ -1191,17 +1191,17 @@  discard block
 block discarded – undo
1191 1191
     */
1192 1192
     public static function isInteger($value) : bool
1193 1193
     {
1194
-        if(is_int($value)) {
1194
+        if (is_int($value)) {
1195 1195
             return true;
1196 1196
         }
1197 1197
         
1198 1198
         // booleans get converted to numbers, so they would
1199 1199
         // actually match the regex.
1200
-        if(is_bool($value)) {
1200
+        if (is_bool($value)) {
1201 1201
             return false;
1202 1202
         }
1203 1203
         
1204
-        if(is_string($value) && $value !== '') {
1204
+        if (is_string($value) && $value !== '') {
1205 1205
             return preg_match('/\A-?\d+\z/', $value) === 1;
1206 1206
         }
1207 1207
         
@@ -1259,7 +1259,7 @@  discard block
 block discarded – undo
1259 1259
         return new ConvertHelper_URLFinder($subject);
1260 1260
     }
1261 1261
 
1262
-    public static function arrayRemoveValues(array $sourceArray, array $values, bool $keepKeys=false) : array
1262
+    public static function arrayRemoveValues(array $sourceArray, array $values, bool $keepKeys = false) : array
1263 1263
     {
1264 1264
         return ConvertHelper_Array::removeValues($sourceArray, $values, $keepKeys);
1265 1265
     }
Please login to merge, or discard this patch.
Braces   +2 added lines, -4 removed lines patch added patch discarded remove patch
@@ -111,8 +111,7 @@  discard block
 block discarded – undo
111 111
          if($datefrom instanceof DateTime)
112 112
          {
113 113
              $converter->setDateFrom($datefrom);
114
-         }
115
-         else
114
+         } else
116 115
          {
117 116
              $converter->setDateFrom(self::timestamp2date($datefrom)); 
118 117
          }
@@ -120,8 +119,7 @@  discard block
 block discarded – undo
120 119
          if($dateto instanceof DateTime)
121 120
          {
122 121
              $converter->setDateTo($dateto);
123
-         }
124
-         else if($dateto > 0)
122
+         } else if($dateto > 0)
125 123
          {
126 124
              $converter->setDateTo(self::timestamp2date($dateto));
127 125
          }
Please login to merge, or discard this patch.