[PHP-DOC] cvs: phpdoc /it/functions bzip2.xml

[Marco Cucinato]

cucinato                Sun Nov  4 05:26:53 2001 EDT

  Modified files:              
    /phpdoc/it/functions        bzip2.xml 
  Log:
  Italian translation ready
  
  
Index: phpdoc/it/functions/bzip2.xml
diff -u phpdoc/it/functions/bzip2.xml:1.1 phpdoc/it/functions/bzip2.xml:1.2
--- phpdoc/it/functions/bzip2.xml:1.1   Wed Oct 24 11:13:09 2001
+++ phpdoc/it/functions/bzip2.xml       Sun Nov  4 05:26:53 2001
@@ -1,5 +1,5 @@
 <?xml encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.10 Maintainer: cucinato  Status: working -->
+<!-- EN-Revision: 1.10 Maintainer: cucinato  Status: ready -->
  <reference id="ref.bzip2">
   <title>Funzioni di compressione Bzip2</title>
   <titleabbrev>Bzip2</titleabbrev>
@@ -60,10 +60,10 @@
   <refentry id="function.bzclose">
    <refnamediv>
     <refname>bzclose</refname>
-    <refpurpose>Close a bzip2 file pointer</refpurpose>
+    <refpurpose>Chiude un puntatore a un file bzip2</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>bzclose</function></funcdef>
@@ -71,17 +71,17 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     Closes the bzip2 file referenced by the pointer <parameter>bz</parameter>.
+     Chiude il file bzip2 referenziato dal puntatore <parameter>bz</parameter>.
     </para>
     <para>
-     Returns &true; on success and &false; on failure.
+     Restituisce &true; in caso di successo, &false; altrimenti.
     </para>
     <para>
-     The file pointer must be valid, and must point to a file
-     successfully opened by <function>bzopen</function>.
+     Il puntatore al file deve essere valido, e deve puntare a un file
+     gi$agrave; aperto con <function>bzopen</function>.
     </para>
     <para>
-     See also <function>bzopen</function>.
+     Vedere anche <function>bzopen</function>.
     </para>
    </refsect1>
   </refentry>
@@ -90,16 +90,16 @@
   <refentry id="function.bzcompress">
    <refnamediv>
     <refname>bzcompress</refname>
-    <refpurpose>Compress a string into bzip2 encoded data</refpurpose>
+    <refpurpose>Comprime una stringa nel formato bzip2</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>string <function>bzcompress</function></funcdef>
-      <paramdef>string <parameter>source</parameter></paramdef>
+      <paramdef>string <parameter>sorgente</parameter></paramdef>
       <paramdef>int
-       <parameter><optional>blocksize</optional></parameter>
+       <parameter><optional>dimblocco</optional></parameter>
       </paramdef>
       <paramdef>int 
        <parameter><optional>workfactor</optional></parameter>
@@ -107,30 +107,30 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>bzcompress</function> compresses the
-     <parameter>source</parameter> string and returns it as bzip2
-     encoded data.
+     <function>bzcompress</function> comprime la 
+     stringa <parameter>sorgente</parameter> e la restituisce come dati
+     codificati in bzip2.
     </para>
     <para>
-     The optional parameter <parameter>blocksize</parameter> specifies
-     the blocksize used during compression and should be a number from
-     1 to 9 with 9 giving the best compression, but using more
-     resources to do so. <parameter>blocksize</parameter> defaults to
+     Il parametro opzionale <parameter>dimblocco</parameter> specifica
+     la dimensione del blocco usato durante la compressione e dovrebbe essere un 
+numero tra
+     1 e 9 dove 9 d&agrave; la compressione migliore, ma usando pi&ugrave;
+     risorse. <parameter>dimblocco</parameter> ha come valore predefinito
      4.
     </para>
     <para>
-     The optional parameter <parameter>workfactor</parameter> controls
-     how the compression phase behaves when presented with worst case,
-     highly repetitive, input data.  The value can be between 0 and
-     250 with 0 being a special case and 30 being the default
-     value. Regardless of the <parameter>workfactor</parameter>, the
-     generated output is the same.
+     Il parametro opzionale <parameter>workfactor</parameter> controlla
+     il comportamento della fase di compressione quando deve trattare col caso 
+peggiore,
+     ovvero dati in ingresso molto ripetitivi. Il valore pu&ograve; variare tra 0 e
+     250, dove 0 &egrave; un caso speciale e 30 egrave; il valore di
+     default. Indipendentemente dal parametro <parameter>workfactor</parameter>, i
+     dat generati sono gli stessi.
     </para>
     <para>
      <example>
-      <title><function>bzcompress</function> Example</title>
+      <title>Esempio di <function>bzcompress</function></title>
       <programlisting role="php">&lt;?php
-$str = "sample data";
+$str = "dati di prova";
 $bzstr = bzcompress($str, 9);
 print( $bzstr );
 ?>
@@ -147,42 +147,42 @@
   <refentry id="function.bzdecompress">
    <refnamediv>
     <refname>bzdecompress</refname>
-    <refpurpose>Decompresses bzip2 encoded data</refpurpose>
+    <refpurpose>Decomprime dati codificati con bzip2</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>string <function>bzdecompress</function></funcdef>
-      <paramdef>string <parameter>source</parameter></paramdef>
+      <paramdef>string <parameter>sorgente</parameter></paramdef>
       <paramdef>int
        <parameter><optional>small</optional></parameter>
       </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>bzdecompress</function> decompresses the
-     <parameter>source</parameter> string containing bzip2 encoded
-     data and returns it.  If the optional parameter
-     <parameter>small</parameter> is &true;, an alternative
-     decompression algorithm will be used which uses less memory (the
-     maximum memory requirement drops to around 2300K) but works at
-     roughly half the speed.  See the <ulink url="&url.bzip2;">bzip2
-     documentation</ulink> for more information about this feature.
+     <function>bzdecompress</function> decomprime la
+     strina <parameter>sorgente</parameter> contenente dati codificati in bzip2
+     e li restituisce.  Se il parametro opzionale
+     <parameter>small</parameter> &egrave; &true;, verr&agrave; usato un
+     algoritmo di decompressione alternativo che richiede meno memoria (la
+     maximum quantit&agrave; massima di meoria richiesta scende a 2300K) ma funziona a
+     circa la met&agrave; della velocit&agrave;.  Vedere la <ulink 
+url="&url.bzip2;">documentazione di
+     bzip2</ulink> per maggiori informazioni su questa funzionalit&agrave;.
     </para>
     <para>
      <example>
       <title><function>bzdecompress</function></title>
       <programlisting role="php">&lt;?php
-$start_str = "This is not an honest face?";
+$stringa_iniziale = "Sto facendo il mio lavoro?";
 $bzstr = bzcompress($start_str);
 
-print( "Compressed String: " );
+print( "Stirnga Compressa: " );
 print( $bzstr );
 print( "\n&lt;br&gt;n" );
 
-$str = bzdecompress($bzstr);
-print( "Decompressed String: " );
+$stringa = bzdecompress($bzstr);
+print( "Stringa Decompressa: " );
 print( $str );
 print( "\n&lt;br&gt;n" );
 ?>
@@ -199,10 +199,10 @@
   <refentry id="function.bzerrno">
    <refnamediv>
     <refname>bzerrno</refname>
-    <refpurpose>Returns a bzip2 error number</refpurpose>
+    <refpurpose>Restituisce il codice d'errore bzip2</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>bzerrno</function></funcdef>
@@ -210,11 +210,11 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     Returns the error number of any bzip2 error returned by the file
-     pointer <parameter>bz</parameter>.
+     Restituisce il codice di un qualsiasi errore bzip2 restituito dal 
+     puntatore al file <parameter>bz</parameter>.
     </para>
     <para>
-     See also <function>bzerror</function> and <function>bzerrstr</function>.
+     Vedere anche <function>bzerror</function> e <function>bzerrstr</function>.
     </para>
    </refsect1>
   </refentry>
@@ -223,10 +223,10 @@
   <refentry id="function.bzerror">
    <refnamediv>
     <refname>bzerror</refname>
-    <refpurpose>Returns the bzip2 error number and error string in an 
array</refpurpose>
+    <refpurpose>Restituisce il codice d'errore bzip2 e la stringa corrispondente in 
+un array</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>array <function>bzerror</function></funcdef>
@@ -234,24 +234,24 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     Returns the error number and error string, in an associative array,
-     of any bzip2 error returned by the file pointer
+     Restituisce il codice e la stringa di errore, sotto forma di array associativo,
+     di un errore bzip2 restituito dal puntatore 
      <parameter>bz</parameter>.
     </para>
     <para>
      <example>
-      <title><function>bzerror</function> Example</title>
+      <title>Esempio di <function>bzerror</function></title>
       <programlisting role="php">&lt;?php
-$error = bzerror($bz);
+$errore = bzerror($bz);
 
-echo $error["errno"];
-echo $error["errstr"];
+echo $errore["errno"];
+echo $errore["errstr"];
 ?>
       </programlisting>
      </example>
     </para>
     <para>
-     See also <function>bzerrno</function> and <function>bzerrstr</function>.
+     Vedere anche <function>bzerrno</function> e <function>bzerrstr</function>.
     </para>
    </refsect1>
   </refentry>
@@ -260,10 +260,10 @@
   <refentry id="function.bzerrstr">
    <refnamediv>
     <refname>bzerrstr</refname>
-    <refpurpose>Returns a bzip2 error string</refpurpose>
+    <refpurpose>restituisce la stringa di errore bzip2</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>string <function>bzerrstr</function></funcdef>
@@ -271,11 +271,11 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     Returns the error string of any bzip2 error returned by the file
-     pointer <parameter>bz</parameter>.
+     Resituisce la stringa di errore bzip2 restituito dal
+     puntatore <parameter>bz</parameter>.
     </para>
     <para>
-     See also <function>bzerrno</function> and <function>bzerror</function>.
+     Vedere anche <function>bzerrno</function> e <function>bzerror</function>.
     </para>
    </refsect1>
   </refentry>
@@ -284,10 +284,10 @@
   <refentry id="function.bzflush">
    <refnamediv>
     <refname>bzflush</refname>
-    <refpurpose>Force a write of all buffered data</refpurpose>
+    <refpurpose>Forza la scrittura di tutti i dati nel buffer</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>bzflush</function></funcdef>
@@ -295,14 +295,14 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     Forces a write of all buffered bzip2 data for the file pointer
+     Forza la scrittura di tutti i dati che sono nel buffer del puntatore
      <parameter>bz</parameter>.
     </para>
     <para>
-     Returns &true; on success, &false; on failure.
+     Restituisce &true; in caso di successo, &false; altrimenti.
     </para>
     <para>
-     See also <function>bzread</function> and <function>bzwrite</function>.
+     Vedere anche <function>bzread</function> e <function>bzwrite</function>.
     </para>
    </refsect1>
   </refentry>
@@ -311,44 +311,44 @@
   <refentry id="function.bzopen">
    <refnamediv>
     <refname>bzopen</refname>
-    <refpurpose>Open a bzip2 compressed file</refpurpose>
+    <refpurpose>Apre un file compresso bzip2</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>bzopen</function></funcdef>
-      <paramdef>string <parameter>filename</parameter></paramdef>
-      <paramdef>string <parameter>mode</parameter></paramdef>
+      <paramdef>string <parameter>nomefile</parameter></paramdef>
+      <paramdef>string <parameter>modo</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
-     Opens a bzip2 (.bz2) file for reading or writing.
-     <parameter>filename</parameter> is the name of the file to
-     open. <parameter>mode</parameter> is similar to the
-     <function>fopen</function> function (`r' for read, `w' for write, etc.).
+     Apre un file bzip2 (.bz2) in lettura o scrittura.
+     <parameter>nomefile</parameter> &egrave; il nome del file da
+     aprire. Il parametro <parameter>modo</parameter> egrave; simile a quello
+     della funzione <function>fopen</function> (`r' per lettura, `w' per scrittura, 
+ecc.).
     </para>
     <para>
-     If the open fails, the function returns &false;, otherwise it
-     returns a pointer to the newly opened file.
+     Se l'operazione fallisce, la funzione restituisce &false;, altrimenti
+     restituisce un puntatore al file appena aperto.
     </para>
     <para>
      <example>
-      <title><function>bzopen</function> Example</title>
+      <title>Esempio di<function>bzopen</function></title>
       <programlisting role="php">&lt;?php
 $bz = bzopen("/tmp/foo.bz2", "r");
-$decompressed_file = bzread($bz, filesize("/tmp/foo.bz2"));
+$file_decompresso = bzread($bz, filesize("/tmp/foo.bz2"));
 bzclose($bz);
 
-print( "The contents of /tmp/foo.bz2 are: " );
+print( "Il contenuto di /tmp/foo.bz2 &egrave;: " );
 print( "\n&lt;br&gt;n" );
-print( $decompressed_file );
+print( $file_decompresso );
 ?>
       </programlisting>
      </example>
     </para>
     <para>
-     See also <function>bzclose</function>.
+     Vedere anche <function>bzclose</function>.
     </para>
    </refsect1>
   </refentry>
@@ -357,32 +357,32 @@
   <refentry id="function.bzread">
    <refnamediv>
     <refname>bzread</refname>
-    <refpurpose>Binary safe bzip2 file read</refpurpose>
+    <refpurpose>Esegue la lettura binaria di un file bzip2</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>string <function>bzread</function></funcdef>
       <paramdef>int <parameter>bz</parameter></paramdef>
       <paramdef>int 
-       <parameter><optional>length</optional></parameter>
+       <parameter><optional>lunghezza</optional></parameter>
       </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>bzread</function> reads up to
-     <parameter>length</parameter> bytes from the bzip2 file pointer
-     referenced by <parameter>bz</parameter>.  Reading stops when
-     <parameter>length</parameter> (uncompressed) bytes have been read
-     or EOF is reached, whichever comes first.  If the optional
-     parameter <parameter>length</parameter> is not specified,
-     <function>bzread</function> will read 1024 (uncompressed) bytes
-     at a time.
+     <function>bzread</function> legge fino a 
+     <parameter>lunghezza</parameter> byte dal puntatore bzip2
+     specificato da <parameter>bz</parameter>.  La pettura termina quando
+     <parameter>lunghezza</parameter> byte (decompressi) sono stati letti
+     o quando viene raggiunto l'EOF.  Se il parametro
+     opzionale <parameter>lunghezza</parameter> &egrave; omesso,
+     <function>bzread</function> legger&agrave; 1024 byte (decompressi)
+     ogni volta.
     </para>
     <para>
      <example>
-      <title><function>bzread</function> Example</title>
+      <title>Esempio di <function>bzread</function></title>
       <programlisting role="php">&lt;?php
 $bz = bzopen("/tmp/foo.bz2", "r");
 $str = bzread($bz, 2048);
@@ -392,7 +392,7 @@
      </example>
     </para>
     <para>
-     See also <function>bzwrite</function> and <function>bzopen</function>.
+     Vedere anche <function>bzwrite</function> e <function>bzopen</function>.
     </para>
    </refsect1>
   </refentry>
@@ -401,33 +401,33 @@
   <refentry id="function.bzwrite">
    <refnamediv>
     <refname>bzwrite</refname>
-    <refpurpose>Binary safe bzip2 file write</refpurpose>
+    <refpurpose>Esegue la scrittura binaria di un file bzip2</refpurpose>
    </refnamediv>
    <refsect1>
-    <title>Description</title>
+    <title>Descrizione</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>bzwrite</function></funcdef>
       <paramdef>int <parameter>bz</parameter></paramdef>
-      <paramdef>string <parameter>data</parameter></paramdef>
+      <paramdef>string <parameter>dati</parameter></paramdef>
       <paramdef>int
-       <parameter><optional>length</optional></parameter>
+       <parameter><optional>lunghezza</optional></parameter>
       </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>bzwrite</function> writes the contents of the string
-     <parameter>data</parameter> to the bzip2 file stream pointed to
-     by <parameter>bz</parameter>. If the optional
-     <parameter>length</parameter> argument is given, writing will stop
-     after length (uncompressed) bytes have been written or the end of
-     string is reached, whichever comes first.
+     <function>bzwrite</function> scrie il contenuto della stringa
+     <parameter>dati</parameter> nel file bzip2 puntato
+     da <parameter>bz</parameter>. Se il parametro
+     opzionale <parameter>lunghezza</parameter> &egrave; specificato, la scrittura si 
+fermer&agrave;
+     dopo che siano stati scritti <parameter>lunghezza</parameter> byte (decompressi) 
+ o al raggiungimento
+     della fine della stringa.
     </para>
     <para>
      <example>
-      <title><function>bzwrite</function> Example</title>
+      <title>Esempio di <function>bzwrite</function></title>
       <programlisting role="php">&lt;?php
-$str = "uncompressed data";
+$str = "dati non compressi";
 $bz = bzopen("/tmp/foo.bz2", "w");
 bzwrite($bz, $str, strlen($str));
 bzclose($bz);
@@ -436,7 +436,7 @@
      </example>
     </para>
     <para>
-     See also <function>bzread</function> and <function>bzopen</function>.
+     Vedere anche <function>bzread</function> e <function>bzopen</function>.
     </para>
    </refsect1>
   </refentry>