com doc/ja: Clarify what the 'width' in mb_strimwidth means : reference/mbstring/functions/mb-strimwidth.xml refere
nce/mbstring/functions/mb-strwidth.xml
| From: | Yoshinari Takaoka | Date: | Mon, 15 Feb 2021 22:38:10 +0000 |
| Subject: | com doc/ja: Clarify what the 'width' in mb_strimwidth means : reference/mbstring/functions/mb-strimwidth.xml refere nce/mbstring/functions/mb-strwidth.xml |
||
| Groups: | php.doc.ja | ||
| Request: | Send a blank email to doc-ja+get-6185@lists.php.net to get a copy of this message | ||
Commit: 6b0d987ae38566113d0bbe81c6c254e965bd1e51
Author: Yoshinari Takaoka <mumumu@mumumu.org> 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 <alexinbeijing@gmail.com>
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>