dbase-get-header-info.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: fernando Status: ready -->
  <refentry xml:id="function.dbase-get-header-info" xmlns="http://docbook.org/ns/docbook">
   <refnamediv>
    <refname>dbase_get_header_info</refname>
    <refpurpose>Ottenere le informazioni di intestazione di un database dBase</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>array</type><methodname>dbase_get_header_info</methodname>
      <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce informazioni sulla struttura delle colonne del database referenziato da
     <parameter>dbase_identifier</parameter>. Per ogni colonna del database,
     esiste un valore specificato in un array ad indice numerico. L'indice dell'array inizia
     da 0. Ogni elemento dell'array contiene un array associativo di informazioni sulle colonne.
     Se l'informazione dell'header dell'array non può esssere letta, viene
     restituito, &false; .
    </para>
    <para>
     Gli elementi dell'array sono:
     <variablelist>
      <varlistentry>
       <term>
        nome
       </term>
       <listitem>
        <simpara>
         Il nome della colonna
        </simpara>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term>
        tipo
       </term>
       <listitem>
        <simpara>
         Il nome del tipo di colonna del dBase riconoscibile dall'utente (es. data,
         boolean, etc)
        </simpara>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term>
        lunghezza
       </term>
       <listitem>
        <simpara>
         Il numero di bytes che la colonna può contenere
        </simpara>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term>
        precisione
       </term>
       <listitem>
        <simpara>
         Il numero di cifre della precisione decimale della colonna
        </simpara>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term>
        formato
       </term>
       <listitem>
        <simpara>
         Un formato di <function>printf</function> suggerito, specifico per la colonna
        </simpara>
       </listitem>
      </varlistentry>

      <varlistentry>
       <term>
        offset (scostamento)
       </term>
       <listitem>
        <simpara>
         L'offest, in byte, della colonna dall'inizio riga
        </simpara>
       </listitem>
      </varlistentry>
     </variablelist>
    </para>
    <para>
     <example>
      <title>Mostra le informazioni dell'header di un file di database in formato dBase</title>
      <programlisting role="php">
<![CDATA[
<?php
// Path to dbase file
$db_path = "/tmp/test.dbf";

// Open dbase file
$dbh = dbase_open($db_path)
    or die("Errore! Il file di database dBase non può essere aperto '$db_path'.");

// Get column information
$column_info = dbase_get_header_info($dbh);

// Display information
print_r($column_info);
?>
]]>
      </programlisting>
     </example>
    </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
-->