goba Wed Nov 14 05:22:19 2001 EDT
Added files:
/phpdoc/hu/functions zip.xml
Modified files:
/phpdoc/hu Translators
Log:
Adding zip.xml translated by Andras Csontos
Index: phpdoc/hu/Translators
diff -u phpdoc/hu/Translators:1.59 phpdoc/hu/Translators:1.60
--- phpdoc/hu/Translators:1.59 Thu Oct 25 13:36:28 2001
+++ phpdoc/hu/Translators Wed Nov 14 05:22:19 2001
@@ -178,7 +178,7 @@
xml.xml
xslt.xml
yaz.xml
-zip.xml Csontos Andr�s [undrcon]
+zip.xml Csontos Andr�s 1.13
zlib.xml
-------- language -----------------------------------------------------------
basic-syntax.xml Kontra Gergely 1.14
Index: phpdoc/hu/functions/zip.xml
+++ phpdoc/hu/functions/zip.xml
<?xml encoding="iso-8859-2"?>
<!-- EN-Revision: 1.13 Maintainer: acsontos Status: ready -->
<reference id="ref.zip">
<title>Zip F�jl f�ggv�nyek (csak olvas�shoz)</title>
<titleabbrev>Zip</titleabbrev>
<partintro>
<para>
Ez a modul a <ulink
url="&url.zziplib;">ZZIPlib</ulink> k�nyvt�r f�ggv�nyeit haszn�lja,
a zip elj�r�ssal t�m�r�tett �llom�nyok �s a benn�k lev� f�jlok
olvas�s�hoz. A ZZIPlib-et Guido Draheimnek k�sz�nhetj�k.
</para>
<para>
Vedd figyelembe, hogy a ZZIPlib csak a teljes zip imlement�ci�nak megfelel�
t�m�r�tett zip f�jlokat kezeli. A zip programk�szletre is
sz�ks�g van ahhoz, hogy zip f�jlokat olvasson a modul.
</para>
<para>
A zip t�mogat�s nincs be�p�tve a PHP-ben, a
<link
linkend="install.configure.with-zip">--with-zip</link>
opci�val kell ford�tanod, hogy haszn�lhasd.
Sz�ks�g van m�g a ZZIPlib 0.10.6 vagy k�s�bbi kiad�s�ra is.
</para>
<note>
<para>
A zip t�mogat�s a PHP 4.1.0-n�l r�gebbi verzi�kban csak
k�s�rleti jelleg�, teh�t ezekben nem m�k�dik megb�zhat�an.
Ez a dokumentum a 4.1.0 �s az �jabb PHP verzi�k zip modulj�t mutatja be.
</para>
</note>
<sect1 id="zip-example">
<title>P�lda</title>
<para>
Az al�bbi p�lda megnyit egy zip �llom�nyt, beolvassa a benne
tal�lhat� f�jlokat �s kinyomtatja tartalmukat. A p�ld�ban felhaszn�lt
<filename>test2.zip</filename> �llom�ny a ZZIPlib csomag egyik
"be�p�tett" pr�ba �llom�nya.
</para>
<example>
<title>P�ldaprogram</title>
<programlisting role="php">
<?php
$zip = zip_open("/tmp/test2.zip");
if ($zip) {
while ($zip_entry = zip_read($zip)) {
echo "N�v: " . zip_entry_name($zip_entry) . "\n";
echo "T�m�r�tetlen m�ret: " . zip_entry_filesize($zip_entry) . "\n";
echo "T�m�r�tett m�ret: " . zip_entry_compressedsize($zip_entry) . "\n";
echo "T�m�r�t�si met�dus: " . zip_entry_compressionmethod($zip_entry) . "\n";
if (zip_entry_open($zip, $zip_entry, "r")) {
echo "A f�jl tartalma:\n";
$buf = zip_entry_read($zip_entry, zip_entry_filesize($zip_entry));
echo "$buf\n";
zip_entry_close($zip_entry);
}
echo "\n";
}
zip_close($zip);
}
?>
</programlisting>
</example>
</sect1>
<para>
A program el�sz�r megnyitja a megadott �tvonalon tal�lhat�
<filename>test2.zip</filename> f�jlt. A ciklust addig v�gzi,
am�g a a <function>zip_read</function> egy �rv�nyes
<literal>$zip_entry</literal> (vagyis a zip �llom�nyban
l�tez� f�jl vagy k�nyvt�r) �rt�kkel t�r vissza.
A <function>zip_read<function> tulajdonk�ppen egy t�mb el�r�sek�nt
k�pzelhet�, amely t�mbbe a <funtion>zip_open</funtion> bet�lti
a megnyitott zip �llom�nyban l�v� f�jlok neveit. Minden egyes
ciklusn�l a program automatikusan el�re l�pteti a t�mb�t eggyel.
</para>
</partintro>
<refentry id="function.zip-close">
<refnamediv>
<refname>zip_close</refname>
<refpurpose>Lez�r egy megnyitott ZIP �llom�nyt</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>zip_close</function></funcdef>
<paramdef>resource <parameter>zip</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Lez�r egy megnyitott ZIP �llom�nyt. Ez csak akkor m�k�dik, ha a
<parameter>zip</parameter> forr�sf�jlt el�z�leg a
<function>zip_open</function> f�ggv�nnyel nyitottuk meg.
</para>
<para>
Ennek a f�ggv�nynek nincs visszat�r�si �rt�ke.
</para>
<para>
L�sd m�g: <function>zip_open</function> �s
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-close">
<refnamediv>
<refname>zip_entry_close</refname>
<refpurpose>Lez�r egy ZIP �llom�nyban tal�lhat� objektumot</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>zip_entry_close</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Lez�rja a zip �llom�nyban l�v� <parameter>zip_entry</parameter>
objektumot. A <parameter>zip_entry</parameter> param�ter egy l�tez�
objektum a zip f�jlban, amit a <function>zip_entry_open</function>
f�ggv�nnyel nyitottunk meg.
</para>
<para>
Ennek a f�ggv�nynek nincs visszat�r�si �rt�ke.
</para>
<para>
L�sd m�g: <function>zip_entry_open</function> �s
<function>zip_entry_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-compressedsize">
<refnamediv>
<refname>zip_entry_compressedsize</refname>
<refpurpose>Egy zip-ben l�v� objektum t�m�r�tett m�ret�t adja vissza</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>int
<function>zip_entry_compressedsize</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Az adott <parameter>zip_entry</parameter> objektum t�m�r�tett
m�ret�vel t�r vissza. A <parameter>zip_entry</parameter> egy
l�tez� zip �llom�nybeli objektumra mutat, amihez a
<function>zip_read</function> f�ggv�ny seg�ts�g�vel jutunk.
</para>
<para>
L�sd m�g: <function>zip_open</function> �s
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-compressionmethod">
<refnamediv>
<refname>zip_entry_compressionmethod</refname>
<refpurpose>
A megadott zip objektum t�m�r�t�si t�pus�val t�r vissza
</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>string
<function>zip_entry_compressionmethod</function>
</funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
A megadott <parameter>zip_entry</parameter> objektum t�m�r�t�si
met�dus�nak t�pus�val t�r vissza. A param�ter egy l�tez� zip
�llom�nybeli objektumra mutat, amihez a
<function>zip_read</function> f�ggv�ny seg�ts�g�vel
jutottunk.
</para>
<para>
L�sd m�g: <function>zip_open</function> �s
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-filesize">
<refnamediv>
<refname>zip_entry_filesize</refname>
<refpurpose>
Az adott zip objektum t�m�r�tetlen f�jlm�ret�t adja vissza
</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>zip_entry_filesize</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Visszat�r az adott <parameter>zip_entry</parameter> objektum
t�m�r�tetlen f�jlm�ret�nek �rt�k�vel. Ez a
<parameter>zip_entry</parameter> param�ter egy l�tez� zip
objektum ami a <function>zip_read</function> f�ggv�ny
visszat�r�si �rt�ke.
</para>
<para>
L�sd m�g: <function>zip_open</function> �s
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-name">
<refnamediv>
<refname>zip_entry_name</refname>
<refpurpose>A zip objektum nev�vel t�r vissza</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>zip_entry_name</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
A <parameter>zip_entry</parameter> param�terrel megadott zip
objektum nev�vel t�r vissza. A <parameter>zip_entry</parameter>
param�ter egy l�tez� zip objektum, amit a
<function>zip_read</function> f�ggv�nnyel olvashatunk ki a
zip �llom�nyb�l.
</para>
<para>
L�sd m�g: <function>zip_open</function> �s
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-open">
<refnamediv>
<refname>zip_entry_open</refname>
<refpurpose>Olvas�sra megnyit egy zip objektumot</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>zip_entry_open</function></funcdef>
<paramdef>resource <parameter>zip</parameter></paramdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
<paramdef>string
<parameter><optional>mode</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Olvas�sra megnyit egy l�tez� zip objektumot egy zip �llom�nyb�l.
A <parameter>zip</parameter> param�ter egy l�tez� zip f�jl,
amit a <function>zip_open</function> f�ggv�nnyel nyitottunk meg.
Az olvasni k�v�nt objektumot a <parameter>zip_entry</parameter> defini�lja,
ami a <function>zip_read</function> f�ggv�ny visszat�r�si �rt�ke.
A <parameter>mode</parameter> nem k�telez� param�ter, l�sd az
<function>fopen</function> dokument�ci�j�t a lehets�ges �rt�kek�rt.
</para>
<note>
<para>
Jelenleg a <parameter>mode</parameter> param�tert nem veszi
figyelembe a PHP, csak az <literal>"rb"</literal> alap�rtelmezett
�rt�kkel dolgozik. Emiatt a PHP-ben csak olvas�si hozz�f�r�st
kapunk a zip �llom�nyokhoz. Az <function>fopen</function>
dokument�ci�ja r�szletesen magyar�zza a k�l�nb�z� f�jl kapcsol�kat,
k�zt�k az <literal>"rb"</literal>-t is.
</para>
</note>
<para>
Ez a f�ggv�ny siker eset�n logikai IGAZ (&true;), kudarcn�l logikai
HAMIS (&false;) �rt�keket vesz fel.
</para>
<note>
<para>
Ellent�tben az <function>fopen</function> �s m�s hasonl�
f�ggv�nyekkel, a <function>zip_entry_open</function> f�ggv�ny
visszat�r�si �rt�ke csak a m�velet eredm�nyess�g�t mutatja
�s nincs sz�ks�g a vizsg�lt zip objektum olvas�s�ra vagy
lez�r�s�ra.
</para>
</note>
<para>
L�sd m�g: <function>zip_entry_read</function> �s
<function>zip_entry_close</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-read">
<refnamediv>
<refname>zip_entry_read</refname>
<refpurpose>Olvas egy megnyitott zip objektumb�l</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>zip_entry_read</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
<paramdef>int
<parameter><optional>length</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
A <parameter>length</parameter> param�terben megadott b�jt
hossz�s�g� r�szt olvas be egy megnyitott zip objektumb�l. Ha
a <parameter>length</parameter> param�ter nincs megadva,
az alap�rtelmez�s 1024 b�jt. A <parameter>zip_entry</parameter>
param�ter egy l�tez� zip objektum, ami a
<function>zip_read</function> f�ggv�ny visszat�r�si �rt�ke.
</para>
<note>
<para>
A <parameter>length</parameter> param�tert t�m�r�tetlen
m�retben kell �rteni!
</para>
</note>
<para>
Az olvasott adattal vagy (pl. hib�s adatok eset�n) logikai HAMIS
(&false;) �rt�kkel t�r vissza, ha el�rte a f�jl v�g�t.
</para>
<para>
L�sd m�g: <function>zip_entry_open</function>,
<function>zip_entry_close</function> �s
<function>zip_entry_filesize</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-open">
<refnamediv>
<refname>zip_open</refname>
<refpurpose>Megnyit egy zip �llom�nyt</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>resource <function>zip_open</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Olvas�sra megnyit egy zip �llom�nyt.
A <parameter>filename</parameter> az olvasni k�v�nt
zip �llom�ny neve.
</para>
<para>
Ezzel a f�ggv�nnyel nyitjuk meg a zip �llom�nyokat tov�bbi
feldolgoz�sra. Miut�n megnyitottuk, a <function>zip_read</function>
f�ggv�nnyel olvashatjuk ill. a <function>zip_close</function>
f�ggv�nnyel z�rhatjuk le az �llom�nyt. A
<function>zip_open</function> logikai HAMIS (&false;) �rt�kkel
t�r vissza, ha a <parameter>filename</parameter> param�terben
megadott f�jl nem l�tezik.
</para>
<para>
L�sd m�g: <function>zip_read</function> �s
<function>zip_close</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-read">
<refnamediv>
<refname>zip_read</refname>
<refpurpose>Beolvassa a soron k�vetkez� zip objektumot egy zip
�llom�nyban</refpurpose>
</refnamediv>
<refsect1>
<title>Le�r�s</title>
<funcsynopsis>
<funcprototype>
<funcdef>resource <function>zip_read</function></funcdef>
<paramdef>resource <parameter>zip</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Beolvassa a soron k�vetkez� zip objektumot egy zip �llom�nyb�l.
A <parameter>zip</parameter> param�ter egy l�tez� zip �llom�ny,
amit el�z�leg megnyitottunk a <function>zip_open</function> f�ggv�nnyel.
</para>
<para>
Ez a f�ggv�ny az aktu�lis zip objektumot feldolgozhat�v� teszi a
<function>zip_entry_...</function> f�ggv�nyek sz�m�ra.
</para>
<para>
L�sd m�g: <function>zip_open</function>,
<function>zip_close</function>,
<function>zip_entry_open</function>, �s
<function>zip_entry_read</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
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
-->
