From 25e51e3e37f235887fa7c92be081c3333a4bb47a Mon Sep 17 00:00:00 2001
From: Derick Rethans <derick@php.net>
Date: Sun, 16 Dec 2001 10:34:01 +0000
Subject: [PATCH] - Added changed strtok behavior to the manual

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@65267 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/strings.xml | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/functions/strings.xml b/functions/strings.xml
index a578c963ae..3bdc4ea01b 100644
--- a/functions/strings.xml
+++ b/functions/strings.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.139 $ -->
+<!-- $Revision: 1.140 $ -->
  <reference id="ref.strings">
   <title>String functions</title>
   <titleabbrev>Strings</titleabbrev>
@@ -3425,6 +3425,41 @@ while ($tok) {
      tokenized when any one of the characters in the argument are
      found.
     </para>
+    <para>
+     The behavior when an empty part was found changed with PHP 4.1.0. The old
+     behavior returned an empty string, while the new, correct, behavior
+     simply skips the part of the string:
+     <example>
+      <title>Old <function>strtok</function> behavior</title>
+      <programlisting role="php">
+<![CDATA[
+    $first_token  = strtok('/something', '/');
+    $second_token = strtok('/');
+    var_dump ($first_token, $second_token);
+
+/* Output:
+    string(0) ""
+    string(9) "something"
+*/    
+]]>
+      </programlisting>
+     </example>
+     <example>
+      <title>New <function>strtok</function> behavior</title>
+      <programlisting role="php">
+<![CDATA[
+    $first_token  = strtok('/something', '/');
+    $second_token = strtok('/');
+    var_dump ($first_token, $second_token);
+
+/* Output:
+    string(9) "something"
+    bool(false)
+*/    
+]]>
+      </programlisting>
+     </example>
+    </para>
     <para>
      Also be careful that your tokens may be equal to "0". This
      evaluates to &false; in conditional expressions.