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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 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 fournit.
   Si le fichier existe déjà, il n'est pas tronqué.
   <function>dbase_pack</function> peut être appellé 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 vos 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.
       Las champs supportés sont énumérer 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ée à 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>dbase 7.0.0</entry>
      <entry>
       Le paramètre <parameter>type</parameter> a été ajouté.
      </entry>
     </row>
     <row>
      <entry>dbase 7.0.0</entry>
      <entry>
       <parameter>dbase_identifier</parameter> is now a <type>resource</type>
       instead of an <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
-->