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 >= 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
-->
