<?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>Crée une base de données 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> crée une base de

données dBase avec la définition fournie.

Si le fichier existe déjà, il n'est pas tronqué.

<function>dbase_pack</function> peut être appelé pour forcer une troncature.

</para>

&note.open-basedir.func;

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>path</parameter></term>

<listitem>

<para>

Le chemin vers la base de données. Il peut être un chemin relatif ou absolu

vers le fichier où dBase stockera les données.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>fields</parameter></term>

<listitem>

<para>

Un tableau de tableaux, chaque tableau décrit le format d'un champ de la

base de données. Chaque champ est constitué d'un nom, d'un caractère

indiquant le type du champ et optionnellement, une longueur, une précision

et un drapeau nullable.

Les champs supportés sont énumérés dans la

<link linkend="intro.dbase">section d'introduction</link>.

</para>

<note>

<para>

Les noms des champs sont limités en longueur et ne doivent

pas excéder 10 caractères.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>type</parameter></term>

<listitem>

<para>

Le type de base de données à créer. Soit

<constant>DBASE_TYPE_DBASE</constant> ou

<constant>DBASE_TYPE_FOXPRO</constant>.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Retourne une ressource de base de données si la base de données

a été créée avec succès, ou &false; si une erreur survient.

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

Le paramètre <parameter>type</parameter> a été ajouté.

</entry>

</row>

<row>

<entry>PECL dbase 7.0.0</entry>

<entry>

Le type de retour de <parameter>dbase_identifier</parameter> est

désormais une <type>resource</type> au lieu d'un <type>int</type>.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Création d'un fichier de base de données 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>