From: Colin O'Dell <colinodell@gmail.com>
Date: Tue, 22 Oct 2019 10:32:41 +0000 (-0400)
Subject: Document the changes to substr functions
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=80103bdb78544495d6a34cbd75fac25492832a95;p=php

Document the changes to substr functions
---

diff --git a/UPGRADING b/UPGRADING
index 8b2bbfee46..40af9ca458 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -271,6 +271,10 @@ PHP 8.0 UPGRADE NOTES
     point. An explicit call to chr() can be used to restore the previous
     behavior.
   . The needle argument for strpos(), strrpos(), stripos(), strripos(), strstr() and stristr() can now be empty.
+  . The length argument for substr(), substr_count(), substr_compare(), and
+    iconv_substr() can now be null. Null values will behave as if no length
+    argument was provided and will therefore return the remainder of the string
+    instead of an empty string.
   . The 'salt' option of password_hash() is no longer supported. If the 'salt'
     option is used a warning is generated, the provided salt is ignored, and a
     generated salt is used instead.