Patch add str_starts_with and str_ends_with

ext/standard/basic_functions.c

@@ -174,6 +174,8 @@ static const zend_function_entry basic_functions[] = { /* {{{ */
 	PHP_FE(strtoupper,														arginfo_strtoupper)
 	PHP_FE(strtolower,														arginfo_strtolower)
 	PHP_FE(str_contains,													arginfo_str_contains)
+	PHP_FE(str_starts_with,													arginfo_str_starts_with)
+	PHP_FE(str_ends_with,													arginfo_str_ends_with)
 	PHP_FE(strpos,															arginfo_strpos)
 	PHP_FE(stripos,															arginfo_stripos)
 	PHP_FE(strrpos,															arginfo_strrpos)

ext/standard/basic_functions.stub.php

@@ -588,6 +588,10 @@ function strrchr(string $haystack, string $needle): string|false {}
 
 function str_contains(string $haystack, string $needle): bool {}
 
+function str_starts_with(string $haystack, string $needle): bool {}
+
+function str_ends_with(string $haystack, string $needle): bool {}
+
 function chunk_split(string $str, int $chunklen = 76, string $ending = "\r\n"): string {}
 
 function substr(string $str, int $start, ?int $length = null): string|false {}

ext/standard/basic_functions_arginfo.h

@@ -923,6 +923,16 @@ ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_str_contains, 0, 2, _IS_BOOL, 0)
 	ZEND_ARG_TYPE_INFO(0, needle, IS_STRING, 0)
 ZEND_END_ARG_INFO()
 
+ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_str_starts_with, 0, 2, _IS_BOOL, 0)
+	ZEND_ARG_TYPE_INFO(0, haystack, IS_STRING, 0)
+	ZEND_ARG_TYPE_INFO(0, needle, IS_STRING, 0)
+ZEND_END_ARG_INFO()
+
+ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_str_ends_with, 0, 2, _IS_BOOL, 0)
+	ZEND_ARG_TYPE_INFO(0, haystack, IS_STRING, 0)
+	ZEND_ARG_TYPE_INFO(0, needle, IS_STRING, 0)
+ZEND_END_ARG_INFO()
+
 ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_chunk_split, 0, 1, IS_STRING, 0)
 	ZEND_ARG_TYPE_INFO(0, str, IS_STRING, 0)
 	ZEND_ARG_TYPE_INFO(0, chunklen, IS_LONG, 0)

ext/standard/php_string.h

@@ -40,6 +40,8 @@ PHP_FUNCTION(dirname);
 PHP_FUNCTION(pathinfo);
 PHP_FUNCTION(strstr);
 PHP_FUNCTION(str_contains);
+PHP_FUNCTION(str_starts_with);
+PHP_FUNCTION(str_ends_with);
 PHP_FUNCTION(strpos);
 PHP_FUNCTION(stripos);
 PHP_FUNCTION(strrpos);

ext/standard/string.c

@@ -1866,6 +1866,42 @@ PHP_FUNCTION(str_contains)
 }
 /* }}} */
 
+/* {{{ proto bool str_starts_with(string haystack, string needle)
+   Checks if haystack starts with needle */
+PHP_FUNCTION(str_starts_with) {
+    zend_string *haystack, *needle;
+
+    ZEND_PARSE_PARAMETERS_START(2, 2)
+        Z_PARAM_STR(haystack)
+        Z_PARAM_STR(needle)
+    ZEND_PARSE_PARAMETERS_END();
+
+    if (ZSTR_LEN(needle) > ZSTR_LEN(haystack)) {
+        RETURN_FALSE;
+    }
+
+    RETURN_BOOL(memcmp(ZSTR_VAL(haystack), ZSTR_VAL(needle), ZSTR_LEN(needle)) == 0);
+}
+
+/* {{{ proto bool str_ends_with(string haystack, string needle)
+   Checks if haystack ends with needle */
+PHP_FUNCTION(str_ends_with) {
+    zend_string *haystack, *needle;
+    int k;
+
+    ZEND_PARSE_PARAMETERS_START(2, 2)
+        Z_PARAM_STR(haystack)
+        Z_PARAM_STR(needle)
+    ZEND_PARSE_PARAMETERS_END();
+
+    if (ZSTR_LEN(needle) > ZSTR_LEN(haystack)) {
+        RETURN_FALSE;
+    }
+
+    k = ZSTR_LEN(haystack) - ZSTR_LEN(needle);
+    RETURN_BOOL(memcmp(&(ZSTR_VAL(haystack))[k], ZSTR_VAL(needle), ZSTR_LEN(needle)) == 0);
+}
+
 /* {{{ proto string strchr(string haystack, string needle)
    An alias for strstr */
 /* }}} */

ext/standard/tests/strings/str_ends_with.phpt

@@ -0,0 +1,45 @@
+--TEST--
+str_ends_with() function - unit tests for str_ends_with()
+--FILE--
+<?php
+/* Prototype: bool str_ends_with (string $haystack, string $needle);
+   Description: Determine if $haystack ends with $needle
+*/
+$testStr = "beginningMiddleEnd";
+var_dump(str_ends_with($testStr, "End"));
+var_dump(str_ends_with($testStr, "end"));
+var_dump(str_ends_with($testStr, "en"));
+var_dump(str_ends_with($testStr, $testStr."a"));
+var_dump(str_ends_with("a".$testStr, $testStr));
+var_dump(str_ends_with($testStr, ""));
+var_dump(str_ends_with("", ""));
+var_dump(str_ends_with("", " "));
+var_dump(str_ends_with("\x00", ""));
+var_dump(str_ends_with("\x00", "\x00"));
+var_dump(str_ends_with("a", "\x00"));
+var_dump(str_ends_with("a\x00", "\x00"));
+var_dump(str_ends_with("ab\x00c", "b\x00c"));
+var_dump(str_ends_with("a\x00b", "d\x00b"));
+var_dump(str_ends_with("a\x00b", "a\x00z"));
+var_dump(str_ends_with("a", "\x00a"));
+var_dump(str_ends_with("a", "a\x00"));
+?>
+--EXPECT--
+bool(true)
+bool(false)
+bool(false)
+bool(false)
+bool(true)
+bool(true)
+bool(true)
+bool(false)
+bool(true)
+bool(true)
+bool(false)
+bool(true)
+bool(true)
+bool(false)
+bool(false)
+bool(false)
+bool(false)
+

ext/standard/tests/strings/str_starts_with.phpt

@@ -0,0 +1,43 @@
+--TEST--
+str_starts_with() function - unit tests for str_starts_with()
+--FILE--
+<?php
+/* Prototype: bool str_starts_with (string $haystack, string $needle);
+   Description: Determine if $haystack begins with $needle
+*/
+$testStr = "beginningMiddleEnd";
+var_dump(str_starts_with($testStr, "beginning"));
+var_dump(str_starts_with($testStr, "Beginning"));
+var_dump(str_starts_with($testStr, "eginning"));
+var_dump(str_starts_with($testStr, $testStr."a"));
+var_dump(str_starts_with($testStr, ""));
+var_dump(str_starts_with("", ""));
+var_dump(str_starts_with("", " "));
+var_dump(str_starts_with($testStr, "\x00"));
+var_dump(str_starts_with("\x00", ""));
+var_dump(str_starts_with("\x00", "\x00"));
+var_dump(str_starts_with("\x00a", "\x00"));
+var_dump(str_starts_with("a\x00bc", "a\x00b"));
+var_dump(str_starts_with("a\x00b", "a\x00d"));
+var_dump(str_starts_with("a\x00b", "z\x00b"));
+var_dump(str_starts_with("a", "a\x00"));
+var_dump(str_starts_with("a", "\x00a"));
+?>
+--EXPECT--
+bool(true)
+bool(false)
+bool(false)
+bool(false)
+bool(true)
+bool(true)
+bool(false)
+bool(false)
+bool(true)
+bool(true)
+bool(true)
+bool(true)
+bool(false)
+bool(false)
+bool(false)
+bool(false)
+