file.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: fernando Status: working -->
  <!-- CREDITS: cortesi -->
  <refentry xml:id="function.file" xmlns="http://docbook.org/ns/docbook">
   <refnamediv>
    <refname>file</refname> 
    <refpurpose>Legge l'intero file in un vettore</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>array</type><methodname>file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam>
      <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Identica a <function>readfile</function>, eccetto per il fatto che
     <function>file</function> restituisce il file in un vettore. Ogni
     elemento del vettore corrisponde ad una riga del file, con il carattere di
     newline ancora inserito. Se la funzione non riesce restituisce 
     &false;.
    </para>
    <para>
     Puoi impostare il secondo parametro, <parameter>use_include_path</parameter>, (opzionale) ad "1",
     se vuoi cercare il file nel <link
     linkend="ini.include-path">include_path</link>.
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
<?php
// inserisce una pagina web in un array e la stampa. In questo esempio useremo il protocollo
// HTTP per ottenere il sorgente di un URL
$lines = file('http://www.example.com/');
// Ciclo attraverso l'array, si visualizzerà il sorgente come html ed i numeri di linea
foreach($lines as $line_num => $line) {
    echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}

// Un'altro esempio, inserisce la pagina web in una stringa. Vedere anche  file_get_contents().
$html = implode('', file ('http://www.example.com/'));
?>
]]>
      </programlisting>
     </informalexample>
    </para>
&tip.fopen-wrapper;
    <note>
     <para>
      Ciascuna riga dell'array restituito conterrà il carattere di fine riga, occorre, pertanto,
      utilizzare <function>rtrim</function> se si desidera rimuovere il carattere
      di fine riga.
     </para>
    </note>
    &note.line-endings;
    <note>
     <para>
      A partire da PHP 4.3.0 si può utilizzare <function>file_get_contents</function> per 
      memorizzare il contenuto di un file in una stringa in formato binario.
     </para>
    </note>
    &note.context-support;
     &warn.ssl-non-standard;
     <para> 
     Vedere anche <function>readfile</function>,
     <function>fopen</function>, <function>fsockopen</function>,
     <function>popen</function>, <function>file_get_contents</function> e
     <function>include</function>.
    </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
-->