[PHP-DOC] cvs: phpdoc /en/reference/url/functions http-build-query.xml

[Nuno Lopes]

nlopess         Sat Aug 12 18:10:14 2006 UTC

  Modified files:              
    /phpdoc/en/reference/url/functions  http-build-query.xml 
  Log:
  add the arg_separator parameter
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/url/functions/http-build-query.xml?r1=1.12&r2=1.13&diff_format=u
Index: phpdoc/en/reference/url/functions/http-build-query.xml
diff -u phpdoc/en/reference/url/functions/http-build-query.xml:1.12 
phpdoc/en/reference/url/functions/http-build-query.xml:1.13
--- phpdoc/en/reference/url/functions/http-build-query.xml:1.12 Mon Apr 17 
13:39:01 2006
+++ phpdoc/en/reference/url/functions/http-build-query.xml      Sat Aug 12 
18:10:14 2006
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.12 $ -->
+<!-- $Revision: 1.13 $ -->
 <refentry id="function.http-build-query">
  <refnamediv>
   <refname>http_build_query</refname>
@@ -12,6 +12,7 @@
    <type>string</type><methodname>http_build_query</methodname>
    <methodparam><type>array</type><parameter>formdata</parameter></methodparam>
    <methodparam 
choice="opt"><type>string</type><parameter>numeric_prefix</parameter></methodparam>
+   <methodparam 
choice="opt"><type>string</type><parameter>arg_separator</parameter></methodparam>
   </methodsynopsis>
   <simpara>
    Generates a URL-encoded query string from the associative (or indexed) 
array provided.
@@ -27,7 +28,9 @@
   <note>
    <para>
     <link linkend="ini.arg-separator.output">arg_separator.output</link> is
-    used to separate arguments.
+    used to separate arguments, unless the
+    <parameter>arg_separator</parameter> parameter is specified, which is then
+    used.
    </para>
   </note>
 
@@ -42,6 +45,8 @@
               'php'=>'hypertext processor');
 
 echo http_build_query($data); // 
foo=bar&baz=boom&cow=milk&php=hypertext+processor
+echo http_build_query($data, '', '&amp;'); // 
foo=bar&amp;baz=boom&amp;cow=milk&amp;php=hypertext+processor
+
 ?>
 ]]>
    </programlisting>
@@ -134,6 +139,12 @@
    </programlisting>
   </example>
 
+  <note>
+   <simpara>
+    The <parameter>arg_separator</parameter> parameter was added in PHP 5.1.2.
+   </simpara>
+  </note>
+
   <simpara>
    See also:
    <function>parse_str</function>,