hirokawa Sat Jul 7 19:50:04 2001 EDT
Added files:
/phpdoc/ja/functions ircg.xml zip.xml
Log:
added zip.xml ircg.xml in japanese php manual translation.
Index: phpdoc/ja/functions/ircg.xml
+++ phpdoc/ja/functions/ircg.xml
<reference id="ref.ircg">
<title>IRC Gateway関数</title>
<titleabbrev>IRC Gateway</titleabbrev>
<partintro>
<para>
Internet Relay Chat Gateway ...
</para>
</partintro>
<refentry id="function.ircg-pconnect">
<refnamediv>
<refname>ircg_pconnect</refname>
<refpurpose>
IRCサーバに接続する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>resource <function>ircg_pconnect</function></funcdef>
<paramdef>string <parameter>username</parameter></paramdef>
<paramdef>string
<parameter><optional>server_ip</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>server_port</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>msg_format</optional></parameter>
</paramdef>
<paramdef>array
<parameter><optional>ctcp_messages</optional></parameter>
</paramdef>
<paramdef>array
<parameter><optional>user_settings</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>ircg_pconnect</function> will try to establish a connection to
an IRC server and return a connection resource handle for further
use.
</para>
<para>
The only mandatory parameter is <parameter>username</parameter>,
this will set your initial nicknake on the
server. <parameter>server_ip</parameter> and
<parameter>server_port</parameter> are optional and default to
<literal>127.0.0.1</literal> and <literal>6667</literal>.
<note>
<para>
For now parameter <parameter>server_ip</parameter> will not do
any hostname lookups and will only accept IP addresses in
numerical form.
</para>
</note>
</para>
<para>
You can customize the output of IRC messages and events by
selection a format string set previously created with
<function>ircg_register_format_messages</function>
by specifing the sets name in <parameter>msg_format</parameter>.
</para>
<para>
<parameter>ctcp_messages</parameter>
</para>
<para>
<parameter>user_settings</parameter>
</para>
<para>
See also: <function>ircg_disconnect</function>,
<function>ircg_is_conn_alive</function>,
<function>ircg_register_format_messages</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-set-current">
<refnamediv>
<refname>ircg_set_current</refname>
<refpurpose>
出力用にカレントの接続を設定する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_set_current</function></funcdef>
<paramdef>resource
<parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Select the current connection for output in this execution
context. Every output sent from the server connected to by
<parameter>connection</parameter> will be copied to standard
output while using default formating or a formar string set
specified by <function>ircg_register_format_messages</function>
and selected by <function>irct_lookup_format_messages</function>.
</para>
<para>
See also: <function>ircg_register_format_messages</function> and
<function>ircg_lookup_format_messages</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-join">
<refnamediv>
<refname>ircg_join</refname>
<refpurpose>
接続中のサーバ上でチャンネルに接続する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_join</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>channel</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Join the channel <parameter>channel</parameter> on the server
connected to by <parameter>connection</parameter>.
</para>
<para>
See also:
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-part">
<refnamediv>
<refname>ircg_part</refname>
<refpurpose>
サーバ上のチャンネルから離脱する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_part</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>channel</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Leave the channel <parameter>channel</parameter> on the server
connected to by <parameter>connection</parameter>.
</para>
<para>
See also:
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-msg">
<refnamediv>
<refname>ircg_msg</refname>
<refpurpose>
サーバ上のチャンネルまたはユーザにメッセージを送信する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_msg</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>recipient</parameter></paramdef>
<paramdef>string <parameter>message</parameter></paramdef>
<paramdef>boolean
<parameter><optional>suppress</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>ircg_msg</function> will send the message to a channel
or user on the server connected to by
<parameter>connection</parameter>. A
<parameter>recipient</parameter> starting with
<literal>#</literal> or <literal>&</literal> will send the
<parameter>message</parameter> to a channel, anything else will
be interpreted as a username.
</para>
<para>
Setting the optional parameter <parameter>suppress</parameter> to
a true value will suppress output of your message to your own
<parameter>connection</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-notice">
<refnamediv>
<refname>ircg_notice</refname>
<refpurpose>
サーバ上のユーザに通知を送信する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_notice</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter></parameter></paramdef>
<paramdef>string <parameter>message</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function will send the <parameter>message</parameter> text
to the user <parameter>nick</parameter> on the server connected
to by <parameter>connection</parameter>. Query your IRC
documentation of choice for the exact difference between a MSG
and a NOTICE.
</para>
<para>
See also:
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-nick">
<refnamediv>
<refname>ircg_nick</refname>
<refpurpose>
サーバ上のニックネームを変更する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_nick</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>nick</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Change your nickname on the given
<parameter>connection</parameter> to the one given in
<parameter>nick</parameter> if possible.
</para>
<para>
Will return true on success and false on failure.
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-topic">
<refnamediv>
<refname>ircg_topic</refname>
<refpurpose>
サーバ上のチャネル用にトピックを設定する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_topic</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>channel</parameter></paramdef>
<paramdef>string <parameter>new_topic</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Change the topic for channel <parameter>channel</parameter> on
the server connected to by <parameter>connection</parameter> to
<parameter>new_topic</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-channel_mode">
<refnamediv>
<refname>ircg_channel_mode</refname>
<refpurpose>
ユーザ用にチャンネルモードフラグを設定する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_channel_mode</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>channel</parameter></paramdef>
<paramdef>string <parameter>mode_spec</parameter></paramdef>
<paramdef>string <parameter>nick</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Set channel mode flags for <parameter>channel</parameter> on
server connected to by <parameter>channel</parameter>. Mode flags
are passed in <parameter>mode_spec</parameter> and are applied to
the user specified by <parameter>nick</parameter>.
</para>
<para>
Mode flags are set or cleared by specifind a mode character and
prepending it with a plus or minus character
respectively. E.g. operator mode is granted by '+o' and revoked
by '-o' passed as <parameter>mode_spec</parameter>.
</para>
<para>
See also:
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-html-encode">
<refnamediv>
<refname>ircg_html_encode</refname>
<refpurpose>
HTMLで保存された文字列をエンコードする
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_html_encode</function></funcdef>
<paramdef>string <parameter>html_string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
...
</para>
<para>
See also:
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-whois">
<refnamediv>
<refname>ircg_whois</refname>
<refpurpose>
サーバ上のニックネームからユーザ情報を検索する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_whois</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>nick</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
</para>
<para>
See also:
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-kick">
<refnamediv>
<refname>ircg_kick</refname>
<refpurpose>
サーバ上のチャネルからユーザを排除する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_kick</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>channel</parameter></paramdef>
<paramdef>string <parameter>nick</parameter></paramdef>
<paramdef>string <parameter>reason</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Kick user <parameter>nick</parameter> from
<parameter>channel</parameter> on server connected to by
<parameter>connection</parameter>. <parameter>reason</parameter>
should give a short message describing why this action was performed.
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-ignore-add">
<refnamediv>
<refname>ircg_ignore_add</refname>
<refpurpose>
サーバ上の除外リストにユーザを追加する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_ignore_add</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>nick</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function will add user <parameter>nick</parameter> to your
ignore list on the server connected to by
<parameter>connection</parameter>. By doing so you will suppress
all messages from this user from being send to you.
</para>
<para>
See also: <function>ircg_ignore_del</function> .
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-ignore-del">
<refnamediv>
<refname>ircg_ignore_del</refname>
<refpurpose>
サーバ上の除外リストからユーザを削除する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_ignore_del</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>nick</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function remove user <parameter>nick</parameter> to your
ignore list on the server connected to by
<parameter>connection</parameter>.
</para>
<para>
See also: <function>ircg_ignore_add</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-disconnect">
<refnamediv>
<refname>ircg_disconnect</refname>
<refpurpose>
サーバへの接続を閉じる
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_disconnect</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>reason</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>ircg_disconnect</function> will close a
<parameter>connection</parameter> to a server previously
established with <function>ircg-pconnect</function>.
</para>
<para>
See also: <function>ircg_pconnect</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-is-conn-alive">
<refnamediv>
<refname>ircg_is_conn_alive</refname>
<refpurpose>
接続ステータスを確認する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>ircg_is_conn_alive</function></funcdef>
<paramdef>resource <parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>ircg_is_conn_alive</function> returns true if
<parameter>connection</parameter> is still alive and working or
false if the server no longer talks to us.
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-lookup-format-messages">
<refnamediv>
<refname>ircg_lookup_format_messages</refname>
<refpurpose>
IRCメッセージの表示用文字列フォーマットの設定を選択する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>
boolean <function>ircg_lookup_format_messages</function>
</funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Select the set of format strings to use for display of IRC
messages and events. Sets may be registered with
<function>ircg_register_format_messages</function>, a default set
named <literal>ircg</literal> is always available.
</para>
<para>
See also: <function>ircg_register_format_messages</function>
</para>
</refsect1>
</refentry>
<refentry id="function.ircg-register-format-messages">
<refnamediv>
<refname>ircg_register_format_messages</refname>
<refpurpose>
IRCメッセージの表示用文字列フォーマットの設定を登録する
</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>
boolean <function>ircg_register_format_messages</function>
</funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
<paramdef>array <parameter>messages</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
With <function>ircg_register_format_messages</function> you can
customize the way your IRC output looks like. You can even
register different format string sets and switch between them on
the fly with <function>ircg_lookup_format_messages</function>.
</para>
<para>
<itemizedlist>
<listitem><simpara>Plain channel message</simpara></listitem>
<listitem><simpara>Private message received</simpara></listitem>
<listitem><simpara>Private message sent</simpara></listitem>
<listitem><simpara>Some user leaves channel</simpara></listitem>
<listitem><simpara>Some user enters channel</simpara></listitem>
<listitem><simpara>Some user was kicked from the channel</simpara></listitem>
<listitem><simpara>Topic has been changed</simpara></listitem>
<listitem><simpara>Error</simpara></listitem>
<listitem><simpara>Fatal error</simpara></listitem>
<listitem><simpara>Join list end(?)</simpara></listitem>
<listitem><simpara>Self part(?)</simpara></listitem>
<listitem><simpara>Some user changes his nick</simpara></listitem>
<listitem><simpara>Some user quits his connection</simpara></listitem>
<listitem><simpara>Mass join begin</simpara></listitem>
<listitem><simpara>Mass join element</simpara></listitem>
<listitem><simpara>Mass join end</simpara></listitem>
<listitem><simpara>Whois user</simpara></listitem>
<listitem><simpara>Whois server</simpara></listitem>
<listitem><simpara>Whois server</simpara></listitem>
<listitem><simpara>Whois idle</simpara></listitem>
<listitem><simpara>Whois channel</simpara></listitem>
<listitem><simpara>Whois end</simpara></listitem>
<listitem><simpara>Voice status change on user</simpara></listitem>
<listitem><simpara>Operator status change on user</simpara></listitem>
<listitem><simpara>Banlist</simpara></listitem>
<listitem><simpara>Banlist end</simpara></listitem>
</itemizedlist>
<itemizedlist>
<listitem><simpara>%f - from</simpara></listitem>
<listitem><simpara>%t - to</simpara></listitem>
<listitem><simpara>%c - channel</simpara></listitem>
<listitem><simpara>%r - plain message</simpara></listitem>
<listitem><simpara>%m - encoded message</simpara></listitem>
<listitem><simpara>%j - js encoded message</simpara></listitem>
</itemizedlist>
<itemizedlist>
<listitem><simpara>1 - mod encode</simpara></listitem>
<listitem><simpara>2 - nickname decode</simpara></listitem>
</itemizedlist>
</para>
<para>
<function>ircg_lookup_format_messages</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:
-->
Index: phpdoc/ja/functions/zip.xml
+++ phpdoc/ja/functions/zip.xml
<reference id="ref.zip">
<title>Zipファイル関数(読込のみ)</title>
<titleabbrev>Zip</titleabbrev>
<partintro>
<para>
このモジュールは、Guido
Draheimにより作成されたZIP圧縮されたアーカイブ
およびその中のファイルを透過的に読みこむためのライブラリ
<ulink url="&url.zziplib;">ZZIPlib</ulink>の関数を使用します。
</para>
<para>
ZZIPlib
は、ZIPの圧縮アルゴリズムの完全な実装で提供される関数のサブセッ
トであり、ZIPファイルアーカイブの読込みのみができることに注意して下さい。
このライブラリで読み込まれるZIPファイルアーカイブを作成するには、通常の
ZIPユーティリティが必要です。
</para>
<para>
PHPにおけるZipサポートは、デフォルトでは使用できません。
Zipサポートを有効にしるには、PHPのコンパイル時にconfigureのオプションに
<link linkend="install.configure.with-zip">--with-zip</link>を指定して
コンパイルする必要があります。このモジュールは、ZZIPlib
バージョン
>= 0.10.6を必要とします。
</para>
<sect1 id="zip-example">
<title>使用例</title>
<para>
以下の例は、ZIPファイルアーカイブをオープンし、そのアーカイブの中の各
ファイルを読み込んで、その内容を出力するものです。この例で使用されて
いる <filename>test2.php</filename>
アーカイブは、ZZIPlibソース配布に
含まれるテスト用のアーカイブの一つです。
</para>
<example>
<title>Zip の使用例</title>
<programlisting role="php">
<?php
$zip = zip_open("/tmp/test2.zip");
if ($zip) {
while ($zip_entry = zip_read($zip)) {
echo "Name: " . zip_entry_name($zip_entry) . "\n";
echo "Actual Filesize: " . zip_entry_filesize($zip_entry) . "\n";
echo "Compressed Size: " . zip_entry_compressedsize($zip_entry) . "\n";
echo "Compression Method: " . zip_entry_compressionmethod($zip_entry) . "\n";
if (zip_entry_open($zip, $zip_entry, "r")) {
echo "File Contents:\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>
</partintro>
<refentry id="function.zip-close">
<refnamediv>
<refname>zip_close</refname>
<refpurpose>Zipファイルアーカイブを閉じる</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>zip_close</function></funcdef>
<paramdef>resource <parameter>zip</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Closes a zip file archive. The parameter
<parameter>zip</parameter> must be a zip archive previously
opened by <function>zip_open</function>.
</para>
<para>
This function has no return value.
</para>
<para>
See also <function>zip_open</function> and
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-close">
<refnamediv>
<refname>zip_entry_close</refname>
<refpurpose>ディレクトリエントリをクローズする</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>zip_close</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Closes a directory entry specified by
<parameter>zip_entry</parameter>. The parameter
<parameter>zip_entry</parameter> must be a valid directory entry
opened by <function>zip_entry_open</function>.
</para>
<para>
This function has no return value.
</para>
<para>
See also <function>zip_entry_open</function> and
<function>zip_entry_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-compressedsize">
<refnamediv>
<refname>zip_entry_compressedsize</refname>
<refpurpose>ディレクトリエントリの圧縮時のサイズを取得する</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>zip_entry_compressedsize</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns the compressed size of the directory entry specified by
<parameter>zip_entry</parameter>. The parameter
<parameter>zip_entry</parameter> is a valid directory entry
returned by <function>zip_read</function>.
</para>
<para>
See also <function>zip_open</function> and
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-compressionmethod">
<refnamediv>
<refname>zip_entry_compressionmethod</refname>
<refpurpose>ディレクトリエントリの圧縮方法を取得する</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>zip_entry_compressionmethod</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns the compression method of the directory entry specified by
<parameter>zip_entry</parameter>. The parameter
<parameter>zip_entry</parameter> is a valid directory entry
returned by <function>zip_read</function>.
</para>
<para>
See also <function>zip_open</function> and
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-filesize">
<refnamediv>
<refname>zip_entry_filesize</refname>
<refpurpose>ディレクトリエントリの実際のファイルサイズを取得する</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>zip_entry_filesize</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns the actual size of the directory entry specified by
<parameter>zip_entry</parameter>. The parameter
<parameter>zip_entry</parameter> is a valid directory entry
returned by <function>zip_read</function>.
</para>
<para>
See also <function>zip_open</function> and
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-name">
<refnamediv>
<refname>zip_entry_name</refname>
<refpurpose>ディレクトリエントリの名前を取得する</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>zip_entry_name</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns the name of the directory entry specified by
<parameter>zip_entry</parameter>. The parameter
<parameter>zip_entry</parameter> is a valid directory entry
returned by <function>zip_read</function>.
</para>
<para>
See also <function>zip_open</function> and
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-open">
<refnamediv>
<refname>zip_entry_open</refname>
<refpurpose>読込み用にディレクトリエントリをオープンする</refpurpose>
</refnamediv>
<refsect1>
<title>説明</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>
Opens a directory entry in a zip file for reading. The parameter
<parameter>zip</parameter> is a valid resource handle returned by
<function>zip_open</function>. The parameter
<parameter>zip_entry</parameter> is a directory entry resource
returned by <function>zip_read</function>. The optional parameter
<parameter>mode</parameter> can be any of the modes specified in
the documentaion for <function>fopen</function>.
</para>
<note>
<para>
Currently, <parameter>mode</parameter> is ignored and is always
<literal>"rb"</literal>. This is due to the fact that zip
support in PHP is read only access. Please see
<function>fopen</function> for an explanation of various modes,
including <literal>"rb"</literal>.
</para>
</note>
<para>
Returns <literal>true</literal> on succes or <literal>false</literal> on failure.
</para>
<note>
<para>
Unlike <function>fopen</function> and other similar functions,
the return value of <function>zip_entry_open</function> only
indicates the result of the operation and is not needed for
reading or closing the directory entry.
</para>
</note>
<para>
See also <function>zip_entry_read</function> and
<function>zip_entry_close</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-read">
<refnamediv>
<refname>zip_entry_read</refname>
<refpurpose>オープンされたディレクトリエントリから読み込む</refpurpose>
</refnamediv>
<refsect1>
<title>説明</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>
Reads up to <parameter>length</parameter> bytes from an open
directory entry. If <parameter>length</parameter> is not
specified, then <function>zip_entry_read</function> will attempt
to read 1024 bytes. The parameter
<parameter>zip_entry</parameter> is a valid directory entry
returned by <function>zip_read</function>.
</para>
<note>
<para>
The <parameter>length</parameter> parameter should be the
uncompressed length you wish to read.
</para>
</note>
<para>
Returns the data read, or <literal>false</literal> if the end of
the file is reached.
</para>
<para>
See also <function>zip_entry_open</function>,
<function>zip_entry_close</function> and
<function>zip_entry_filesize</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-open">
<refnamediv>
<refname>zip_open</refname>
<refpurpose>Zipファイルアーカイブをオープンする</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>resource <function>zip_open</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Opens a new zip archive for reading. The
<parameter>filename</parameter> parameter is the filename of the
zip archive to open.
</para>
<para>
Returns a resource handle for later use with
<function>zip_read</function> and
<function>zip_close</function> or returns
<literal>false</literal> if <parameter>filename</parameter> does
not exist.
</para>
<para>
See also <function>zip_read</function> and
<function>zip_close</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-read">
<refnamediv>
<refname>zip_read</refname>
<refpurpose>Zipファイルアーカイブの中の次のエントリを読み込む</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>resource <function>zip_read</function></funcdef>
<paramdef>resource <parameter>zip</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Reads the next entry in a zip file archive. The parameter
<parameter>zip</parameter> must be a zip archive previously
opened by <function>zip_open</function>.
</para>
<para>
Returns a directory entry resource for later use with the
<function>zip_entry_...</function> functions.
</para>
<para>
See also <function>zip_open</function>,
<function>zip_close</function>,
<function>zip_entry_open</function> and
<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:
-->
