<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.16 Maintainer: acsontos Status: ready  -->

 <reference id="ref.bzip2">
  <title>Bzip2 tmrtsi fggvnyek</title>
  <titleabbrev>Bzip2</titleabbrev>
  <partintro>
   <para>
    Ez a modul a <ulink
    url="&url.bzip2;">bzip2</ulink>knyvtr fggvnyeit hasznlja,
    a bzip2 (.bz2) tmrtsi eljrssal tmrtett llomnyokat s a bennk lev fjlokat rja-olvassa.
    A bzip promgamknytrait Julian Seward rta.
   </para>
   <para>
    A bzip2 tmogats nincs alapllapotban bekapcsolva a PHP-ben.
    Fordtskor alkalmazd a <link linkend="install.configure.with-bz2">--with-bz2</link> kapcsolt,
    ha hasznlni akarod a bzip2 fggvnyeket. Szksg van tovbb
    a bzip2/libbzip2 knyvtrak &gt;= 1.0.x. verzijra is.
   </para>

   <sect1 id="bzip2-example">
    <title>Rvid plda</title>
    <para>
     A kvetkez pldaprogram megnyit egy prbafjlt, beler egy rvid szveget,
     majd kirja a fjl tartalmt.
    </para>
    <example>
     <title>Rvid bzip2 plda</title>
     <programlisting role="php">
<![CDATA[
<?php

$filename = "/tmp/testfile.bz2";
$str = "Ez egy prbaszvegecske.\n";

// megnyits rsra - "w" kapcsol hasznlatval
$bz = bzopen($filename, "w");

// belerja a prbaszveget a fjlba
bzwrite($bz, $str);

// bezrja a fjlot
bzclose($bz);

// jra megnyitja, de most olvassra - "r" kapcsolt hasznl
$bz = bzopen($filename, "r");

// beolvas 10 karaktert a fjlbl
print bzread($bz, 10);

// A fjl vgig (vagy a kvetkez 1024 karakterig) kirja a tartalmt, majd bezrja a fjlt
print bzread($bz);

bzclose($bz);

?>
]]>
     </programlisting>
    </example>
   </sect1>
  </partintro>


  <refentry id="function.bzclose">
   <refnamediv>
    <refname>bzclose</refname>
    <refpurpose>Bezr egy bzip2 fjl mutatt</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>int</type><methodname>bzclose</methodname>
      <methodparam><type>int</type><parameter>bz</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bezr egy bzip2 fjlot, amire a <parameter>bz</parameter> fjl mutatval (file pointer) utaltunk.
	 (A fjl mutat megrtst megknnytheti az els, "rvid bzip2 plda" hetedik sora.)
    </para>
    <para>
     &true; rtkkel tr vissza ha sikerl, egybknt &false;-szal.
    </para>
    <para>
     A fjl mutatnak egy ltez s  <function>bzopen</function> fggvnnyel
	 sikeresen megnyitott fjlra kell mutatnia.
    </para>
    <para>
     Lsd mg: <function>bzopen</function>!
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzcompress">
   <refnamediv>
    <refname>bzcompress</refname>
    <refpurpose>bzip2 algoritmus szerint tmrt egy jelsorozatot</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>string</type><methodname>bzcompress</methodname>
      <methodparam><type>string</type><parameter>source</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>blocksize</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>workfactor</parameter></methodparam>
     </methodsynopsis>
    <para>
     A <function>bzcompress</function> fggvny tmrti a
     <parameter>source</parameter> paramterben megadott forrsfjlt s visszatr ennek
     bzip2-ben tmrtett vltozatval.
    </para>
    <para>
     Az elhagyhat <parameter>blocksize</parameter> paramterrel
     meghatrozhatjuk a tmrtshez hasznlt blokkmretet, 1 s 9 kztt.
     A 9 adja a legjobb tmrtst, de ez a leginkbb erforrs-ignyesebb is.
     A <parameter>blocksize</parameter> paramter alprtelmezett rtke:
     4.
    </para>
    <para>
     A szintn elhagyhat <parameter>workfactor</parameter> paramter a tmrtsi
     fzisok viselkedst befolysolja, hogyan viselkedjenek a legrosszabb esetben,
     vagyis amikor temrdek ismtld adat kveti egymst.  Az rtke 0 s 250 kztt lehet,
     a 250 s a 0 klnleges esetekben hasznlatos, mg a 30 az alaprtelmezett rtk.
     A <parameter>workfactor</parameter> paramtertl fggetlnel, a generlt kimenet
     ugyanaz lesz.
    </para>
    <para>
     <example>
      <title><function>bzcompress</function> Plda</title>
      <programlisting role="php">
<![CDATA[
<?php
$str = "minta adat";
$bzstr = bzcompress($str, 9);
print( $bzstr );
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Lsd mg: <function>bzdecompress</function>!
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzdecompress">
   <refnamediv>
    <refname>bzdecompress</refname>
    <refpurpose>Kitcsomagol bzip2 tmrtett adatokat</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>string</type><methodname>bzdecompress</methodname>
      <methodparam><type>string</type><parameter>source</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>small</parameter></methodparam>
     </methodsynopsis>
    <para>
     A <function>bzdecompress</function> kitmrti
      <parameter>source</parameter>paramterben megadott, bzip2 tmrtett  adatot.
	 Ha a <parameter>small</parameter> elhagyhat paramter &true; (logikai IGAZ),
     akkor egy alternatv kicsomagol algoritmust fog hasznlni, ami ugyan kevesebb
     memrit fogyaszt - a maximlis memriaszksglet kb. 2300K-ra cskken -, de
     durvn feleakkora sebessggel fut. Nzd meg a <ulink url="&url.bzip2;">bzip2
     dokumentcit</ulink> a rszletesebb informcikrt e tmban.
    </para>
    <para>
     <example>
      <title><function>bzdecompress</function></title>
      <programlisting role="php">
<![CDATA[
<?php
$start_str = "Ht nem des pofa?";
$bzstr = bzcompress($start_str);

print( "A tmrtett szting: " );
print( $bzstr );
print( "\n<br>\n" );

$str = bzdecompress($bzstr);
print( "A kicsomagolt sztring: " );
print( $str );
print( "\n<br>\n" );
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Lsd mg: <function>bzcompress</function>!
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzerrno">
   <refnamediv>
    <refname>bzerrno</refname>
    <refpurpose>A bzip2 hiba szmval tr vissza</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>int</type><methodname>bzerrno</methodname>
      <methodparam><type>int</type><parameter>bz</parameter></methodparam>
     </methodsynopsis>
    <para>
     Brmilyen bzip2 mvelet sorn fellp hiba szmval tr vissza,
	 amit a <parameter>bz</parameter> fjl mutat (file pointer) szolgltat.
    </para>
    <para>
     Lsd mg: <function>bzerror</function> s<function>bzerrstr</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzerror">
   <refnamediv>
    <refname>bzerror</refname>
    <refpurpose>A bzip2 hiba szmt s a hibs sztringet egy tmbbe pakolva tr vissza.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>array</type><methodname>bzerror</methodname>
      <methodparam><type>int</type><parameter>bz</parameter></methodparam>
     </methodsynopsis>
    <para>
     Egy asszociatv tmbbe teszi a bzip2 mvelet sorn fellpett hibkat s a hozzjuk tartoz hibs sztringeket,
     amiket a <parameter>bz</parameter> fjl mutattl (file pointer) vesz t .
    </para>
    <para>
     <example>
      <title><function>bzerror</function> Plda</title>
      <programlisting role="php">
<![CDATA[
<?php
$hiba = bzerror($bz);

echo $hiba["errno"];
echo $hiba["errstr"];
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Lsd mg <function>bzerrno</function> s <function>bzerrstr</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzerrstr">
   <refnamediv>
    <refname>bzerrstr</refname>
    <refpurpose>A bzip2 hibasztringgel tr vissza</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>string</type><methodname>bzerrstr</methodname>
      <methodparam><type>int</type><parameter>bz</parameter></methodparam>
     </methodsynopsis>
    <para>
     Egy bzip2 mvelet alatt fellp hiba hibzenetvel tr vissza,
     amit a <parameter>bz</parameter> fjl mutat (file pointer) ad t a fggvnynek.
    </para>
    <para>
     Lsd mg: <function>bzerrno</function> s <function>bzerror</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzflush">
   <refnamediv>
    <refname>bzflush</refname>
    <refpurpose>Kiknyszerti az sszes pufferelt adat rst</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>int</type><methodname>bzflush</methodname>
      <methodparam><type>int</type><parameter>bz</parameter></methodparam>
     </methodsynopsis>
    <para>
     Az sszes pufferelt bzip2 adat rst kiknyszerti
     a <parameter>bz</parameter> fjl mutat (file pointer) szmra.
    </para>
    <para>
     &return.success;
    </para>
    <para>
     Lsd mg:  <function>bzread</function> s <function>bzwrite</function>!
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzopen">
   <refnamediv>
    <refname>bzopen</refname>
    <refpurpose>Megnyit egy bzip2 tmrtett fjlt</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>int</type><methodname>bzopen</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>string</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Megnyit egy bzip2 (.bz2 kiterjeszts) fjlt olvassra vagy rsra.
     <parameter>filename</parameter> paramter a fjl neve, amit ki szeretnnk nyitni.
     A <parameter>mode</parameter> paramter hasonlan mkdik, mint a
     <function>fopen</function> fggvnynl (`r' - olvass, `w' - rs, stb.).
    </para>
    <para>
     Ha a mvelet sikertelen, akkor &false;-szal (logikai HAMIS), egybknt
     az jonnan megnyitott  fjlra mutatval (file pointer) tr vissza.
    </para>
    <para>
     <example>
      <title><function>bzopen</function> Plda</title>
      <programlisting role="php">
<![CDATA[
<?php
$bz = bzopen("/tmp/foo.bz2", "r");
$tmrtett_fjl = bzread($bz, filesize("/tmp/foo.bz2"));
bzclose($bz);

print( "me a /tmp/foo.bz2 tartalma: " );
print( "\n<br>\n" );
print( $tmrtett_fjl );
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
    Lsd mg: <function>bzclose</function>!
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzread">
   <refnamediv>
    <refname>bzread</refname>
    <refpurpose>Binris bzip2 fjlokat olvas</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>string</type><methodname>bzread</methodname>
      <methodparam><type>int</type><parameter>bz</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <para>
     A <function>bzread</function> fggvny beolvas <parameter>length</parameter>
     hosszsg bjtot a <parameter>bz</parameter> paramterben megadott bzip2
     fjl mutatbl (file pointer). Addig olvas, amg a <parameter>length</parameter>
     paramternek megfelel (tmrtetlen!) mennyisg bjtot beolvassa
     vagy a fjlvg-jelet (EOF) elri; mr amelyik elbb bekvetkezik.  Ha az
     elhagyhat <parameter>length</parameter> paramtert nem lltottuk be, akkor
     a <function>bzread</function> fggvny 1024 (tmrtetlen) bjtot olvas
     egyszerre.
    </para>
    <para>
     <example>
      <title><function>bzread</function> Plda</title>
      <programlisting role="php">
<![CDATA[
<?php
$bz = bzopen("/tmp/foo.bz2", "r");
$str = bzread($bz, 2048);
print( $str );
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Lsd mg: <function>bzwrite</function> s <function>bzopen</function>!
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzwrite">
   <refnamediv>
    <refname>bzwrite</refname>
    <refpurpose>Binris bzip2 fjlba r</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>int</type><methodname>bzwrite</methodname>
      <methodparam><type>int</type><parameter>bz</parameter></methodparam>
      <methodparam><type>string</type><parameter>data</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <para>
     A <function>bzwrite</function> fggvny a <parameter>data</parameter>
     paramterben megadott sztringet abba a bzip2 fjlba rja, amelyre a
     <parameter>bz</parameter> mutat. Ha az elhagyhat <parameter>length</parameter>
     paramtert megadtuk, akkor az rs befejezdik, miutn elrte a megadott
     (tmrtetlen) bjt hosszt ill. elrte a fjlvg-jelet (EOF),
     ha az hamarbb bekvetkezik.
    </para>
    <para>
     <example>
      <title><function>bzwrite</function> Plda </title>
      <programlisting role="php">
<![CDATA[
<?php
$str = "tmrtetlen adat";
$bz = bzopen("/tmp/foo.bz2", "w");
bzwrite($bz, $str, strlen($str));
bzclose($bz);
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Lsd mg: <function>bzread</function> s <function>bzopen</function>!
    </para>
   </refsect1>
  </refentry>


 </reference>

<!-- 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:"../../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
-->