com doc/ja: Fix #76314: Specify failure return type for soundex: reference/strings/functions/soundex.xml

Commit:    0eb26f02aa7dee2624a42ad10e0fc62bb9c9ee22
Author:    Yoshinari Takaoka <[email protected]>         Sat, 13 Feb 2021 18:34:15 +0900
Parents:   96e90773ea4166080501453a540b2bbc4350df1a
Branches:  master

Link:       http://git.php.net/?p=doc/ja.git;a=commitdiff;h=0eb26f02aa7dee2624a42ad10e0fc62bb9c9ee22

Log:
Fix #76314: Specify failure return type for soundex

There is no more failure as of PHP 8.0.0, and the former behavior is
already described in the changelog.  We clarify the return value,
though.

Bugs:
https://bugs.php.net/76314

Changed paths:
  M  reference/strings/functions/soundex.xml


Diff:
diff --git a/reference/strings/functions/soundex.xml b/reference/strings/functions/soundex.xml
index 43e38e1754..6d6ac0adea 100644
--- a/reference/strings/functions/soundex.xml
+++ b/reference/strings/functions/soundex.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e095023e408c8cb6378ae16bb6870343a3946919 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 230b56bf45d3871657573097a2be90d77ed2bfc8 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.soundex" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -22,7 +22,6 @@
    soundex キーが生成されるという特性があります。
    このため、発音は知っているが、スペルがわからない場合に、
    データベースを検索することを容易にすることができます。
-   soundex 関数は、ある文字から始まる 4 文字の文字列を返します。
   </para>
   <para>
    この soundex 関数についての説明は、Donald Knuth の "The Art Of Computer Programming,
@@ -50,7 +49,10 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   soundex キーを文字列で返します。
+   soundex キーを、4文字からなる文字列で返します。
+   少なくとも1文字が <parameter>string</parameter> に含まれていた場合、
+   返される文字列はその文字から始まります。
+   そうでない場合、<literal>"0000"</literal> を返します。
   </para>
  </refsect1>