com doc/zh: update strtok(): reference/strings/functions/strtok.xml
| From: | Dai Jie | Date: | Fri, 05 Feb 2021 05:44:27 +0000 |
| Subject: | com doc/zh: update strtok(): reference/strings/functions/strtok.xml | ||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-5956@lists.php.net to get a copy of this message | ||
Commit: e9e9a703c05bf1bbef89f413bfaf85c27a1a224b
Author: 蒋文健 <jwjbjg@gmail.com> Fri, 5 Feb 2021 11:50:32 +0800
Committer: daijie <daijie@php.net> Fri, 5 Feb 2021 13:44:27 +0800
Parents: 098e8d7c1a66629705dd295b77d1045df3857d25
Branches: master
Link: http://git.php.net/?p=doc/zh.git;a=commitdiff;h=e9e9a703c05bf1bbef89f413bfaf85c27a1a224b
Log:
update strtok()
Changed paths:
M reference/strings/functions/strtok.xml
Diff:
diff --git a/reference/strings/functions/strtok.xml b/reference/strings/functions/strtok.xml
index d6ef239e..86330b68 100644
--- a/reference/strings/functions/strtok.xml
+++ b/reference/strings/functions/strtok.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 95bdd6883b5dde9504701777ba81b3c5f15df52b Maintainer: daijie Status: ready
-->
-<refentry xmlns="http://docbook.org/ns/docbook"
xml:id="function.strtok" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 2f4863e1f6066a7bc7802164a8f46cd46b067132 Maintainer: daijie Status: ready
-->
+<refentry xml:id="function.strtok" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>strtok</refname>
<refpurpose>标记分割字符串</refpurpose>
@@ -10,19 +10,25 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>strtok</methodname>
-
<methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <type
class="union"><type>string</type><type>false</type></type><methodname>strtok</methodname>
+
<methodparam><type>string</type><parameter>string</parameter></methodparam>
<methodparam><type>string</type><parameter>token</parameter></methodparam>
</methodsynopsis>
+ <simpara>可选 token (不支持命名参数):</simpara>
<methodsynopsis>
- <type>string</type><methodname>strtok</methodname>
+ <type
class="union"><type>string</type><type>false</type></type><methodname>strtok</methodname>
<methodparam><type>string</type><parameter>token</parameter></methodparam>
</methodsynopsis>
<para>
- <function>strtok</function> 将字符串 <parameter>str</parameter>
分割为若干子字符串,每个子字符串以 <parameter>token</parameter>
中的字符分割。这也就意味着,如果有个字符串是 "This is an example
string",你可以使用空格字符将这句话分割成独立的单词。
+ <function>strtok</function> 将字符串 <parameter>string</parameter>
分割为若干子字符串,每个子字符串以
+ <parameter>token</parameter>
中的字符分割。这也就意味着,如果有个字符串是 "This is an example
string",
+ 你可以使用空格字符作为
<parameter>token</parameter>,将这句话分割成独立的单词。
</para>
<para>
- 注意仅第一次调用 strtok 函数时使用 string 参数。后来每次调用
strtok,都将只使用 token 参数,因为它会记住它在字符串 string
中的位置。如果要重新开始分割一个新的字符串,你需要再次使用 string
来调用 strtok 函数,以便完成初始化工作。注意可以在 token
参数中使用多个字符。字符串将被该参数中任何一个字符分割。
+ 注意,仅第一次调用 strtok 函数时才使用 <parameter>string</parameter>
参数。
+ 随后每次调用 strtok 都将只使用 <parameter>token</parameter>
参数,因为它会记住它在当前字符串中的位置。
+ 如果要重新开始分割一个新的字符串,你需要再次使用
<parameter>string</parameter> 参数来调用 strtok 函数来对其进行初始化。
+ 注意,可以在 <parameter>token</parameter>
参数中使用多个字符。字符串将被 <parameter>token</parameter>
参数中任何一个字符分割。
</para>
</refsect1>
@@ -31,7 +37,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
被分成若干子字符串的原始<type>字符串</type>。
@@ -42,7 +48,7 @@
<term><parameter>token</parameter></term>
<listitem>
<para>
- 分割 <parameter>str</parameter> 时使用的分界字符。
+ 分割 <parameter>string</parameter> 时使用的分界字符。
</para>
</listitem>
</varlistentry>
@@ -53,7 +59,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- 标记后的<type>字符串</type>。
+ 标记后的<type>字符串</type>,如果没有更多标记可用,则返回
&false; 。
</para>
</refsect1>
@@ -61,7 +67,7 @@
&reftitle.examples;
<para>
<example>
- <title><function>strtok</function> 范例</title>
+ <title><function>strtok</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -80,7 +86,7 @@ while ($tok !== false) {
</para>
<para>
<example>
- <title>当存在空的部分时 <function>strtok</function>
的反应</title>
+ <title>当 <function>strtok</function>
找不到标记时的反应</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -118,7 +124,6 @@ var_dump($first_token, $second_token);
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml