<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.dbase.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.dbase-create.php',
    1 => 'dbase_create',
    2 => 'Crea una base de datos dBase',
  ),
  'up' => 
  array (
    0 => 'ref.dbase.php',
    1 => 'Funciones dBase',
  ),
  'prev' => 
  array (
    0 => 'function.dbase-close.php',
    1 => 'dbase_close',
  ),
  'next' => 
  array (
    0 => 'function.dbase-delete-record.php',
    1 => 'dbase_delete_record',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/dbase/functions/dbase-create.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.dbase-create" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">dbase_create</h1>
  <p class="verinfo">(PHP 5 &lt; 5.3.0, dbase 5, dbase 7)</p><p class="refpurpose"><span class="refname">dbase_create</span> &mdash; <span class="dc-title">Crea una base de datos dBase</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.dbase-create-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>dbase_create</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$path</code></span>, <span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$fields</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$type</code><span class="initializer"> = DBASE_TYPE_DBASE</span></span>): <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>dbase_create()</strong></span> crea una base de
   datos dBase con la definición proporcionada.
   Si el fichero ya existe, no se trunca.
   <span class="function"><a href="function.dbase-pack.php" class="function">dbase_pack()</a></span> puede ser llamado para forzar una troncación.
  </p>
  <blockquote class="note"><p><strong class="note">Nota</strong>: <p class="para">Esta función es afectada por
    la directiva de configuración <a href="ini.core.php#ini.open-basedir" class="link">open_basedir</a>.</p></p></blockquote>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.dbase-create-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">path</code></dt>
     <dd>
      <p class="para">
       La ruta de acceso a la base de datos. Puede ser una ruta relativa o absoluta
       al fichero donde dBase almacenará sus datos.
      </p>
     </dd>
    
    
     <dt><code class="parameter">fields</code></dt>
     <dd>
      <p class="para">
       Un array de arrays, cada array describe el formato de un campo de la
       base de datos. Cada campo está compuesto por un nombre, un carácter
       que indica el tipo de campo y opcionalmente, una longitud, una precisión
       y un flag nullable.
       Los campos soportados se enumeran en la
       <a href="book.dbase.php#intro.dbase" class="link">sección de introducción</a>.
      </p>
      <blockquote class="note"><p><strong class="note">Nota</strong>: 
       <p class="para">
        Los nombres de los campos están limitados en longitud y no deben
        exceder los 10 caracteres.
       </p>
      </p></blockquote>
     </dd>
    
    
     <dt><code class="parameter">type</code></dt>
     <dd>
      <p class="para">
       El tipo de base de datos a crear. Puede ser
       <strong><code><a href="dbase.constants.php#constant.dbase-type-dbase">DBASE_TYPE_DBASE</a></code></strong> o
       <strong><code><a href="dbase.constants.php#constant.dbase-type-foxpro">DBASE_TYPE_FOXPRO</a></code></strong>.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.dbase-create-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Devuelve un recurso de base de datos si la base de datos
   ha sido creada con éxito, o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.dbase-create-changelog">
  <h3 class="title">Historial de cambios</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versión</th>
      <th>Descripción</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>PECL dbase 7.0.0</td>
      <td>
       El parámetro <code class="parameter">type</code> ha sido añadido.
      </td>
     </tr>

     <tr>
      <td>PECL dbase 7.0.0</td>
      <td>
       <code class="parameter">dbase_identifier</code> es ahora un <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span>
       en lugar de un <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 examples" id="refsect1-function.dbase-create-examples">
  <h3 class="title">Ejemplos</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Ejemplo #1 Creación de un fichero de base de datos dBase</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">// Definición de la base de datos<br /></span><span style="color: #0000BB">$def </span><span style="color: #007700">= array(<br />  array(</span><span style="color: #DD0000">"date"</span><span style="color: #007700">,     </span><span style="color: #DD0000">"D"</span><span style="color: #007700">),<br />  array(</span><span style="color: #DD0000">"name"</span><span style="color: #007700">,     </span><span style="color: #DD0000">"C"</span><span style="color: #007700">,  </span><span style="color: #0000BB">50</span><span style="color: #007700">),<br />  array(</span><span style="color: #DD0000">"age"</span><span style="color: #007700">,      </span><span style="color: #DD0000">"N"</span><span style="color: #007700">,   </span><span style="color: #0000BB">3</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">),<br />  array(</span><span style="color: #DD0000">"email"</span><span style="color: #007700">,    </span><span style="color: #DD0000">"C"</span><span style="color: #007700">, </span><span style="color: #0000BB">128</span><span style="color: #007700">),<br />  array(</span><span style="color: #DD0000">"ismember"</span><span style="color: #007700">, </span><span style="color: #DD0000">"L"</span><span style="color: #007700">)<br />);<br /><br /></span><span style="color: #FF8000">// Creación<br /></span><span style="color: #007700">if (!</span><span style="color: #0000BB">dbase_create</span><span style="color: #007700">(</span><span style="color: #DD0000">'/tmp/test.dbf'</span><span style="color: #007700">, </span><span style="color: #0000BB">$def</span><span style="color: #007700">)) {<br />  echo </span><span style="color: #DD0000">"Error, imposible crear la base de datos\n"</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div>

 <div class="refsect1 seealso" id="refsect1-function.dbase-create-seealso">
  <h3 class="title">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.dbase-open.php" class="function" rel="rdfs-seeAlso">dbase_open()</a> - Abre una base dBase</span></li>
    <li><span class="function"><a href="function.dbase-close.php" class="function" rel="rdfs-seeAlso">dbase_close()</a> - Cierra una base dBase</span></li>
   </ul>
  </p>
 </div>

</div><?php manual_footer($setup); ?>