phpgearbox / string

RoboFile.php

Indentation +10 added lines, -10 removed lines

@@ -19,14 +19,14 @@
 
 class RoboFile extends Robo\Tasks
 {
-	public function test()
-	{
-		exit
-		(
-			$this->taskPHPUnit()
-			->arg('./tests')
-			->option('coverage-clover', './build/logs/clover.xml')
-			->run()->getExitCode()
-		);
-	}
+    public function test()
+    {
+        exit
+        (
+            $this->taskPHPUnit()
+            ->arg('./tests')
+            ->option('coverage-clover', './build/logs/clover.xml')
+            ->run()->getExitCode()
+        );
+    }
 }

src/Exceptions/MisMatchedEncodingException.php

Spacing +1 added lines, -2 removed lines

@@ -15,8 +15,7 @@
 {
     public function __construct()
     {
-        parent::__construct
-        (
+        parent::__construct(
             'You can not append a string of a different encoding '.
             'to that of the existing string!'
         );

src/Str.php

Indentation +19 added lines, -19 removed lines

@@ -27,23 +27,23 @@
  */
 class Str extends Base
 {
-	use Methods\To;
-	use Methods\Is;
-	use Methods\Pad;
-	use Methods\Has;
-	use Methods\Misc;
-	use Methods\Html;
-	use Methods\Regx;
-	use Methods\Trim;
-	use Methods\Remove;
-	use Methods\Ensure;
-	use Methods\Between;
-	use Methods\IndexOf;
-	use Methods\Replace;
-	use Methods\Truncate;
-	use Methods\Contains;
-	use Methods\FirstLast;
-	use Methods\StartEndWith;
-	use Methods\LongestCommon;
-	use Methods\CaseManipulators;
+    use Methods\To;
+    use Methods\Is;
+    use Methods\Pad;
+    use Methods\Has;
+    use Methods\Misc;
+    use Methods\Html;
+    use Methods\Regx;
+    use Methods\Trim;
+    use Methods\Remove;
+    use Methods\Ensure;
+    use Methods\Between;
+    use Methods\IndexOf;
+    use Methods\Replace;
+    use Methods\Truncate;
+    use Methods\Contains;
+    use Methods\FirstLast;
+    use Methods\StartEndWith;
+    use Methods\LongestCommon;
+    use Methods\CaseManipulators;
 }

src/Builder.php

Indentation +6 added lines, -6 removed lines

@@ -78,12 +78,12 @@
     }
 
     /**
-	 * Magic method to automatically turn the builder back into a scalar string.
-	 *
-	 * @see http://php.net/manual/en/language.oop5.magic.php#object.tostring
-	 *
-	 * @return string
-	 */
+     * Magic method to automatically turn the builder back into a scalar string.
+     *
+     * @see http://php.net/manual/en/language.oop5.magic.php#object.tostring
+     *
+     * @return string
+     */
     public function __toString()
     {
         return (string)$this->str;

Spacing +2 added lines, -4 removed lines

@@ -232,16 +232,14 @@
      */
     public function remove($startIndex, $length)
     {
-        $start = UTF8::substr
-        (
+        $start = UTF8::substr(
             (string)$this->str,
             0,
             $startIndex,
             $this->str->getEncoding()
         );
 
-        $end = UTF8::substr
-        (
+        $end = UTF8::substr(
             (string)$this->str,
             $startIndex + $length,
             $this->str->getLength(),

src/Base.php

Indentation +266 added lines, -266 removed lines

@@ -25,306 +25,306 @@
  */
 class Base implements \Countable, \ArrayAccess, \IteratorAggregate, Comparable
 {
-	/**
-	 * This stores the actual scalar string that this object represents.
-	 *
-	 * @var string
-	 */
-	protected $scalarString;
+    /**
+     * This stores the actual scalar string that this object represents.
+     *
+     * @var string
+     */
+    protected $scalarString;
 
-	/**
-	 * This stores the actual scalar string length.
-	 *
-	 * Because Str objects are immutable, we can calculate the length at
-	 * construction time and reuse the same result over and over as needed,
-	 * instead of calling strlen() multiple times.
-	 *
-	 * @var int
-	 */
-	protected $stringLength;
+    /**
+     * This stores the actual scalar string length.
+     *
+     * Because Str objects are immutable, we can calculate the length at
+     * construction time and reuse the same result over and over as needed,
+     * instead of calling strlen() multiple times.
+     *
+     * @var int
+     */
+    protected $stringLength;
 
-	/**
-	 * Returns the string length.
-	 *
-	 * @return int The number of characters in the string.
-	 *             A UTF-8 multi-byte character is counted as 1.
-	 */
-	public function getLength()
-	{
-		return $this->stringLength;
-	}
+    /**
+     * Returns the string length.
+     *
+     * @return int The number of characters in the string.
+     *             A UTF-8 multi-byte character is counted as 1.
+     */
+    public function getLength()
+    {
+        return $this->stringLength;
+    }
 
-	/**
-	 * The stores the string's encoding.
-	 *
-	 * Which should be one of the mbstring module's supported encodings.
-	 * @see http://php.net/manual/en/mbstring.supported-encodings.php
-	 *
-	 * @var string
-	 */
-	protected $encoding;
+    /**
+     * The stores the string's encoding.
+     *
+     * Which should be one of the mbstring module's supported encodings.
+     * @see http://php.net/manual/en/mbstring.supported-encodings.php
+     *
+     * @var string
+     */
+    protected $encoding;
 
-	/**
-	 * Returns the encoding used by the Str object.
-	 *
-	 * @return string The current value of the $encoding property.
-	 */
-	public function getEncoding()
-	{
-		return $this->encoding;
-	}
+    /**
+     * Returns the encoding used by the Str object.
+     *
+     * @return string The current value of the $encoding property.
+     */
+    public function getEncoding()
+    {
+        return $this->encoding;
+    }
 
-	/**
-	 * Initialises a Str object.
-	 *
-	 * @param mixed  $string             Must be a scalar string or an object
-	 *                                   that implements the __toString() method
-	 *                                   or a value that is castable to a scalar
-	 *                                   string.
-	 *
-	 * @param string $encoding           The character encoding to use for this
-	 *                                   string. If not specified, defaults to
-	 *                                   the value returned from
-	 *                                   mb_internal_encoding().
-	 *
-	 * @throws \InvalidArgumentException If an array or object without a
-	 *                                   __toString method is passed as
-	 *                                   the first argument.
-	 */
-	public function __construct($string = '', $encoding = null)
-	{
-		// Make sure we can use the provided string value as a string.
-		if (is_array($string))
-		{
-			throw new \InvalidArgumentException
-			(
-				'Passed value cannot be an array'
-			);
-		}
-		elseif (is_object($string) && !method_exists($string, '__toString'))
-		{
-			throw new \InvalidArgumentException
-			(
-				'Passed object must have a __toString method'
-			);
-		}
+    /**
+     * Initialises a Str object.
+     *
+     * @param mixed  $string             Must be a scalar string or an object
+     *                                   that implements the __toString() method
+     *                                   or a value that is castable to a scalar
+     *                                   string.
+     *
+     * @param string $encoding           The character encoding to use for this
+     *                                   string. If not specified, defaults to
+     *                                   the value returned from
+     *                                   mb_internal_encoding().
+     *
+     * @throws \InvalidArgumentException If an array or object without a
+     *                                   __toString method is passed as
+     *                                   the first argument.
+     */
+    public function __construct($string = '', $encoding = null)
+    {
+        // Make sure we can use the provided string value as a string.
+        if (is_array($string))
+        {
+            throw new \InvalidArgumentException
+            (
+                'Passed value cannot be an array'
+            );
+        }
+        elseif (is_object($string) && !method_exists($string, '__toString'))
+        {
+            throw new \InvalidArgumentException
+            (
+                'Passed object must have a __toString method'
+            );
+        }
 
-		// Store the string internally.
-		$this->scalarString = (string)$string;
+        // Store the string internally.
+        $this->scalarString = (string)$string;
 
-		// Intialise Voku's UTF8 portability layer.
-		UTF8::checkForSupport();
+        // Intialise Voku's UTF8 portability layer.
+        UTF8::checkForSupport();
 
-		// Set the strings encoding.
-		if ($encoding !== null)
-		{
-			$this->encoding = $encoding;
-		}
-		else
-		{
-			$this->encoding = mb_internal_encoding();
-		}
+        // Set the strings encoding.
+        if ($encoding !== null)
+        {
+            $this->encoding = $encoding;
+        }
+        else
+        {
+            $this->encoding = mb_internal_encoding();
+        }
 
-		// Set the strings length property.
-		$this->stringLength = UTF8::strlen($this->scalarString,$this->encoding);
-	}
+        // Set the strings length property.
+        $this->stringLength = UTF8::strlen($this->scalarString,$this->encoding);
+    }
 
-	/**
-	 * Magic method to automatically turn a Str back into a scalar string.
-	 *
-	 * @see http://php.net/manual/en/language.oop5.magic.php#object.tostring
-	 *
-	 * @return string
-	 */
-	public function __toString()
-	{
-		return $this->scalarString;
-	}
+    /**
+     * Magic method to automatically turn a Str back into a scalar string.
+     *
+     * @see http://php.net/manual/en/language.oop5.magic.php#object.tostring
+     *
+     * @return string
+     */
+    public function __toString()
+    {
+        return $this->scalarString;
+    }
 
-	/**
-	 * Factory method to create a new Gears\String\Str object.
-	 *
-	 * @param mixed  $string             Must be a scalar string or an object
-	 *                                   that implements the __toString() method
-	 *                                   or a value that is castable to a scalar
-	 *                                   string.
-	 *
-	 * @param string $encoding           The character encoding to use for this
-	 *                                   string. If not specified, defaults to
-	 *                                   the value returned from
-	 *                                   mb_internal_encoding().
-	 *
-	 * @return static                    A Str object.
-	 *
-	 * @throws \InvalidArgumentException If an array or object without a
-	 *                                   __toString method is passed as
-	 *                                   the first argument.
-	 */
-	public static function s($string = '', $encoding = null)
-	{
-		return new static($string);
-	}
+    /**
+     * Factory method to create a new Gears\String\Str object.
+     *
+     * @param mixed  $string             Must be a scalar string or an object
+     *                                   that implements the __toString() method
+     *                                   or a value that is castable to a scalar
+     *                                   string.
+     *
+     * @param string $encoding           The character encoding to use for this
+     *                                   string. If not specified, defaults to
+     *                                   the value returned from
+     *                                   mb_internal_encoding().
+     *
+     * @return static                    A Str object.
+     *
+     * @throws \InvalidArgumentException If an array or object without a
+     *                                   __toString method is passed as
+     *                                   the first argument.
+     */
+    public static function s($string = '', $encoding = null)
+    {
+        return new static($string);
+    }
 
-	/**
-	 * Helper method, used internally.
-	 *
-	 * Basically all this does is saves us a few key strokes by copying
-	 * the current encoding to the next Str object we are creating.
-	 *
-	 * @param  string $string
-	 * @return static
-	 */
-	protected function newSelf($string)
-	{
-		return static::s($string, $this->encoding);
-	}
+    /**
+     * Helper method, used internally.
+     *
+     * Basically all this does is saves us a few key strokes by copying
+     * the current encoding to the next Str object we are creating.
+     *
+     * @param  string $string
+     * @return static
+     */
+    protected function newSelf($string)
+    {
+        return static::s($string, $this->encoding);
+    }
 
-	/**
-	 * Helper method, used internally.
-	 *
-	 * Given an array of scalar strings we will convert all them to Str objects.
-	 *
-	 * > NOTE: This method is recursive.
-	 *
-	 * @param  array $input
-	 * @return static[]
-	 */
-	protected function newSelfs(array $input)
-	{
-		$strObjects = [];
+    /**
+     * Helper method, used internally.
+     *
+     * Given an array of scalar strings we will convert all them to Str objects.
+     *
+     * > NOTE: This method is recursive.
+     *
+     * @param  array $input
+     * @return static[]
+     */
+    protected function newSelfs(array $input)
+    {
+        $strObjects = [];
 
-		foreach ($input as $key => $value)
-		{
-			if (is_string($value))
-			{
-				// Convert the scalar string to a Str Object
-				$strObjects[$key] = $this->newSelf($value);
-			}
-			elseif (is_array($value))
-			{
-				// Recurse into the array
-				$strObjects[$key] = $this->newSelfs($value);
-			}
-			else
-			{
-				// We don't know what it is do do nothing to it
-				$strObjects[$key] = $value;
-			}
-		}
+        foreach ($input as $key => $value)
+        {
+            if (is_string($value))
+            {
+                // Convert the scalar string to a Str Object
+                $strObjects[$key] = $this->newSelf($value);
+            }
+            elseif (is_array($value))
+            {
+                // Recurse into the array
+                $strObjects[$key] = $this->newSelfs($value);
+            }
+            else
+            {
+                // We don't know what it is do do nothing to it
+                $strObjects[$key] = $value;
+            }
+        }
 
-		return $strObjects;
-	}
+        return $strObjects;
+    }
 
-	/**
-	 * Countable interface method.
-	 *
-	 * @see http://php.net/manual/en/class.countable.php
-	 *
-	 * @return int
-	 */
-	public function count()
-	{
-		return $this->getLength();
-	}
+    /**
+     * Countable interface method.
+     *
+     * @see http://php.net/manual/en/class.countable.php
+     *
+     * @return int
+     */
+    public function count()
+    {
+        return $this->getLength();
+    }
 
-	/**
-	 * IteratorAggregate interface method.
-	 *
-	 * @see http://php.net/manual/en/class.iteratoraggregate.php
-	 *
-	 * @return \ArrayIterator
-	 */
-	public function getIterator()
+    /**
+     * IteratorAggregate interface method.
+     *
+     * @see http://php.net/manual/en/class.iteratoraggregate.php
+     *
+     * @return \ArrayIterator
+     */
+    public function getIterator()
     {
-		$chars = array();
+        $chars = array();
 
         for ($i = 0, $l = $this->getLength(); $i < $l; $i++)
-		{
+        {
             $chars[] = $this[$i];
         }
 
         return new \ArrayIterator($chars);
     }
 
-	/**
-	 * Checks to see if the character index exists.
-	 *
-	 * Implements part of the ArrayAccess interface. Offsets may be
-	 * negative to count from the last character in the string.
-	 *
-	 * @param int $index The integer of the index to check.
-	 * @return boolean
-	 */
-	public function offsetExists($index)
-	{
-		$index = (int)$index;
+    /**
+     * Checks to see if the character index exists.
+     *
+     * Implements part of the ArrayAccess interface. Offsets may be
+     * negative to count from the last character in the string.
+     *
+     * @param int $index The integer of the index to check.
+     * @return boolean
+     */
+    public function offsetExists($index)
+    {
+        $index = (int)$index;
 
-		if ($index >= 0) return ($this->getLength() > $index);
+        if ($index >= 0) return ($this->getLength() > $index);
 
-		return ($this->getLength() >= abs($index));
-	}
+        return ($this->getLength() >= abs($index));
+    }
 
-	/**
-	 * Returns the character at the given index. Offsets may be negative to
-	 * count from the last character in the string. Implements part of the
-	 * ArrayAccess interface, and throws an OutOfBoundsException if the index
-	 * does not exist.
-	 *
-	 * @param  mixed $offset The index from which to retrieve the char
-	 *
-	 * @return string                 The character at the specified index
-	 * @throws \OutOfBoundsException If the positive or negative offset does
-	 *                               not exist
-	 */
-	public function offsetGet($offset)
-	{
-		$offset = (int)$offset;
-		$length = $this->getLength();
+    /**
+     * Returns the character at the given index. Offsets may be negative to
+     * count from the last character in the string. Implements part of the
+     * ArrayAccess interface, and throws an OutOfBoundsException if the index
+     * does not exist.
+     *
+     * @param  mixed $offset The index from which to retrieve the char
+     *
+     * @return string                 The character at the specified index
+     * @throws \OutOfBoundsException If the positive or negative offset does
+     *                               not exist
+     */
+    public function offsetGet($offset)
+    {
+        $offset = (int)$offset;
+        $length = $this->getLength();
 
-		if (($offset >= 0 && $length <= $offset) || $length < abs($offset))
-		{
-			throw new \OutOfBoundsException('No character exists at the index');
-		}
+        if (($offset >= 0 && $length <= $offset) || $length < abs($offset))
+        {
+            throw new \OutOfBoundsException('No character exists at the index');
+        }
 
-		return $this->newSelf(UTF8::substr
-		(
-			$this->scalarString,
-			$offset,
-			1,
-			$this->encoding
-		));
-	}
+        return $this->newSelf(UTF8::substr
+        (
+            $this->scalarString,
+            $offset,
+            1,
+            $this->encoding
+        ));
+    }
 
-	/**
-	 * Implements part of the ArrayAccess interface, but throws an exception
-	 * when called. This maintains the immutability of Str objects.
-	 *
-	 * @param  mixed $offset The index of the character
-	 * @param  mixed $value  Value to set
-	 *
-	 * @throws \Exception When called
-	 */
-	public function offsetSet($offset, $value)
-	{
-		// Str is immutable, cannot directly set char
-		throw new \Exception('Str object is immutable, cannot modify char');
-	}
+    /**
+     * Implements part of the ArrayAccess interface, but throws an exception
+     * when called. This maintains the immutability of Str objects.
+     *
+     * @param  mixed $offset The index of the character
+     * @param  mixed $value  Value to set
+     *
+     * @throws \Exception When called
+     */
+    public function offsetSet($offset, $value)
+    {
+        // Str is immutable, cannot directly set char
+        throw new \Exception('Str object is immutable, cannot modify char');
+    }
 
-	/**
-	 * Implements part of the ArrayAccess interface, but throws an exception
-	 * when called. This maintains the immutability of Str objects.
-	 *
-	 * @param  mixed $offset The index of the character
-	 *
-	 * @throws \Exception When called
-	 */
-	public function offsetUnset($offset)
-	{
-		// Str is immutable, cannot directly unset char
-		throw new \Exception('Str object is immutable, cannot unset char');
-	}
+    /**
+     * Implements part of the ArrayAccess interface, but throws an exception
+     * when called. This maintains the immutability of Str objects.
+     *
+     * @param  mixed $offset The index of the character
+     *
+     * @throws \Exception When called
+     */
+    public function offsetUnset($offset)
+    {
+        // Str is immutable, cannot directly unset char
+        throw new \Exception('Str object is immutable, cannot unset char');
+    }
 
-	/**
+    /**
      * Implements Icecave\Parity\SubClassComparableInterface compare method.
      *
      * @see https://git.io/vVxSz

Spacing +4 added lines, -7 removed lines

@@ -96,15 +96,13 @@ 
 		// Make sure we can use the provided string value as a string.
 		if (is_array($string))
 		{
-			throw new \InvalidArgumentException
-			(
+			throw new \InvalidArgumentException(
 				'Passed value cannot be an array'
 			);
 		}
 		elseif (is_object($string) && !method_exists($string, '__toString'))
 		{
-			throw new \InvalidArgumentException
-			(
+			throw new \InvalidArgumentException(
 				'Passed object must have a __toString method'
 			);
 		}
@@ -126,7 +124,7 @@ 
 		}
 
 		// Set the strings length property.
-		$this->stringLength = UTF8::strlen($this->scalarString,$this->encoding);
+		$this->stringLength = UTF8::strlen($this->scalarString, $this->encoding);
 	}
 
 	/**
@@ -286,8 +284,7 @@ 
 			throw new \OutOfBoundsException('No character exists at the index');
 		}
 
-		return $this->newSelf(UTF8::substr
-		(
+		return $this->newSelf(UTF8::substr(
 			$this->scalarString,
 			$offset,
 			1,

src/Methods/StartEndWith.php

Spacing +2 added lines, -4 removed lines

@@ -29,8 +29,7 @@ 
      */
     public function startsWith($substring, $caseSensitive = true)
     {
-        $startOfStr = UTF8::substr
-        (
+        $startOfStr = UTF8::substr(
             $this->scalarString,
             0,
             UTF8::strlen($substring, $this->encoding),
@@ -60,8 +59,7 @@ 
     {
         $substringLength = UTF8::strlen($substring, $this->encoding);
 
-        $endOfStr = UTF8::substr
-        (
+        $endOfStr = UTF8::substr(
             $this->scalarString,
             $this->getLength() - $substringLength,
             $substringLength,

src/Methods/Is.php

Indentation +112 added lines, -112 removed lines

@@ -16,122 +16,122 @@
 trait Is
 {
     /**
-	 * Is the entire string lower case?
-	 *
-	 * @return bool Whether or not $str contains only lower case characters.
-	 */
-	public function isLowerCase()
-	{
-		return $this->regexMatch('^[[:lower:]]*$');
-	}
+     * Is the entire string lower case?
+     *
+     * @return bool Whether or not $str contains only lower case characters.
+     */
+    public function isLowerCase()
+    {
+        return $this->regexMatch('^[[:lower:]]*$');
+    }
 
     /**
-	 * Is the entire string upper case?
-	 *
-	 * @return bool Whether or not $str contains only upper case characters.
-	 */
-	public function isUpperCase()
-	{
-		return $this->regexMatch('^[[:upper:]]*$');
-	}
+     * Is the entire string upper case?
+     *
+     * @return bool Whether or not $str contains only upper case characters.
+     */
+    public function isUpperCase()
+    {
+        return $this->regexMatch('^[[:upper:]]*$');
+    }
 
     /**
-	 * Returns true if the string contains only alphabetic chars, false
-	 * otherwise.
-	 *
-	 * @return bool Whether or not $str contains only alphabetic chars
-	 */
-	public function isAlpha()
-	{
-		return $this->regexMatch('^[[:alpha:]]*$');
-	}
+     * Returns true if the string contains only alphabetic chars, false
+     * otherwise.
+     *
+     * @return bool Whether or not $str contains only alphabetic chars
+     */
+    public function isAlpha()
+    {
+        return $this->regexMatch('^[[:alpha:]]*$');
+    }
 
     /**
-	 * Returns true if the string contains only alphabetic and numeric chars,
-	 * false otherwise.
-	 *
-	 * @return bool Whether or not $str contains only alphanumeric chars
-	 */
-	public function isAlphanumeric()
-	{
-		return $this->regexMatch('^[[:alnum:]]*$');
-	}
-
-	/**
-	 * Returns true if the string contains only whitespace chars, false
-	 * otherwise.
-	 *
-	 * @return bool Whether or not $str contains only whitespace characters
-	 */
-	public function isBlank()
-	{
-		return $this->regexMatch('^[[:space:]]*$');
-	}
-
-	/**
-	 * Returns true if the string contains only hexadecimal chars, false
-	 * otherwise.
-	 *
-	 * @return bool Whether or not $str contains only hexadecimal chars
-	 */
-	public function isHexadecimal()
-	{
-		return $this->regexMatch('^[[:xdigit:]]*$');
-	}
-
-	/**
-	 * Returns true if the string is JSON, false otherwise. Unlike json_decode
-	 * in PHP 5.x, this method is consistent with PHP 7 and other JSON parsers,
-	 * in that an empty string is not considered valid JSON.
-	 *
-	 * @return bool Whether or not $str is JSON
-	 */
-	public function isJson()
-	{
-		if ($this->getLength() === 0) return false;
-
-		json_decode($this->scalarString);
-
-		return (json_last_error() === JSON_ERROR_NONE);
-	}
-
-	/**
-	 * Returns true if the string is serialized, false otherwise.
-	 *
-	 * @return bool Whether or not $str is serialized
-	 */
-	public function isSerialized()
-	{
-		if ($this->getLength() === 0) return false;
-
-		/** @noinspection PhpUsageOfSilenceOperatorInspection */
-		return
-		(
-			$this->scalarString === 'b:0;' ||
-			@unserialize($this->scalarString) !== false
-		);
-	}
-
-	/**
-	 * Returns true if the string is base64 encoded, false otherwise.
-	 *
-	 * @return bool
-	 */
-	public function isBase64()
-	{
-		// An empty string is by definition not encoded.
-		if ($this->getLength() === 0) return false;
-
-		// Grab the current string value.
-		$possiblyEncoded = $this->scalarString;
-
-		// Attempt to decode it.
-		$decoded = base64_decode($possiblyEncoded, true);
-
-		// If we get false it can't be base64
-		if ($decoded === false) return false;
-
-		// Lets double check
-		return (base64_encode($decoded) === $this->scalarString);
-	}
+     * Returns true if the string contains only alphabetic and numeric chars,
+     * false otherwise.
+     *
+     * @return bool Whether or not $str contains only alphanumeric chars
+     */
+    public function isAlphanumeric()
+    {
+        return $this->regexMatch('^[[:alnum:]]*$');
+    }
+
+    /**
+     * Returns true if the string contains only whitespace chars, false
+     * otherwise.
+     *
+     * @return bool Whether or not $str contains only whitespace characters
+     */
+    public function isBlank()
+    {
+        return $this->regexMatch('^[[:space:]]*$');
+    }
+
+    /**
+     * Returns true if the string contains only hexadecimal chars, false
+     * otherwise.
+     *
+     * @return bool Whether or not $str contains only hexadecimal chars
+     */
+    public function isHexadecimal()
+    {
+        return $this->regexMatch('^[[:xdigit:]]*$');
+    }
+
+    /**
+     * Returns true if the string is JSON, false otherwise. Unlike json_decode
+     * in PHP 5.x, this method is consistent with PHP 7 and other JSON parsers,
+     * in that an empty string is not considered valid JSON.
+     *
+     * @return bool Whether or not $str is JSON
+     */
+    public function isJson()
+    {
+        if ($this->getLength() === 0) return false;
+
+        json_decode($this->scalarString);
+
+        return (json_last_error() === JSON_ERROR_NONE);
+    }
+
+    /**
+     * Returns true if the string is serialized, false otherwise.
+     *
+     * @return bool Whether or not $str is serialized
+     */
+    public function isSerialized()
+    {
+        if ($this->getLength() === 0) return false;
+
+        /** @noinspection PhpUsageOfSilenceOperatorInspection */
+        return
+        (
+            $this->scalarString === 'b:0;' ||
+            @unserialize($this->scalarString) !== false
+        );
+    }
+
+    /**
+     * Returns true if the string is base64 encoded, false otherwise.
+     *
+     * @return bool
+     */
+    public function isBase64()
+    {
+        // An empty string is by definition not encoded.
+        if ($this->getLength() === 0) return false;
+
+        // Grab the current string value.
+        $possiblyEncoded = $this->scalarString;
+
+        // Attempt to decode it.
+        $decoded = base64_decode($possiblyEncoded, true);
+
+        // If we get false it can't be base64
+        if ($decoded === false) return false;
+
+        // Lets double check
+        return (base64_encode($decoded) === $this->scalarString);
+    }
 }

src/Methods/Misc.php

Spacing +6 added lines, -12 removed lines

@@ -66,16 +66,14 @@ 
     {
         if ($index > $this->getLength()) throw new \OutOfBoundsException();
 
-        $start = UTF8::substr
-        (
+        $start = UTF8::substr(
             $this->scalarString,
             0,
             $index,
             $this->encoding
         );
 
-        $end = UTF8::substr
-        (
+        $end = UTF8::substr(
             $this->scalarString,
             $index,
             $this->getLength(),
@@ -104,8 +102,7 @@ 
      */
     public function repeat($multiplier)
     {
-        return $this->newSelf
-        (
+        return $this->newSelf(
             UTF8::str_repeat($this->scalarString, $multiplier)
         );
     }
@@ -163,8 +160,7 @@ 
             $length = $end - $start;
         }
 
-        return $this->newSelf
-        (
+        return $this->newSelf(
             UTF8::substr($this->scalarString, $start, $length, $this->encoding)
         );
     }
@@ -179,8 +175,7 @@ 
      */
     public function surround($substring)
     {
-        return $this->newSelf
-        (
+        return $this->newSelf(
             implode('', [$substring, $this->scalarString, $substring])
         );
     }
@@ -213,8 +208,7 @@ 
     {
         if ($caseSensitive)
         {
-            return UTF8::substr_count
-            (
+            return UTF8::substr_count(
                 $this->scalarString,
                 $substring,
                 $this->encoding

src/Methods/Between.php

Spacing +1 added lines, -2 removed lines

@@ -42,8 +42,7 @@
         $endIndex = $this->indexOf($end, $substrIndex);
         if ($endIndex === false) return $this->newSelf('');
 
-        $result = UTF8::substr
-        (
+        $result = UTF8::substr(
             $this->scalarString,
             $substrIndex,
             $endIndex - $substrIndex,