archived-doc-es/reference/dbase/functions/dbase-create.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0545e305cf06937b14b3f0694d6e716c9881ffd7 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->

<refentry xml:id="function.dbase-create" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>dbase_create</refname>
  <refpurpose>Crea una base de datos dBase</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>dbase_create</methodname>
   <methodparam><type>string</type><parameter>path</parameter></methodparam>
   <methodparam><type>array</type><parameter>fields</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>type</parameter><initializer>DBASE_TYPE_DBASE</initializer></methodparam>
  </methodsynopsis>
  <para>
   <function>dbase_create</function> crea una base de
   datos dBase con la definición proporcionada.
   Si el fichero ya existe, no se trunca.
   <function>dbase_pack</function> puede ser llamado para forzar una troncación.
  </para>
  &note.open-basedir.func;
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>path</parameter></term>
     <listitem>
      <para>
       La ruta de acceso a la base de datos. Puede ser una ruta relativa o absoluta
       al fichero donde dBase almacenará sus datos.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>fields</parameter></term>
     <listitem>
      <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
       <link linkend="intro.dbase">sección de introducción</link>.
      </para>
      <note>
       <para>
        Los nombres de los campos están limitados en longitud y no deben
        exceder los 10 caracteres.
       </para>
      </note>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>type</parameter></term>
     <listitem>
      <para>
       El tipo de base de datos a crear. Puede ser
       <constant>DBASE_TYPE_DBASE</constant> o
       <constant>DBASE_TYPE_FOXPRO</constant>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve un recurso de base de datos si la base de datos
   ha sido creada con éxito, o &false; si ocurre un error.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>PECL dbase 7.0.0</entry>
      <entry>
       El parámetro <parameter>type</parameter> ha sido añadido.
      </entry>
     </row>
     <row>
      <entry>PECL dbase 7.0.0</entry>
      <entry>
       <parameter>dbase_identifier</parameter> es ahora un <type>resource</type>
       en lugar de un <type>int</type>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Creación de un fichero de base de datos dBase</title>
    <programlisting role="php">
<![CDATA[
<?php

// Definición de la base de datos
$def = array(
  array("date",     "D"),
  array("name",     "C",  50),
  array("age",      "N",   3, 0),
  array("email",    "C", 128),
  array("ismember", "L")
);

// Creación
if (!dbase_create('/tmp/test.dbf', $def)) {
  echo "Error, imposible crear la base de datos\n";
}

?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>dbase_open</function></member>
    <member><function>dbase_close</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->