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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0545e305cf06937b14b3f0694d6e716c9881ffd7 Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.dbase-create" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>dbase_create</refname>
  <refpurpose>Erzeugt eine Datenbank</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>
   Erzeugt eine der angegebenen Definition entsprechende dBase-Datenbank.
   Existiert die Datei bereits, wird sie nicht gekürzt.
   <function>dbase_pack</function> kann aufgerufen werden, um die Kürzung zu
   erzwingen.
  </para>
  &note.open-basedir.func;
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>path</parameter></term>
     <listitem>
      <para>
       Der Pfad der Datenbank. Das kann ein relativer oder absoluter Pfad zu
       der Datei sein, in der dBase die Daten speichert.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>fields</parameter></term>
     <listitem>
      <para>
       Ein Array aus Arrays, von denen jedes das Format eines Datenbankfeldes
       beschreibt. Jedes Feld besteht aus einem Namen, einem Zeichen für den
       Feldtyp und gegebenenfalls einer Länge, einer Genauigkeit und einem
       nullable-Flag. Die unterstützten Feldtypen sind im <link
       linkend="intro.dbase">Einführungsabschnitt</link> aufgeführt.
      </para>
      <note>
       <para>
        Die Feldnamen sind längenbeschränkt, und dürfen 10 Zeichen nicht
        überschreiten.
       </para>
      </note>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>type</parameter></term>
     <listitem>
      <para>
       Der zu erzeugende Datenbanktype. Entweder
       <constant>DBASE_TYPE_DBASE</constant> oder
       <constant>DBASE_TYPE_FOXPRO</constant>.
      </para>
     </listitem>
    </varlistentry>
    </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Gibt eine Datenbank-Ressource zurück, falls die Datenbank erfolgreich
   erzeugt werden konnte oder &false;, falls ein Fehler auftrat.
  </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>
       Der Parameter <parameter>type</parameter> wurde hinzugefügt.
      </entry>
     </row>
     <row>
      <entry>PECL dbase 7.0.0</entry>
      <entry>
       Der Rückgabewert ist nun vom Typ <type>resource</type> statt
       <type>int</type>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Erzeugen einer dBase-Datenbankdatei</title>
    <programlisting role="php">
<![CDATA[
<?php

// Datenbank-"Definition"
$def = array(
  array("Datum",       "D"),
  array("Name",        "C",  50),
  array("Alter",       "N",   3, 0),
  array("Email",       "C", 128),
  array("IstMitglied", "L")
);

// Erzeugung
if (!dbase_create('/tmp/test.dbf', $def)) {
  echo "Fehler, konnte die Datenbank nicht erzeugen\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
-->