<?xml version="1.0" encoding="utf-8"?>

<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">

</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>