com doc/zh: update strtok(): reference/strings/functions/strtok.xml

From: 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

« previous php.doc.zh (#5956) next »