Index: phpdoc/hu/functions/bzip2.xml +++ phpdoc/hu/functions/bzip2.xml Bzip2 tömörítési függvények Bzip2 Ez a modul a bzip2kö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. A bzip2 támogatás nincs alapállapotban bekapcsolva a PHP-ben. Fordításkor alkalmazd a --with-bz2 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. Rövid példa 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. Rövid bzip2 példa ]]> bzclose Bezár egy bzip2 fájl mutatót Leírás int bzclose int bz Bezár egy bzip2 fájlot, amire a bz 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.) Logikai IGAZ (&true;) értékkel tér vissza ha sikerül, Logikai HAMIS-sal (&false;) ha nem. A fájl mutatónak egy létező és bzopen függvénnyel sikeresen megnyitott fájlra kell mutatnia. Lásd még: bzopen. bzcompress bzip2 algoritmus szerint tömörít egy jelsorozatot Leírás string bzcompress string source int blocksize int workfactor A bzcompress függvény tömöríti a source paraméterben megadott forrásfájlt és visszatér ennek bzip2-ben tömörített változatával. Az opcionális blocksize 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 blocksize paraméter alpértelmezett értéke: 4. A szintén opcionális workfactor 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 workfactor paraméter ide -vagy oda, a generált kimenet ugyanaz marad. <function>bzcompress</function> Példa ]]> Lásd még: bzdecompress. bzdecompress Kitcsomagol bzip2 tömörített adatokat Leírás string bzdecompress string source int small bzdecompress Kitömöríti sourceparaméterben megadott, bzip2 tömörített adatot. Ha a small 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 bzip2 dokumentációt a részletesebb információkért e témában. <function>bzdecompress</function> \n" ); $str = bzdecompress($bzstr); print( "A kicsomagolt sztring: " ); print( $str ); print( "\n
\n" ); ?> ]]> Lásd még: bzcompress. bzerrno A bzip2 hiba számával tér vissza Leírás int bzerrno int bz Bármilyen bzip2 művelet során fellépő hiba számával tér vissza, amit a bz fájl mutató (file pointer) szolgáltat. Lásd még: bzerror ésbzerrstr. bzerror A bzip2 hiba számát és a hibás sztringet egy tömbbe pakolva tér vissza. Leírás array bzerror int bz 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 bz fájl mutatótól (file pointer) vesz át . <function>bzerror</function> Példa ]]> Lásd még bzerrno és bzerrstr. bzerrstr A bzip2 hibasztringgel tér vissza Leírás string bzerrstr int bz Egy bzip2 művelet alatt fellépő hiba hibás sztringjével tér vissza, amit a bz fájl mutató (file pointer) ad át a függvénynek. Lásd még: bzerrno és bzerror. bzflush Kikényszeríti az összes pufferelt adat írását Leírás int bzflush int bz Az összes pufferelt bzip2 adat írását kikényszeríti a bz fájl mutató (file pointer) számára. Értéke &true; (logikai IGAZ) ha sikerül, &false; (logikai HAMIS), ha nem. Lásd még: bzread és bzwrite. bzopen Megnyit egy bzip2 tömörített fájlt Leírás int bzopen string filename string mode Megnyit egy bzip2 (.bz2 kiterjesztésű) fájlt olvasásra vagy írásra. filename paraméter a fájl neve, amit ki szeretnénk nyitni. A mode paraméter hasonlóan működik, mint a fopen függvénynél (`r' - olvasás, `w' - írás, stb.). Ha a művelet sikertelen, &false; (logikai HAMIS), egyébként az újonnan megnyitott fájlra mutató hivatkozással (pointer) tér vissza. <function>bzopen</function> Példa \n" ); print( $tömörített_fájl ); ?> ]]> Lásd még: bzclose. bzread Bináris bzip2 fájlokat olvas Leírás string bzread int bz int length A bzread függvény beolvas a length paraméterben megadott hosszúságú bájtot a bzip2 fájl mutatóból (file pointer) amire a bz paraméterrel utaltunk. Addig olvas, amíg a length 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 length paramétert nem állítottuk be, a bzread függvény 1024 (tömörítetlen) bájtot olvas egyszerre. <function>bzread</function> Példa ]]> Lásd még: bzwrite és bzopen. bzwrite Bináris bzip2 fájlba ír Leírás int bzwrite int bz string data int length A bzwrite függvény a data paraméterben megadott sztringet abba a bzip2 fájlba írja, amire a bz mutat. Ha az opcionális length 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. <function>bzwrite</function> Példa ]]> Lásd még: bzread és bzopen.