com doc/ja: Clarify what the 'width' in mb_strimwidth means : reference/mbstring/functions/mb-strimwidth.xml refere nce/mbstring/functions/mb-strwidth.xml

Commit:    6b0d987ae38566113d0bbe81c6c254e965bd1e51
Author:    Yoshinari Takaoka <[email protected]>         Tue, 16 Feb 2021 07:38:10 +0900
Parents:   8f828656539e28d63e5a5789a3dab0770d222d0a
Branches:  master

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

Log:
Clarify what the 'width' in mb_strimwidth means

Co-authored-by: Alex Dowad <[email protected]>

Closes GH-124.

Changed paths:
  M  reference/mbstring/functions/mb-strimwidth.xml
  M  reference/mbstring/functions/mb-strwidth.xml


Diff:
diff --git a/reference/mbstring/functions/mb-strimwidth.xml b/reference/mbstring/functions/mb-strimwidth.xml
index 7ea0bff4b1..ef73cf0f11 100644
--- a/reference/mbstring/functions/mb-strimwidth.xml
+++ b/reference/mbstring/functions/mb-strimwidth.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 92f1b8b177eb5730382abf9f27bae868f1bb636f Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 8ef027f13166f0315c70eaf47f02d849b427652d Maintainer: hirokawa Status: ready -->
 <refentry xml:id="function.mb-strimwidth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>mb_strimwidth</refname>
@@ -20,6 +20,11 @@
   <para>
    文字列 <parameter>string</parameter> を指定した幅
    <parameter>width</parameter> で丸めます。
+   半角文字は <literal>1</literal> として、
+   全角文字は <literal>2</literal> として数えます。
+   東アジアの文字の長さに関する詳細は
+   <link xlink:href="&url.unicode.reports;">&url.unicode.reports;</link>
+   を参照して下さい。
   </para>
  </refsect1>
 
diff --git a/reference/mbstring/functions/mb-strwidth.xml b/reference/mbstring/functions/mb-strwidth.xml
index e012fa184f..689f1fb8ad 100644
--- a/reference/mbstring/functions/mb-strwidth.xml
+++ b/reference/mbstring/functions/mb-strwidth.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 92f1b8b177eb5730382abf9f27bae868f1bb636f Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 8ef027f13166f0315c70eaf47f02d849b427652d Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi -->
 <refentry xml:id="function.mb-strwidth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -19,6 +19,9 @@
    文字列 <parameter>string</parameter> の幅を返します。
    半角文字は <literal>1</literal> として、
    全角文字は <literal>2</literal> として数えます。
+   東アジアの文字の長さに関する詳細は
+   <link xlink:href="&url.unicode.reports;">&url.unicode.reports;</link>
+   を参照して下さい。
   </para>
   <para>
    全角文字は次のとおりです。
@@ -111,6 +114,30 @@
   </informaltable>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="mb-strwidth.example.basic">
+   <title><function>mb_strwidth</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+var_dump(
+    mb_strwidth('a'),       // LATIN SMALL LETTER A
+    mb_strwidth("\u{ff41}") // FULLWIDTH LATIN SMALL LETTER A
+);
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+int(1)
+int(2)
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>