Add NEWS/UPGRADING for negative string offsets

diff --git a/NEWS b/NEWS
index 0aff059ebcc0f9c469078110d73e5457ebd83389..fe4640391560ec508a1e07abe70ad250f5f5daa5 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -10,6 +10,8 @@ PHP                                                                        NEWS
   . Implemented the RFC `Support Class Constant Visibility`. (Sean DuBois,
     Reeze Xia, Dmitry)
   . Added void return type. (Andrea)
+  . Added support for negative string offsets in string offset syntax and
+    various string functions. (Francois)
 
 - FTP:
   . Implemented FR #55651 (Option to ignore the returned FTP PASV address).

diff --git a/UPGRADING b/UPGRADING
index 94cea6f9a200d29e0e59533a166816f7ed7e9083..1e944d9e1f0913bcc1ed9c26e35e07aafc66c251 100644 (file)
--- a/UPGRADING
+++ b/UPGRADING
@@ -32,6 +32,9 @@ PHP 7.1 UPGRADE NOTES
 - Core
   . Added void return type, which requires that a function not return a value.
     (RFC: https://wiki.php.net/rfc/void_return_type)
+  . String offset access now supports negative references, which will be
+    counted from the end of the string.
+    (RFC: https://wiki.php.net/rfc/negative-string-offsets)
 
 ========================================
 3. Changes in SAPI modules
@@ -66,6 +69,11 @@ PHP 7.1 UPGRADE NOTES
 - unpack() accepts an additional optional $offset argument. '@' format code
   (that specifes an absolute position) is applyed to input data after
   the $offset argument.
+- strpos(), stripos(), substr_count(), grapheme_strpos(), grapheme_stripos(),
+  grapheme_extract(), iconv_strpos(), mb_strimwidth(), mb_ereg_search_setpos(),
+  mb_strpos() and mb_stripos() now accept negative string offstes.
+- substr_count() and mb_strimwidth() additionally also accept negative length.
+- file_get_contents() accepts a negative seek offset if the stream is seekable.
 
 ========================================
 6. New Functions