From d949faa3c36e3552ff21875d465d372eb7ebd87a Mon Sep 17 00:00:00 2001
From: Nuno Lopes <nlopess@php.net>
Date: Wed, 11 Aug 2004 16:19:15 +0000
Subject: [PATCH] document new PHP 5.1 feature: negative limit

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

diff --git a/reference/strings/functions/explode.xml b/reference/strings/functions/explode.xml
index 41270f260a..998d70dc13 100644
--- a/reference/strings/functions/explode.xml
+++ b/reference/strings/functions/explode.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -->
   <refentry id="function.explode">
    <refnamediv>
@@ -30,6 +30,11 @@
      in <parameter>string</parameter>, then <function>explode</function> will
      return an array containing <parameter>string</parameter>.
     </para>
+    <para>
+     If the <parameter>limit</parameter> parameter is negative, all components
+     except the last <parameter>limit</parameter> are returned. This feature
+     was added in PHP 5.1.0.
+    </para>
     <para>
      Although <function>implode</function> can, for historical reasons,
      accept its parameters in either order,
@@ -66,6 +71,42 @@ echo $pass; // *
       </programlisting>
      </example>
     </para>
+    <para>
+     <example>
+      <title><parameter>limit</parameter> parameter examples</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$str = 'one|two|three|four';
+
+// positive limit
+print_r(explode('|', $str, 2));
+
+// negative limit
+print_r(explode('|', $str, -1));
+?>
+]]>
+      </programlisting>
+      <para>
+       The above example will output:
+      </para>
+      <screen>
+<![CDATA[
+Array
+(
+    [0] => one
+    [1] => two|three|four
+)
+Array
+(
+    [0] => one
+    [1] => two
+    [2] => three
+)
+]]>
+      </screen>
+     </example>
+    </para>
 
     &note.bin-safe;