Skip to content

Commit 3564678

Browse files
committed
対応漏れを修正 / [PHP 8.4] Add mb_* functions
php/doc-en@27ae0a4
1 parent 1069486 commit 3564678

File tree

3 files changed

+91
-230
lines changed

3 files changed

+91
-230
lines changed

reference/strings/functions/ltrim.xml

Lines changed: 31 additions & 76 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: eabde0419cf90f596f60db00e31fcb6ebe41ac55 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 27ae0a4a16cdfc868a884c0f0dad7023b5f2709c Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka -->
55
<refentry xml:id="function.ltrim" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -15,84 +15,41 @@
1515
<methodparam><type>string</type><parameter>string</parameter></methodparam>
1616
<methodparam choice="opt"><type>string</type><parameter>characters</parameter><initializer>" \n\r\t\v\x00"</initializer></methodparam>
1717
</methodsynopsis>
18-
<para>
18+
<simpara>
1919
文字列の最初から空白 (もしくはその他の文字) を取り除きます。
20-
</para>
20+
</simpara>
21+
<simpara>
22+
二番目の引数を指定しない場合、
23+
<function>mb_ltrim</function> は以下の文字を取り除きます:
24+
</simpara>
25+
&strings.stripped.characters;
2126
</refsect1>
2227

2328
<refsect1 role="parameters">
2429
&reftitle.parameters;
25-
<para>
26-
<variablelist>
27-
<varlistentry>
28-
<term><parameter>string</parameter></term>
29-
<listitem>
30-
<para>
31-
入力文字列。
32-
</para>
33-
</listitem>
34-
</varlistentry>
35-
<varlistentry>
36-
<term><parameter>characters</parameter></term>
37-
<listitem>
38-
<para>
39-
<parameter>characters</parameter>パラメータにより、削除する
40-
文字を指定することも可能です。削除したい全ての文字をリストに
41-
してください。<literal>..</literal>を文字の範囲を指定する際に
42-
使用可能です。
43-
</para>
44-
</listitem>
45-
</varlistentry>
46-
</variablelist>
47-
</para>
48-
</refsect1>
49-
50-
<refsect1 role="returnvalues">
51-
&reftitle.returnvalues;
52-
<para>
53-
この関数は <parameter>string</parameter> の最初から空白文字を取り除き、
54-
取り除かれた文字列を返します。2番目のパラメータを指定しない場合、
55-
<function>ltrim</function>は以下の文字を削除します。
56-
<!-- sorted by importance. Printed 3 times: trim, ltrim, rtrim -->
57-
<itemizedlist>
58-
<listitem>
59-
<simpara>
60-
" " (<acronym>ASCII</acronym> <literal>32</literal>
61-
(<literal>0x20</literal>)), 通常の空白。
62-
</simpara>
63-
</listitem>
64-
<listitem>
65-
<simpara>
66-
"\t" (<acronym>ASCII</acronym> <literal>9</literal>
67-
(<literal>0x09</literal>)), タブ。
68-
</simpara>
69-
</listitem>
30+
<variablelist>
31+
<varlistentry>
32+
<term><parameter>string</parameter></term>
7033
<listitem>
7134
<simpara>
72-
"\n" (<acronym>ASCII</acronym> <literal>10</literal>
73-
(<literal>0x0A</literal>)), 改行。
35+
The input string.
7436
</simpara>
7537
</listitem>
38+
</varlistentry>
39+
<varlistentry>
40+
<term><parameter>characters</parameter></term>
7641
<listitem>
77-
<simpara>
78-
"\r" (<acronym>ASCII</acronym> <literal>13</literal>
79-
(<literal>0x0D</literal>)), 復帰。
80-
</simpara>
42+
&strings.parameter.characters.optional;
8143
</listitem>
82-
<listitem>
83-
<simpara>
84-
"\0" (<acronym>ASCII</acronym> <literal>0</literal>
85-
(<literal>0x00</literal>)), <literal>NUL</literal> バイト。
86-
</simpara>
87-
</listitem>
88-
<listitem>
89-
<simpara>
90-
"\v" (<acronym>ASCII</acronym> <literal>11</literal>
91-
(<literal>0x0B</literal>)), 垂直タブ。
92-
</simpara>
93-
</listitem>
94-
</itemizedlist>
95-
</para>
44+
</varlistentry>
45+
</variablelist>
46+
</refsect1>
47+
48+
<refsect1 role="returnvalues">
49+
&reftitle.returnvalues;
50+
<simpara>
51+
この関数は、<parameter>string</parameter> の先頭から空白文字を削除して返します
52+
</simpara>
9653
</refsect1>
9754

9855
<refsect1 role="examples">
@@ -121,8 +78,8 @@ var_dump($trimmed);
12178
$trimmed = ltrim($hello, "Hdle");
12279
var_dump($trimmed);
12380
124-
// ASCII 制御文字 (0 から 31 まで) を
125-
// $binary の先頭から取り除きます
81+
// trim the ASCII control characters at the beginning of $binary
82+
// (from 0 to 31 inclusive)
12683
$clean = ltrim($binary, "\x00..\x1F");
12784
var_dump($clean);
12885
@@ -150,12 +107,10 @@ string(15) "Example string
150107

151108
<refsect1 role="seealso">
152109
&reftitle.seealso;
153-
<para>
154-
<simplelist>
155-
<member><function>trim</function></member>
156-
<member><function>rtrim</function></member>
157-
</simplelist>
158-
</para>
110+
<simplelist>
111+
<member><function>trim</function></member>
112+
<member><function>rtrim</function></member>
113+
</simplelist>
159114
</refsect1>
160115

161116
</refentry>

reference/strings/functions/rtrim.xml

Lines changed: 29 additions & 76 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: eabde0419cf90f596f60db00e31fcb6ebe41ac55 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 27ae0a4a16cdfc868a884c0f0dad7023b5f2709c Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xml:id="function.rtrim" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -15,87 +15,42 @@
1515
<methodparam><type>string</type><parameter>string</parameter></methodparam>
1616
<methodparam choice="opt"><type>string</type><parameter>characters</parameter><initializer>" \n\r\t\v\x00"</initializer></methodparam>
1717
</methodsynopsis>
18-
<para>
18+
<simpara>
1919
この関数は文字列 <parameter>string</parameter> の最後から空白文字 (あるいはその他の文字) を取り除き、
2020
取り除かれた文字列を返します。
21-
</para>
22-
<para>
21+
</simpara>
22+
<simpara>
2323
2 番目のパラメータを指定しない場合、
24-
<function>rtrim</function> は以下の文字を削除します。
25-
<!-- sorted by importance. Printed 3 times: trim, ltrim, rtrim -->
26-
<itemizedlist>
27-
<listitem>
28-
<simpara>
29-
" " (<acronym>ASCII</acronym> <literal>32</literal>
30-
(<literal>0x20</literal>)), 通常の空白。
31-
</simpara>
32-
</listitem>
33-
<listitem>
34-
<simpara>
35-
"\t" (<acronym>ASCII</acronym> <literal>9</literal>
36-
(<literal>0x09</literal>)), タブ。
37-
</simpara>
38-
</listitem>
39-
<listitem>
40-
<simpara>
41-
"\n" (<acronym>ASCII</acronym> <literal>10</literal>
42-
(<literal>0x0A</literal>)), 改行。
43-
</simpara>
44-
</listitem>
45-
<listitem>
46-
<simpara>
47-
"\r" (<acronym>ASCII</acronym> <literal>13</literal>
48-
(<literal>0x0D</literal>)), 復帰。
49-
</simpara>
50-
</listitem>
24+
<function>rtrim</function> は以下の文字を削除します:
25+
</simpara>
26+
&strings.stripped.characters;
27+
</refsect1>
28+
29+
<refsect1 role="parameters">
30+
&reftitle.parameters;
31+
<variablelist>
32+
<varlistentry>
33+
<term><parameter>string</parameter></term>
5134
<listitem>
5235
<simpara>
53-
"\0" (<acronym>ASCII</acronym> <literal>0</literal>
54-
(<literal>0x00</literal>)), <literal>NULL</literal> バイト。
36+
入力文字列。
5537
</simpara>
5638
</listitem>
39+
</varlistentry>
40+
<varlistentry>
41+
<term><parameter>characters</parameter></term>
5742
<listitem>
58-
<simpara>
59-
"\v" (<acronym>ASCII</acronym> <literal>11</literal>
60-
(<literal>0x0B</literal>)), 垂直タブ。
61-
</simpara>
43+
&strings.parameter.characters.optional;
6244
</listitem>
63-
</itemizedlist>
64-
</para>
65-
</refsect1>
66-
67-
<refsect1 role="parameters">
68-
&reftitle.parameters;
69-
<para>
70-
<variablelist>
71-
<varlistentry>
72-
<term><parameter>string</parameter></term>
73-
<listitem>
74-
<para>
75-
入力文字列。
76-
</para>
77-
</listitem>
78-
</varlistentry>
79-
<varlistentry>
80-
<term><parameter>characters</parameter></term>
81-
<listitem>
82-
<para>
83-
<parameter>characters</parameter> パラメータにより、
84-
削除する文字を指定することも可能です。
85-
削除したい全ての文字をリストにしてください。<literal>..</literal>
86-
を文字の範囲を指定する際に使用可能です。
87-
</para>
88-
</listitem>
89-
</varlistentry>
90-
</variablelist>
91-
</para>
45+
</varlistentry>
46+
</variablelist>
9247
</refsect1>
9348

9449
<refsect1 role="returnvalues">
9550
&reftitle.returnvalues;
96-
<para>
51+
<simpara>
9752
変更後の文字列を返します。
98-
</para>
53+
</simpara>
9954
</refsect1>
10055

10156
<refsect1 role="examples">
@@ -123,8 +78,8 @@ var_dump($trimmed);
12378
$trimmed = rtrim($hello, "Hdle");
12479
var_dump($trimmed);
12580
126-
// ASCII 制御文字 (0 から 31 まで) を
127-
// $binary の末尾から取り除きます
81+
// trim the ASCII control characters at the end of $binary
82+
// (from 0 to 31 inclusive)
12883
$clean = rtrim($binary, "\x00..\x1F");
12984
var_dump($clean);
13085
@@ -151,12 +106,10 @@ string(15) " Example string"
151106

152107
<refsect1 role="seealso">
153108
&reftitle.seealso;
154-
<para>
155-
<simplelist>
156-
<member><function>trim</function></member>
157-
<member><function>ltrim</function></member>
158-
</simplelist>
159-
</para>
109+
<simplelist>
110+
<member><function>trim</function></member>
111+
<member><function>ltrim</function></member>
112+
</simplelist>
160113
</refsect1>
161114

162115
</refentry>

0 commit comments

Comments
 (0)