#104 Add support for MySQL LEFT(), RIGHT() (#105)

#104 Add support for MySQL LEFT(), RIGHT()

Author: daverogers

README.md

@@ -85,6 +85,8 @@ In order to reduce clutter it is preferable to create a separate Service Provide
 - [format(number, decimals, locale = 'en_US')](https://dev.mysql.com/doc/refman/8.0/en/string-functions.html#function_format)
 - [lpad(string, length, pad)](https://dev.mysql.com/doc/refman/8.0/en/string-functions.html#function_lpad)
 - [rpad(string, length, pad)](https://dev.mysql.com/doc/refman/8.0/en/string-functions.html#function_rpad)
+- [left(string, length)](https://dev.mysql.com/doc/refman/8.0/en/string-functions.html#function_left)
+- [right(string, length)](https://dev.mysql.com/doc/refman/8.0/en/string-functions.html#function_right)
 ### Miscellaneous
 - [inet_ntoa(ipAddress)](https://dev.mysql.com/doc/refman/8.0/en/miscellaneous-functions.html#function_inet-ntoa)
 ### Vectorface-Specific

src/Mhorninger/MySQLite/MethodRewriteConstants.php

@@ -15,5 +15,7 @@ class MethodRewriteConstants
         '/WEEK(?=\\))/' => 'weeks\'',
         '/MONTH(?=\\))/' => 'months\'',
         '/YEAR(?=\\))/' => 'years\'',
+        '/LEFT(?=.*?, .*?\\))/' => '`LEFT`',
+        '/RIGHT(?=.*?, .*?\\))/' => '`RIGHT`',
     ];
 }

src/Mhorninger/MySQLite/MySQL/StringExtended.php

@@ -8,6 +8,7 @@ trait StringExtended
 {
     /**
      * Format a number according to the nubmer of decimals provided and culture.
+     *
      * @param mixed... number, decimals, culture.
      */
     // phpcs:disable
@@ -57,4 +58,14 @@ public static function mysql_rpad($string, $length, $pad)
             return substr($string, 0, $length);
         }
     }
+
+    public static function mysql_left($string, $length)
+    {
+        return substr($string, 0, $length);
+    }
+
+    public static function mysql_right($string, $length)
+    {
+        return substr($string, -$length);
+    }
 }

test/Mhorninger/MySQLite/StringMethodTest.php

@@ -125,5 +125,21 @@ public function testRpadNull()
         $this->assertNull($result->value);
     }
 
+    public function testLeft()
+    {
+        $query = "SELECT LEFT('TESTING', 4) as value;";
+        $result = $this->conn->selectOne($query);
+        $expected = 'TEST';
+        $this->assertEquals($expected, $result->value);
+    }
+
+    public function testRight()
+    {
+        $query = "SELECT RIGHT('TESTING', 3) as value;";
+        $result = $this->conn->selectOne($query);
+        $expected = 'ING';
+        $this->assertEquals($expected, $result->value);
+    }
+
     //endregion
 }