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

[Gyozo Papp]

gerzson         Mon Jan 14 10:54:52 2002 EDT

  Added files:                 
    /phpdoc/hu/functions        bzip2.xml 
  Log:
  bzip2 translation ended and here comes
  


Index: phpdoc/hu/functions/bzip2.xml
+++ phpdoc/hu/functions/bzip2.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- $Revision: 1.1 $ -->
 <reference id="ref.bzip2">
  <title>Bzip2 t�m�r�t�si f�ggv�nyek</title>
  <titleabbrev>Bzip2</titleabbrev>
  <partintro>
   <para>
    Ez a modul a <ulink
    url="&url.bzip2;">bzip2</ulink>k�nyvt�r f�ggv�nyeit haszn�lja,
    a bzip2 (.bz2) t�m�r�t�si elj�r�ssal t�m�r�tett �llom�nyokat �s a benn�k lev� 
f�jlokat �rja-olvassa.
    A bzip promgamk�nyt�rait Julian Seward �rta.
   </para>
   <para>
    A bzip2 t�mogat�s nincs alap�llapotban bekapcsolva a PHP-ben. 
    Ford�t�skor alkalmazd a <link 
linkend="install.configure.with-bzip2">--with-bz2</link> kapcsol�t
    ha haszn�lni akarod a bzip2 f�ggv�nyeket. Sz�ks�g van tov�bb�
    a bzip2/libbzip2 k�nyvt�rak &gt;= 1.0.x. verzi�j�ra is.
   </para>

   <sect1 id="bzip2-example">
    <title>R�vid p�lda</title>
    <para>
     A k�vetkez� p�ldaprogram megnyit egy pr�baf�jlt, bele�r egy r�vid sz�veget,
     majd ki�rja a f�jl tartalm�t.
    </para>
    <example>
     <title>R�vid bzip2 p�lda</title>
     <programlisting role="php">
<![CDATA[
<?php

$filename = "/tmp/testfile.bz2";
$str = "Ez egy pr�basz�vegecske.\n";

// megnyit�s �r�sra - "w" kapcsol� haszn�lat�val
$bz = bzopen($filename, "w");

// bele�rja a pr�basz�veget a f�jlba
bzwrite($bz, $str);

// bez�rja a f�jlot
bzclose($bz);

// �jra megnyitja, de most olvas�sra - "r" kapcsol�t haszn�l
$bz = bzopen($filename, "r");

// beolvas 10 karaktert a f�jlb�l
print bzread($bz, 10);

// A f�jl v�g�ig (vagy a k�vetkez� 1024 karakterig) ki�rja a tartalm�t, majd bez�rja a 
f�jlt  
print bzread($bz);

bzclose($bz);

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


  <refentry id="function.bzclose">
   <refnamediv>
    <refname>bzclose</refname>
    <refpurpose>Bez�r egy bzip2 f�jl mutat�t</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>int <function>bzclose</function></funcdef>
      <paramdef>int <parameter>bz</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Bez�r egy bzip2 f�jlot, amire a <parameter>bz</parameter> f�jl mutat�val (file 
pointer) utaltunk.
         (A f�jl mutat� meg�rt�s�t megk�nny�theti az els�, "r�vid bzip2 p�lda" hetedik 
sora.)
    </para>
    <para>
     Logikai IGAZ (&true;) �rt�kkel t�r vissza ha siker�l,  Logikai HAMIS-sal 
(&false;) ha nem.
    </para>
    <para>
     A f�jl mutat�nak egy l�tez� �s  <function>bzopen</function> f�ggv�nnyel
         sikeresen megnyitott f�jlra kell mutatnia.
    </para>
    <para>
     L�sd m�g: <function>bzopen</function>.
    </para>
   </refsect1>
  </refentry>

  
  <refentry id="function.bzcompress">
   <refnamediv>
    <refname>bzcompress</refname>
    <refpurpose>bzip2 algoritmus szerint t�m�r�t egy jelsorozatot</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>bzcompress</function></funcdef>
      <paramdef>string <parameter>source</parameter></paramdef>
      <paramdef>int
       <parameter><optional>blocksize</optional></parameter>
      </paramdef>
      <paramdef>int 
       <parameter><optional>workfactor</optional></parameter>
      </paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     A <function>bzcompress</function> f�ggv�ny t�m�r�ti a
     <parameter>source</parameter> param�terben megadott forr�sf�jlt �s visszat�r 
ennek 
     bzip2-ben t�m�r�tett v�ltozat�val.
    </para>
    <para>
     Az opcion�lis <parameter>blocksize</parameter> param�terrel 
     pontosan meghat�rozhatjuk a t�m�r�t�shez haszn�lt blokkm�retet, 1 �s 9 k�z�tt.
     A 9 adja a legjobb t�m�r�t�st, de ez a legink�bb er�forr�s-ig�nyesebb is.
     A <parameter>blocksize</parameter> param�ter alp�rtelmezett �rt�ke:
     4.
    </para>
    <para>
     A szint�n opcion�lis  <parameter>workfactor</parameter> param�ter figyeli
     a t�m�r�t�si f�zisok viselked�s�t amikor el��ll a legrosszabb eset, vagyis
     tem�rdek ism�tl�d� adat k�veti egym�st.  Az �rt�ke 0 �s 250 k�z�tt lehet,
     a 250 �s a 0 k�l�nleges esetekben haszn�latos, m�g  30 az alap�rtelmezett �rt�k.
     De <parameter>workfactor</parameter> param�ter ide -vagy oda,
     a gener�lt kimenet ugyanaz marad.
    </para>
    <para>
     <example>
      <title><function>bzcompress</function> P�lda</title>
      <programlisting role="php">
<![CDATA[
<?php
$str = "minta adat";
$bzstr = bzcompress($str, 9);
print( $bzstr );
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     L�sd m�g: <function>bzdecompress</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzdecompress">
   <refnamediv>
    <refname>bzdecompress</refname>
    <refpurpose>Kitcsomagol bzip2 t�m�r�tett adatokat</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>bzdecompress</function></funcdef>
      <paramdef>string <parameter>source</parameter></paramdef>
      <paramdef>int
       <parameter><optional>small</optional></parameter>
      </paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>bzdecompress</function> Kit�m�r�ti 
      <parameter>source</parameter>param�terben megadott, bzip2 t�m�r�tett  adatot.
         Ha a <parameter>small</parameter> opcion�lis param�ter  &true; (logikai 
IGAZ), egy alternat�v 
     kicsomagol� algoritmust fog haszn�lni, ami ugyan kevesebb mem�ri�t fogyaszt,
         (A maxim�lis mem�ria-sz�ks�glete kb.  2300K) de durv�n
     feleannyi sebess�ggel fut. N�zd meg a <ulink url="&url.bzip2;">bzip2
     dokument�ci�t </ulink> a r�szletesebb inform�ci�k�rt e t�m�ban.
    </para>
    <para>
     <example>
      <title><function>bzdecompress</function></title>
      <programlisting role="php">
<![CDATA[
<?php
$start_str = "H�t nem �des pofa?";
$bzstr = bzcompress($start_str);

print( "A t�m�r�tett szting: " );
print( $bzstr );
print( "\n<br>\n" );

$str = bzdecompress($bzstr);
print( "A kicsomagolt sztring: " );
print( $str );
print( "\n<br>\n" );
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     L�sd m�g: <function>bzcompress</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzerrno">
   <refnamediv>
    <refname>bzerrno</refname>
    <refpurpose>A bzip2 hiba sz�m�val t�r vissza</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>int <function>bzerrno</function></funcdef>
      <paramdef>int <parameter>bz</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     B�rmilyen bzip2 m�velet sor�n fell�p� hiba sz�m�val t�r vissza,
         amit a <parameter>bz</parameter> f�jl mutat� (file pointer) szolg�ltat.
    </para>
    <para>
     L�sd m�g: <function>bzerror</function> �s<function>bzerrstr</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzerror">
   <refnamediv>
    <refname>bzerror</refname>
    <refpurpose>A bzip2 hiba sz�m�t �s a hib�s sztringet egy t�mbbe pakolva t�r 
vissza.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>array <function>bzerror</function></funcdef>
      <paramdef>int <parameter>bz</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Egy asszociat�v t�mbbe teszi a bzip2 m�velet sor�n fell�pett hib�kat �s a 
hozz�juk tartoz� hib�s sztringeket,
     amiket a <parameter>bz</parameter> f�jl mutat�t�l (file pointer) vesz �t .
    </para>
    <para>
     <example>
      <title><function>bzerror</function> P�lda</title>
      <programlisting role="php">
<![CDATA[
<?php
$hiba = bzerror($bz);

echo $hiba["errno"];
echo $hiba["errstr"];
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     L�sd m�g <function>bzerrno</function> �s <function>bzerrstr</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzerrstr">
   <refnamediv>
    <refname>bzerrstr</refname>
    <refpurpose>A bzip2 hibasztringgel t�r vissza</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>bzerrstr</function></funcdef>
      <paramdef>int <parameter>bz</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Egy bzip2 m�velet alatt fell�p� hiba hib�s sztringj�vel t�r vissza,
     amit a <parameter>bz</parameter> f�jl mutat� (file pointer) ad �t a f�ggv�nynek.
    </para>
    <para>
     L�sd m�g: <function>bzerrno</function> �s <function>bzerror</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzflush">
   <refnamediv>
    <refname>bzflush</refname>
    <refpurpose>Kik�nyszer�ti az �sszes pufferelt adat �r�s�t</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>int <function>bzflush</function></funcdef>
      <paramdef>int <parameter>bz</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Az �sszes pufferelt bzip2 adat �r�s�t kik�nyszer�ti
     a <parameter>bz</parameter> f�jl mutat� (file pointer) sz�m�ra.
    </para>
    <para>
     �rt�ke &true; (logikai IGAZ) ha siker�l, &false; (logikai HAMIS), ha nem.
    </para>
    <para>
     L�sd m�g:  <function>bzread</function> �s <function>bzwrite</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzopen">
   <refnamediv>
    <refname>bzopen</refname>
    <refpurpose>Megnyit egy bzip2 t�m�r�tett f�jlt</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>int <function>bzopen</function></funcdef>
      <paramdef>string <parameter>filename</parameter></paramdef>
      <paramdef>string <parameter>mode</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Megnyit egy bzip2 (.bz2 kiterjeszt�s�) f�jlt olvas�sra vagy �r�sra.
     <parameter>filename</parameter> param�ter a f�jl neve, amit ki szeretn�nk nyitni.
     A <parameter>mode</parameter> param�ter hasonl�an m�k�dik, mint a  
     <function>fopen</function> f�ggv�nyn�l (`r' - olvas�s, `w' - �r�s, stb.).
    </para>
    <para>
     Ha a m�velet sikertelen, &false; (logikai HAMIS), egy�bk�nt 
     az �jonnan megnyitott  f�jlra mutat� hivatkoz�ssal (pointer) t�r vissza.
    </para>
    <para>
     <example>
      <title><function>bzopen</function> P�lda</title>
      <programlisting role="php">
<![CDATA[
<?php
$bz = bzopen("/tmp/foo.bz2", "r");
$t�m�r�tett_f�jl = bzread($bz, filesize("/tmp/foo.bz2"));
bzclose($bz);

print( "�me a /tmp/foo.bz2 tartalma: " );
print( "\n<br>\n" );
print( $t�m�r�tett_f�jl );
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
    L�sd m�g: <function>bzclose</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzread">
   <refnamediv>
    <refname>bzread</refname>
    <refpurpose>Bin�ris bzip2 f�jlokat olvas</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>bzread</function></funcdef>
      <paramdef>int <parameter>bz</parameter></paramdef>
      <paramdef>int 
       <parameter><optional>length</optional></parameter>
      </paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     A <function>bzread</function> f�ggv�ny beolvas 
     a <parameter>length</parameter> param�terben megadott hossz�s�g� b�jtot a bzip2 
f�jl mutat�b�l (file pointer) 
     amire a  <parameter>bz</parameter> param�terrel utaltunk.  Addig olvas, 
     am�g a <parameter>length</parameter> param�ternek megfelel� (t�m�r�tetlen!) 
mennyis�g� b�jtot beolvassa 
     vagy a f�jlv�g-jelet (EOF) el�ri; m�r amelyik el�bb bek�vetkezik.  Ha az 
opcion�lis 
     <parameter>length</parameter> param�tert nem �ll�tottuk be,
     a <function>bzread</function> f�ggv�ny 1024 (t�m�r�tetlen) b�jtot olvas egyszerre.
    </para>
    <para>
     <example>
      <title><function>bzread</function> P�lda</title>
      <programlisting role="php">
<![CDATA[
<?php
$bz = bzopen("/tmp/foo.bz2", "r");
$str = bzread($bz, 2048);
print( $str );
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     L�sd m�g: <function>bzwrite</function> �s <function>bzopen</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.bzwrite">
   <refnamediv>
    <refname>bzwrite</refname>
    <refpurpose>Bin�ris bzip2 f�jlba �r</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Le�r�s</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>int <function>bzwrite</function></funcdef>
      <paramdef>int <parameter>bz</parameter></paramdef>
      <paramdef>string <parameter>data</parameter></paramdef>
      <paramdef>int
       <parameter><optional>length</optional></parameter>
      </paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     A <function>bzwrite</function> f�ggv�ny 
     a <parameter>data</parameter> param�terben megadott sztringet abba a bzip2 f�jlba 
�rja, 
     amire a <parameter>bz</parameter> mutat. Ha az opcion�lis 
     <parameter>length</parameter> param�tert megadtuk, az �r�s befejez�dik, 
     miut�n el�rte a megadott (t�m�r�tetlen) b�jt hosszt ill. el�rte a f�jlv�g-jelet 
(EOF) ha az hamar�bb bek�vetkezik.
    </para>
    <para>
     <example>
      <title><function>bzwrite</function> P�lda </title>
      <programlisting role="php">
<![CDATA[
<?php
$str = "t�m�r�tetlen adat";
$bz = bzopen("/tmp/foo.bz2", "w");
bzwrite($bz, $str, strlen($str));
bzclose($bz);
?>
]]>
      </programlisting> 
     </example>
    </para>
    <para>
     L�sd m�g: <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
-->