Support a single padding value for exploded

inc/GlobalFunctions.php

@@ -513,15 +513,16 @@ function get_public_properties($object)
   /**
    * Explode a string, filling the remainder with provided defaults.
    *
-   * @param string   $delimiter The boundary string
-   * @param string   $string    The input string.
-   * @param array    $defaults  Array to return, with replacements made
-   * @param int|null $limit     Passed through to the initial explode
+   * @param string      $delimiter The boundary string
+   * @param string      $string    The input string.
+   * @param array|mixed $defaults  Array to return, with replacements made,
+   *                               or a padding value
+   * @param int|null    $limit     Passed through to the initial explode
    *
    * @return array
    *
    */
-  function exploded($delimiter, $string, array $defaults = [], $limit = null)
+  function exploded($delimiter, $string, $defaults = null, $limit = null)
   {
     if($limit === null)
     {
@@ -532,7 +533,12 @@ function exploded($delimiter, $string, array $defaults = [], $limit = null)
       $parts = explode($delimiter, $string, $limit);
     }
 
-    return array_replace($defaults, $parts);
+    if(is_array($defaults))
+    {
+      return array_replace($defaults, $parts);
+    }
+
+    return array_pad($parts, $limit, $defaults);
   }
 }
 

phpunit.xml

@@ -16,4 +16,13 @@
       <directory>tests</directory>
     </testsuite>
   </testsuites>
-</phpunit>
+  <filter>
+    <whitelist>
+      <directory suffix=".php">src</directory>
+    </whitelist>
+    <blacklist>
+      <directory suffix=".php">vendor</directory>
+      <directory suffix=".php">tests</directory>
+    </blacklist>
+  </filter>
+</phpunit>

tests/GlobalFunctionsTest.php

@@ -249,6 +249,10 @@ public function testExploded()
       [1, 2, 3, 4, 5],
       exploded(",", "1,2,3,4,5", $defaults)
     );
+    $this->assertEquals(
+      [1, 2, 3, '-', '-'],
+      exploded(",", "1,2,3", '-', 5)
+    );
   }
 
   public function testBetween()