Skip to content

Commit cd87371

Browse files
committed
Update strlen documentation for PHP8
Length parameter to substr() behaves differently for PHP8+. It recognizes null as if no value was provided at all. Updated the documentation to reflect this. php/doc-en@560262a
1 parent c294036 commit cd87371

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

reference/strings/functions/substr.xml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 89ee07c72d1b19bf7050f8df276159a5bf0645c3 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 560262a55786e36fe60b37653b1965d0e82c0753 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xml:id="function.substr" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -89,7 +89,8 @@ $rest = substr("abcdef", -3, 1); // "d" を返す
8989
空の文字列が返されます。
9090
</para>
9191
<para>
92-
<parameter>length</parameter> が指定され、かつ <literal>0</literal>、&null;、もしくは &false; であれば、空の文字が返されます。
92+
<parameter>length</parameter> が指定され、かつ
93+
<literal>0</literal> であれば、空の文字が返されます。
9394
</para>
9495
<para>
9596
<parameter>length</parameter> を省略した場合は、
@@ -158,6 +159,7 @@ $rest = substr("abcdef", -3, -1); // "de" を返す
158159
<![CDATA[
159160
<?php
160161
echo substr('abcdef', 1); // bcdef
162+
echo substr("abcdef", 1, null); // bcdef, PHP 8.0.0 より前のバージョンでは、空の文字列を返していました。
161163
echo substr('abcdef', 1, 3); // bcd
162164
echo substr('abcdef', 0, 4); // abcd
163165
echo substr('abcdef', 0, 8); // abcdef

0 commit comments

Comments
 (0)