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

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

<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">
<![CDATA[
<?php
                   
// Base de données "definition"
$def = array(
  array("date",     "D"),
  array("name",     "C",  50),
  array("age",      "N",   3, 0),
  array("email",    "C", 128),
  array("ismember", "L")
);
                   
// Création
if (!dbase_create('/tmp/test.dbf', $def)) {
  echo "Erreur, impossible de créer la base de données\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
-->