From f8bcfe208dcdc0d0df23719ec70c83892724a6f2 Mon Sep 17 00:00:00 2001
From: Yoshinari Takaoka <mumumu@mumumu.org>
Date: Wed, 19 Jun 2024 18:49:46 +0900
Subject: [PATCH] Clarify return value of strcmp() and friends

https://github.com/php/doc-en/commit/40364a64d707d6ec49f6870045807c93e09dba6d
---
 appendices/migration82/other-changes.xml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/appendices/migration82/other-changes.xml b/appendices/migration82/other-changes.xml
index d2ed7dfc3a..600c53f6fb 100644
--- a/appendices/migration82/other-changes.xml
+++ b/appendices/migration82/other-changes.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: d5a469df43e34526de33d5ee0e9f8788af2fe443 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 40364a64d707d6ec49f6870045807c93e09dba6d Maintainer: mumumu Status: ready -->
 <sect1 xml:id="migration82.other-changes" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>その他の変更</title>
 
@@ -50,7 +50,10 @@
     <function>strcmp</function>, <function>strcasecmp</function>,
     <function>strncmp</function>, <function>strncasecmp</function>,
     <function>substr_compare</function> は、
-    <literal>-1</literal>, <literal>0</literal>, <literal>1</literal> を返すようになりました。
+    比較対象の文字列の長さが等しくないときに <code>strlen($string1) - strlen($string2)</code> を返すことが保証されなくなり、
+    <literal>-1</literal> や <literal>1</literal> を返すようになりました。
+    返される具体的な値に依存する代わりに、これらの関数の戻り値は
+    <literal>0</literal> と比較すべきです。
    </para>
   </sect3>