From 08bcb4715c5f2b3a93fe64b7e12a9a6c4b247eb2 Mon Sep 17 00:00:00 2001
From: Sebastian Bergmann <sebastian@php.net>
Date: Tue, 23 Oct 2001 05:26:24 +0000
Subject: [PATCH] array_init() documentation.

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

diff --git a/functions/array.xml b/functions/array.xml
index 118840c72d..4fd337b87e 100644
--- a/functions/array.xml
+++ b/functions/array.xml
@@ -1,5 +1,5 @@
 <?xml encoding="iso-8859-1"?>
-<!-- $Revision: 1.106 $ -->
+<!-- $Revision: 1.107 $ -->
  <reference id="ref.array">
   <title>Array Functions</title>
   <titleabbrev>Arrays</titleabbrev>
@@ -335,6 +335,49 @@ $trans = array_flip ($trans);
    </refsect1>
   </refentry>
 
+  <refentry id="function.array-init">
+   <refnamediv>
+    <refname>array_init</refname>
+    <refpurpose>Initialize an array with values</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>array <function>array_init</function></funcdef>
+      <paramdef>int <parameter>start_index</parameter></paramdef>
+      <paramdef>int <parameter>num</parameter></paramdef>
+      <paramdef>mixed <parameter>value</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>array_init</function> returns an array filled with 
+     <parameter>num</parameter> entries of the value of the 
+     <parameter>value</parameter> parameter, keys starting at the 
+     <parameter>start_index</parameter> parameter.
+    </para>
+    <para>
+     <example>
+      <title><function>array_init</function> example</title>
+      <programlisting role="php">
+$a = array_init(5, 6, 'banana');
+
+/*
+$a now has the following entries:
+
+$a[5]  = "banana";
+$a[6]  = "banana";
+$a[7]  = "banana";
+$a[8]  = "banana";
+$a[9]  = "banana";
+$a[10] = "banana";
+*/
+      </programlisting>
+     </example>     
+    </para>
+   </refsect1>
+  </refentry>
+
   <refentry id="function.array-intersect">
    <refnamediv>
     <refname>array_intersect</refname>