cvs: phpdoc-ja /reference/filesystem/functions flock.xml fopen.xml fpassthru.xml fscanf.xml fseek.xml fstat.xml ftell.xml ftruncate.xml fwrite.xml
is-dir.xml is-executable.xml is-file.xml is-link.xml

shimooka Sat Jul 23 03:00:49 2005 EDT Modified files: /phpdoc-ja/reference/filesystem/functions flock.xml fopen.xml fpassthru.xml fscanf.xml fseek.xml fstat.xml ftell.xml ftruncate.xml fwrite.xml is-dir.xml is-executable.xml is-file.xml is-link.xml Log: translation updated

http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/flock.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/reference/filesystem/functions/flock.xml diff -u phpdoc-ja/reference/filesystem/functions/flock.xml:1.5 phpdoc-ja/reference/filesystem/functions/flock.xml:1.6 --- phpdoc-ja/reference/filesystem/functions/flock.xml:1.5 Sun Jan 2 02:23:32 2005 +++ phpdoc-ja/reference/filesystem/functions/flock.xml Sat Jul 23 03:00:45 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.flock"> <refnamediv> <refname>flock</refname> @@ -12,13 +13,18 @@ <type>bool</type><methodname>flock</methodname> <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>int</type><parameter>operation</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>&amp;wouldblock</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">wouldblock</parameter></methodparam> </methodsynopsis> <simpara> PHP は、恣意的にファイルをロックする汎用の手段を提供します。 (これは、アクセスする全プログラムが同一のロックの方法を使用する 必要があり、そうでない場合は動作しないことを意味します) </simpara> + <note> + <para> + <function>flock</function> 関数は Windows 環境下では必ず行ってください。 + </para> + </note> <simpara> <function>flock</function>は、<parameter>handle</parameter>を用いて 操作を行います。これは、オープンされたファイルポインタである必要が @@ -61,10 +67,35 @@ ほとんど全てのプラットフォームで使用可能な簡易な読み手/書き手モデ ルが実現されます。ロックをブロックモードとする場合(EWOULDBLOCK errno 条件)にオプションの3番目の引数に&true;を設定します。 + ロックは <function>fclose</function> でも解放されます + (スクリプトが終了した場合も自動的にコールされます) 。 </simpara> <simpara> &return.success; </simpara> + <para> + <example> + <title><function>flock</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$fp = fopen("/tmp/lock.txt", "w+"); + +if (flock($fp, LOCK_EX)) { // 排他的ロックを行う + fwrite($fp, "Write something here\n"); + flock($fp, LOCK_UN); // ロックを解放する +} else { + echo "Couldn't lock the file !"; +} + +fclose($fp); + +?> +]]> + </programlisting> + </example> + </para> <note> <para> <function>flock</function>は、ファイルポインタを必要とするため、 http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/fopen.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc-ja/reference/filesystem/functions/fopen.xml diff -u phpdoc-ja/reference/filesystem/functions/fopen.xml:1.10 phpdoc-ja/reference/filesystem/functions/fopen.xml:1.11 --- phpdoc-ja/reference/filesystem/functions/fopen.xml:1.10 Sun Jan 2 02:23:32 2005 +++ phpdoc-ja/reference/filesystem/functions/fopen.xml Sat Jul 23 03:00:45 2005 @@ -1,271 +1,272 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.24 Maintainer: hirokawa Status: ready --> -<refentry id="function.fopen"> - <refnamediv> - <refname>fopen</refname> - <refpurpose>ファイルまたはURLをオープンする</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>resource</type><methodname>fopen</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>string</type><parameter>mode</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>zcontext</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>fopen</function>は<parameter>filename</parameter>で指定された - リソースをストリームに結び付けます。 - <parameter>filename</parameter>が "スキーム://..." の形式である場合、 - それはURLとみなされ、PHPはそのプロトコルのハンドラ - （ラッパとしても知られる）を探します。 - もしもそのプロトコルに対するラッパが登録されていない場合、 - PHPはスクリプトに潜在的な問題があることを示すNOTICEを発行したうえで、 - <parameter>filename</parameter>を通常のファイルとみなして - オープンすることを試みます。 - </simpara> - <simpara> - PHPは、<parameter>filename</parameter>がローカルのファイルを示していると - みなすと、そのファイルへのストリームをオープンします。 - そのファイルはPHPからアクセスできるものでなければなりません。 - ファイルのパーミッションが（パラメータで指定された）アクセスを - 許可されているかどうか確認する必要があります。 - &safemode; または<link linkend="ini.open-basedir">open_basedir</link>を - 有効にしている場合は更なるアクセス制限が加えられることがあります。 - </simpara> - <simpara> - <parameter>filename</parameter>が登録されているプロトコルを - 示しているとPHPが判断し、かつそのプロトコルがネットワークURLとして - 登録されていれば、PHPは<link linkend="ini.allow-url-fopen">allow_url_fopen</link> - が有効となっているかどうかチェックします。 - もしこれがオフになっていると、PHPはwarningを発行しfopenは失敗します。 - </simpara> - <note> - <simpara> - サポートされているプロトコルのリストは<xref linkend="wrappers"/>にあります。 - いくつかのプロトコル（<literal>wrappers</literal>にも関連する）は - <literal>context</literal> かつ/または &php.ini; のオプションをサポートします。 - 使用するプロトコルについてセットされるオプションのリストについては - それぞれのページを見てください。（例えば、 &php.ini; 上の - <literal>user_agent</literal>の値は<literal>http</literal>ラッパが使用します） - <literal>contexts</literal>と<parameter>zcontext</parameter>引数についての - 詳細は<xref linkend="ref.stream"/>をご覧ください。 - </simpara> - </note> - &note.context-support; - <para> - パラメータ<parameter>mode</parameter> は、そのストリームに要する - アクセス形式を指定します。この指定は、下表のうちのどれかとなります。 - <table> - <title> - <function>fopen</function>で使用可能な - <parameter>mode</parameter>のリスト - </title> - <tgroup cols="2"> - <thead> - <row> - <entry><parameter>mode</parameter></entry> - <entry>説明</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>'r'</literal></entry> - <entry> - 読み込みのみでオープンします。ファイルポインタをファイルの - 先頭に置きます。 - </entry> - </row> - <row> - <entry><literal>'r+'</literal></entry> - <entry> - 読み込み／書き出し用にオープンします。ファイルポインタを - ファイルの先頭に置きます。 +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.27 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> + <refentry id="function.fopen"> + <refnamediv> + <refname>fopen</refname> + <refpurpose>ファイルまたはURLをオープンする</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>resource</type><methodname>fopen</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>string</type><parameter>mode</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>zcontext</parameter></methodparam> + </methodsynopsis> + <simpara> + <function>fopen</function>は<parameter>filename</parameter>で指定された + リソースをストリームに結び付けます。 + <parameter>filename</parameter>が "スキーム://..." の形式である場合、 + それはURLとみなされ、PHPはそのプロトコルのハンドラ + （ラッパとしても知られる）を探します。 + もしもそのプロトコルに対するラッパが登録されていない場合、 + PHPはスクリプトに潜在的な問題があることを示すNOTICEを発行したうえで、 + <parameter>filename</parameter>を通常のファイルとみなして + オープンすることを試みます。 + </simpara> + <simpara> + PHPは、<parameter>filename</parameter>がローカルのファイルを示していると + みなすと、そのファイルへのストリームをオープンします。 + そのファイルはPHPからアクセスできるものでなければなりません。 + ファイルのパーミッションが（パラメータで指定された）アクセスを + 許可されているかどうか確認する必要があります。 + &safemode; または<link linkend="ini.open-basedir">open_basedir</link>を + 有効にしている場合は更なるアクセス制限が加えられることがあります。 + </simpara> + <simpara> + <parameter>filename</parameter>が登録されているプロトコルを + 示しているとPHPが判断し、かつそのプロトコルがネットワークURLとして + 登録されていれば、PHPは<link linkend="ini.allow-url-fopen">allow_url_fopen</link> + が有効となっているかどうかチェックします。 + もしこれがオフになっていると、PHPはwarningを発行しfopenは失敗します。 + </simpara> + <note> + <simpara> + サポートされているプロトコルのリストは<xref linkend="wrappers"/>にあります。 + いくつかのプロトコル（<literal>wrappers</literal>にも関連する）は + <literal>context</literal> かつ/または &php.ini; のオプションをサポートします。 + 使用するプロトコルについてセットされるオプションのリストについては + それぞれのページを見てください （例えば、 &php.ini; 上の + <literal>user_agent</literal>の値は + <literal>http</literal>ラッパが使用します）。 + </simpara> + </note> + &note.context-support; + <note> + <simpara> + PHP4.3.2以降では、バイナリモードとテキストモードを区別する全ての + プラットフォームにおいて、デフォルトのモードはバイナリにセットされます。 + アップグレード後にスクリプトに問題が起きた場合は、 + 以上に述べたスクリプトの互換性を確保するまでの次善策として、 + <literal>'t'</literal>フラグを試してみてください。 + </simpara> + </note> + <para> + パラメータ<parameter>mode</parameter> は、そのストリームに要する + アクセス形式を指定します。この指定は、下表のうちのどれかとなります。 + <table> + <title> + <function>fopen</function>で使用可能な + <parameter>mode</parameter>のリスト + </title> + <tgroup cols="2"> + <thead> + <row> + <entry><parameter>mode</parameter></entry> + <entry>説明</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>'r'</literal></entry> + <entry> + 読み込みのみでオープンします。ファイルポインタをファイルの + 先頭に置きます。 </entry> - </row> - <row> - <entry><literal>'w'</literal></entry> - <entry> - 書き出しのみでオープンします。ファイルポインタをファイルの - 先頭に置き、ファイルサイズをゼロにします。ファイルが存在しない - 場合には、作成を試みます。 - </entry> - </row> - <row> - <entry><literal>'w+'</literal></entry> - <entry> - 読み込み／書き出し用でオープンします。ファイルポインタを - ファイルの先頭に置き、ファイルサイズをゼロにします。 - ファイルが存在しない場合には、作成を試みます。 - </entry> - </row> - <row> - <entry><literal>'a'</literal></entry> - <entry> - 書き出し用のみでオープンします。ファイルポインタをファイルの - 終端に置きます。ファイルが存在しない場合には、作成を試みます。 - </entry> - </row> - <row> - <entry><literal>'a+'</literal></entry> - <entry> - 読み込み／書き出し用でオープンします。ファイルポインタを - ファイルの終端に置きます。ファイルが存在しない場合には、作成を - 試みます。 - </entry> - </row> - <row> - <entry><literal>'x'</literal></entry> - <entry> - 書き込みのみでオープンします。ファイルポインタをファイルの先頭に置きます。 - ファイルが既に存在する場合には<function>fopen</function>は失敗し、 - <constant>E_WARNING</constant>レベルのエラーを発行します。 - ファイルが存在しない場合には新規作成を試みます。 - これは<literal>open(2)</literal>システムコールにおける - <literal>O_EXCL|O_CREAT</literal>フラグの指定と等価です。 - このオプションはPHP4.3.2以降でサポートされ、また、 - ローカルファイルに対してのみ有効です。 - </entry> - </row> - <row> - <entry><literal>'x+'</literal></entry> - <entry> - 読み込み／書き出し用でオープンします。ファイルポインタをファイルの先頭に置きます。 - ファイルが既に存在する場合には<function>fopen</function>は失敗し、 - <constant>E_WARNING</constant>レベルのエラーを発行します。 - これは<literal>open(2)</literal>システムコールにおける - <literal>O_EXCL|O_CREAT</literal>フラグの指定と等価です。 - このオプションはPHP4.3.2以降でサポートされ、また、 - ローカルファイルに対してのみ有効です。 - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <note> - <para> - オペレーティングシステムファミリが異なると行末も異なります。 - テキストファイルに書き出し、そこに改行を加えたいとき、 - オペレーティングシステムにあわせた正しい改行コードを使用する必要があります。 - UNIXベースのシステムでは改行に<literal>\n</literal>キャラクタを使用します。 - Windowsベースのシステムでは<literal>\r\n</literal>を使用します。 - マッキントッシュベースのシステムでは<literal>\r</literal>を使用します。 - </para> - <para> - 間違った改行コードでファイルに書き込むと、他のアプリケーション上でそのファイルを - 開いた際に変な風に見えてしまいます。 - </para> - <para> - Windows上では、<literal>\n</literal>を<literal>\r\n</literal>に透過的に変換する - text-mode変換フラグ(<literal>'t'</literal>)が提供されます。 - それに対し、<literal>'b'</literal>を使って強制的にバイナリモードにすることもできます。 - その場合データの変換はされません。 - このフラグを使用するには、<literal>'b'</literal> または <literal>'t'</literal>を - <parameter>mode</parameter>引数の最後に追加してください。 - </para> - <para> - デフォルトの変換モードはSAPIと使用しているPHPのバージョンによって異なります。 - したがって、互換性の意味から、常に適切なフラグを指定することが推奨されます。 - plain-textファイルを使用する場合には<literal>'t'</literal>モードを指定すべきであり、 - 改行に<literal>\n</literal>を使用すると、 - メモ帳のようなアプリケーションで読めることを期待できます。 - それ以外のケースでは<literal>'b'</literal>を使うべきです。 - </para> - <para> - バイナリファイルを扱っているのに<literal>'b'</literal>フラグを指定しなかった場合、 - 画像ファイルが壊れたり、<literal>\r\n</literal>キャラクタがおかしくなる等の - 問題を抱えてしまうでしょう。 - </para> - <para> - <emphasis> - 互換性維持のために、<function>fopen</function>でファイルをオープンする際は - 常に<literal>'b'</literal>フラグを指定することが強く推奨されます。 - </emphasis> - </para> - <para> - <emphasis> - 互換性維持のために、<literal>'t'</literal>モードを使用または依存している - コードを書き直し、正しい改行コードと<literal>'b'</literal>モードを代わりに - 使用することが、強く推奨されます。 - </emphasis> - </para> - <para> - <emphasis> - PHP4.3.2以降では、バイナリモードとテキストモードを区別する全ての - プラットフォームにおいて、デフォルトのモードはバイナリにセットされます。 - アップグレード後にスクリプトに問題が起きた場合は、 - 以上に述べたスクリプトの互換性を確保するまでの次善策として、 - <literal>'t'</literal>フラグを試してみてください。 - </emphasis> - </para> - </note> - <para> - オプションの３番目の引数<parameter>use_include_path</parameter>に'1'又は - &true; を設定することにより、<link linkend="ini.include-path">include_path</link> - のファイルの検索も行うこともできます。 - </para> - <simpara> - If the open fails, the function returns &false; and an error of - level <constant>E_WARNING</constant> is generated. You may use - <link linkend="language.operators.errorcontrol">@</link> to - suppress this warning. - オープンが失敗すると、関数は &false; を返し、<constant>E_WARNING</constant> - レベルのエラーを発行します。<link linkend="language.operators.errorcontrol">@</link> - を使ってこのwarningを抑制することもできます。 - </simpara> - <para> - <example> - <title><function>fopen</function> の例</title> - <programlisting role="php"> + </row> + <row> + <entry><literal>'r+'</literal></entry> + <entry> + 読み込み／書き出し用にオープンします。ファイルポインタを + ファイルの先頭に置きます。 + </entry> + </row> + <row> + <entry><literal>'w'</literal></entry> + <entry> + 書き出しのみでオープンします。ファイルポインタをファイルの + 先頭に置き、ファイルサイズをゼロにします。ファイルが存在しない + 場合には、作成を試みます。 + </entry> + </row> + <row> + <entry><literal>'w+'</literal></entry> + <entry> + 読み込み／書き出し用でオープンします。ファイルポインタを + ファイルの先頭に置き、ファイルサイズをゼロにします。 + ファイルが存在しない場合には、作成を試みます。 + </entry> + </row> + <row> + <entry><literal>'a'</literal></entry> + <entry> + 書き出し用のみでオープンします。ファイルポインタをファイルの + 終端に置きます。ファイルが存在しない場合には、作成を試みます。 + </entry> + </row> + <row> + <entry><literal>'a+'</literal></entry> + <entry> + 読み込み／書き出し用でオープンします。ファイルポインタを + ファイルの終端に置きます。ファイルが存在しない場合には、作成を + 試みます。 + </entry> + </row> + <row> + <entry><literal>'x'</literal></entry> + <entry> + 書き込みのみでオープンします。ファイルポインタをファイルの先頭に置きます。 + ファイルが既に存在する場合には<function>fopen</function>は失敗し、 + <constant>E_WARNING</constant>レベルのエラーを発行します。 + ファイルが存在しない場合には新規作成を試みます。 + これは<literal>open(2)</literal>システムコールにおける + <literal>O_EXCL|O_CREAT</literal>フラグの指定と等価です。 + このオプションはPHP4.3.2以降でサポートされ、また、 + ローカルファイルに対してのみ有効です。 + </entry> + </row> + <row> + <entry><literal>'x+'</literal></entry> + <entry> + 読み込み／書き出し用でオープンします。ファイルポインタをファイルの先頭に置きます。 + ファイルが既に存在する場合には<function>fopen</function>は失敗し、 + <constant>E_WARNING</constant>レベルのエラーを発行します。 + これは<literal>open(2)</literal>システムコールにおける + <literal>O_EXCL|O_CREAT</literal>フラグの指定と等価です。 + このオプションはPHP4.3.2以降でサポートされ、また、 + ローカルファイルに対してのみ有効です。 + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <note> + <para> + オペレーティングシステムファミリが異なると行末も異なります。 + テキストファイルに書き出し、そこに改行を加えたいとき、 + オペレーティングシステムにあわせた正しい改行コードを使用する必要があります。 + UNIXベースのシステムでは改行に<literal>\n</literal>キャラクタを使用します。 + Windowsベースのシステムでは<literal>\r\n</literal>を使用します。 + マッキントッシュベースのシステムでは<literal>\r</literal>を使用します。 + </para> + <para> + 間違った改行コードでファイルに書き込むと、他のアプリケーション上でそのファイルを + 開いた際に変な風に見えてしまいます。 + </para> + <para> + Windows上では、<literal>\n</literal>を<literal>\r\n</literal>に透過的に変換する + text-mode変換フラグ(<literal>'t'</literal>)が提供されます。 + それに対し、<literal>'b'</literal>を使って強制的にバイナリモードにすることもできます。 + その場合データの変換はされません。 + このフラグを使用するには、<literal>'b'</literal> または <literal>'t'</literal>を + <parameter>mode</parameter>引数の最後に追加してください。 + </para> + <para> + デフォルトの変換モードはSAPIと使用しているPHPのバージョンによって異なります。 + したがって、互換性の意味から、常に適切なフラグを指定することが推奨されます。 + plain-textファイルを使用する場合には<literal>'t'</literal>モードを指定すべきであり、 + 改行に<literal>\n</literal>を使用すると、 + メモ帳のようなアプリケーションで読めることを期待できます。 + それ以外のケースでは<literal>'b'</literal>を使うべきです。 + </para> + <para> + バイナリファイルを扱っている際に + <literal>'b'</literal> フラグを指定しなかった場合、 + 画像ファイルが壊れたり、<literal>\r\n</literal> + キャラクタがおかしくなる等の問題を抱えてしまうでしょう。 + </para> + </note> + <note> + <para> + 互換性維持のために、<function>fopen</function>でファイルをオープンする際は + 常に<literal>'b'</literal>フラグを指定することが強く推奨されます。 + </para> + </note> + <note> + <para> + 互換性維持のために、<literal>'t'</literal>モードを使用または依存している + コードを書き直し、正しい改行コードと<literal>'b'</literal>モードを代わりに + 使用することが、強く推奨されます。 + </para> + </note> + <para> + オプションの３番目の引数<parameter>use_include_path</parameter>に'1'又は + &true; を設定することにより、<link linkend="ini.include-path">include_path</link> + のファイルの検索も行うこともできます。 + </para> + <simpara> + オープンが失敗すると、関数は &false; を返し、 + <constant>E_WARNING</constant> + レベルのエラーを発行します。 + <link linkend="language.operators.errorcontrol">@</link> + を使ってこのwarningを抑制することもできます。 + </simpara> + <para> + <example> + <title><function>fopen</function> の例</title> + <programlisting role="php"> <![CDATA[ <?php -$handle = fopen ("/home/rasmus/file.txt", "r"); -$handle = fopen ("/home/rasmus/file.gif", "wb"); -$handle = fopen ("http://www.example.com/", "r"); -$handle = fopen ("ftp://user:password@example.com/somefile.txt", "w"); +$handle = fopen("/home/rasmus/file.txt", "r"); +$handle = fopen("/home/rasmus/file.gif", "wb"); +$handle = fopen("http://www.example.com/", "r"); +$handle = fopen("ftp://user:password@example.com/somefile.txt", "w"); ?> ]]> - </programlisting> - </example> - </para> - <simpara> - ファイルの読みこみ・書きこみ時に問題が発生し、 - サーバーモジュール版のPHPを使用している場合、 - 使用するファイル・ディレクトリがサーバープロセスからアクセス可能 - かどうかを確認してみてください。 - </simpara> - <para> - Windows 環境では、ファイルパスで用いる全てのバックスラッシュを - エスケープするかフォワードスラッシュを使用することに注意してください。 - <informalexample> - <programlisting role="php"> + </programlisting> + </example> + </para> + <simpara> + ファイルの読みこみ・書きこみ時に問題が発生し、 + サーバーモジュール版のPHPを使用している場合、 + 使用するファイル・ディレクトリがサーバープロセスからアクセス可能 + かどうかを確認してみてください。 + </simpara> + <para> + Windows 環境では、ファイルパスで用いる全てのバックスラッシュを + エスケープするかフォワードスラッシュを使用することに注意してください。 + <informalexample> + <programlisting role="php"> <![CDATA[ <?php -$handle = fopen ("c:\\data\\info.txt", "r"); +$handle = fopen("c:\\data\\info.txt", "r"); ?> ]]> - </programlisting> - </informalexample> - </para> - <simpara> - <xref linkend="wrappers"/>, - <function>fclose</function>, - <function>fgets</function>, - <function>fread</function>, - <function>fwrite</function>, - <function>fsockopen</function>, - <function>file</function>, - <function>file_exists</function>, - <function>is_readable</function>, - <function>stream_set_timeout</function>, - <function>popen</function> - も参照ください。 - </simpara> - </refsect1> -</refentry> + </programlisting> + </informalexample> + </para> + &warn.ssl-non-standard; + &note.sm.uidcheck.dir; + <simpara> + <xref linkend="wrappers"/>, + <function>fclose</function>, + <function>fgets</function>, + <function>fread</function>, + <function>fwrite</function>, + <function>fsockopen</function>, + <function>file</function>, + <function>file_exists</function>, + <function>is_readable</function>, + <function>stream_set_timeout</function>, + <function>popen</function> + も参照ください。 + </simpara> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/fpassthru.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/reference/filesystem/functions/fpassthru.xml diff -u phpdoc-ja/reference/filesystem/functions/fpassthru.xml:1.5 phpdoc-ja/reference/filesystem/functions/fpassthru.xml:1.6 --- phpdoc-ja/reference/filesystem/functions/fpassthru.xml:1.5 Sun Jan 2 02:23:32 2005 +++ phpdoc-ja/reference/filesystem/functions/fpassthru.xml Sat Jul 23 03:00:45 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.fpassthru"> <refnamediv> <refname>fpassthru</refname> @@ -23,17 +25,11 @@ それ以外の場合、<function>fpassthru</function>は<parameter>handle</parameter> から読み込んだ文字の数を返し、出力へパスします。 </simpara> + &fs.validfp.all; <simpara> - ファイルポインタは有効なものでなければならず、また - <function>fopen</function>, <function>popen</function> - または<function>fsockopen</function> - で正常にオープンされたファイルを指している必要があります。 - ファイルに既にデータを書き終えている場合には、 + ファイルに既にデータを書き終えている場合で ファイルポインタをファイルの先頭にリセットするには - <function>rewind</function>をコールする必要があります。 - <function>fpassthru</function>はファイルを読み終えると - そのファイルをクローズします（残った<parameter>handle</parameter> - はもはや使用できません）。 + <function>rewind</function> をコールする必要があります。 </simpara> <simpara> ファイルを更新したり特定のオフセットを探すのではなく @@ -49,6 +45,31 @@ オープンするようにしてください。 </para> </note> + <para> + <example> + <title>バイナリファイルに対する <function>fpassthru</function> + の使用例</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// バイナリモードでファイルをオープンする +$name = ".\public\dev\img\ok.png"; +$fp = fopen($name, 'rb'); + +// 正しいヘッダを送出する +header("Content-Type: image/png"); +header("Content-Length: " . filesize($name)); + +// 画像をダンプしスクリプトを終了する +fpassthru($fp); +exit; + +?> +]]> + </programlisting> + </example> + </para> <simpara> <function>readfile</function>, <function>fopen</function>, <function>popen</function>, <function>fsockopen</function> http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/fscanf.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/reference/filesystem/functions/fscanf.xml diff -u phpdoc-ja/reference/filesystem/functions/fscanf.xml:1.5 phpdoc-ja/reference/filesystem/functions/fscanf.xml:1.6 --- phpdoc-ja/reference/filesystem/functions/fscanf.xml:1.5 Sun Jan 2 02:23:32 2005 +++ phpdoc-ja/reference/filesystem/functions/fscanf.xml Sat Jul 23 03:00:45 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.16 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.fscanf"> <refnamediv> <refname>fscanf</refname> @@ -12,13 +14,15 @@ <type>mixed</type><methodname>fscanf</methodname> <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter role="reference">...</parameter></methodparam> </methodsynopsis> <para> 関数<function>fscanf</function> は <function>sscanf</function> に 似ていますが、<parameter>handle</parameter>が指すファイルから入力 を取得し、指定したフォーマット <parameter>format</parameter>に基 - づき解釈を行います。この関数のパラメータが二つだけの場合、処理さ + づき解釈を行います。フォーマットについては <function>sprintf</function> + に解説されています。 + この関数のパラメータが二つだけの場合、処理さ れた値は配列として返されます。他方、オプションのパラメータが指定 された場合、この関数は、代入された値の数を返します。オプション引 数は参照渡しとする必要があります。 @@ -34,21 +38,23 @@ <title><function>fscanf</function>の例</title> <programlisting role="php"> <![CDATA[ -$fp = fopen ("users.txt","r"); -while ($userinfo = fscanf ($fp,"%s\t%s\t%s\n")) { +<?php +$handle = fopen("users.txt", "r"); +while ($userinfo = fscanf($handle, "%s\t%s\t%s\n")) { list ($name, $profession, $countrycode) = $userinfo; - //... 値を用いた処理 + //... これらの値を使用して何か行う } -fclose($fp); +fclose($handle); +?> ]]> </programlisting> </example> <example> - <title>users.txt</title> - <programlisting> + <title>users.txt の内容</title> + <programlisting role="txt"> <![CDATA[ -javier argonaut pe -hiroshi sculptor jp +javier argonaut pe +hiroshi sculptor jp robert slacker us luigi florist it ]]> @@ -63,7 +69,7 @@ </simpara> </note> <para> - <function>fread</function>, + <function>fread</function>, <function>fgets</function>, <function>fgetss</function>, <function>sscanf</function>, <function>printf</function>, <function>sprintf</function> も参照ください。 http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/fseek.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/reference/filesystem/functions/fseek.xml diff -u phpdoc-ja/reference/filesystem/functions/fseek.xml:1.5 phpdoc-ja/reference/filesystem/functions/fseek.xml:1.6 --- phpdoc-ja/reference/filesystem/functions/fseek.xml:1.5 Sun Jan 2 02:23:32 2005 +++ phpdoc-ja/reference/filesystem/functions/fseek.xml Sat Jul 23 03:00:45 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.fseek"> <refnamediv> <refname>fseek</refname> @@ -29,29 +31,58 @@ <constant>SEEK_CUR</constant> - 現在の位置に<parameter>offset</parameter>を加えた位置に設定する。 </member> <member> - <constant>SEEK_END</constant> - ファイル終端に<parameter>offset</parameter>を加えた位置に設定する + <constant>SEEK_END</constant> - ファイル終端に<parameter>offset</parameter>を加えた位置に設定する （ファイル終端よりも手前に設定する場合、 <parameter>offset</parameter>に負の値をセットする必要があります） </member> </simplelist> - </para> <para> - <parameter>whence</parameter>を指定しない場合、SEEK_SETが指定された - と仮定します。 + <parameter>whence</parameter>を指定しない場合、 + <constant>SEEK_SET</constant> が指定されたと仮定します。 </para> <para> 成功すると0を返し、そうでなければ-1を返します。EOFより先の - 位置にシークしてもエラーとはならないので注意してください。</para> + 位置にシークしてもエラーとはならないので注意してください。 + </para> + <para> + <example> + <title><function>fseek</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$fp = fopen('somefile.txt'); + +// データを読み込む +$data = fgets($fp, 4096); + +// ファイルの先頭に移動する。 +// rewind($fp); と等価。 +fseek($fp, 0); + +?> +]]> + </programlisting> + </example> + </para> <para> "http://"または"ftp://"フォーマット指定の<function>fopen </function>により返されたファイルポインタに対しては使わないでください。 + <function>fseek</function> は、("a" フラグ付きでオープンされた) + 追加のみ可能なストリームに対する結果も未定義です。 </para> <note> <para> 引数<parameter>whence</parameter>はPHP 4.0.0以降で追加されました。 </para> </note> + <note> + <para> + 追加モード ("a" or "a+") でファイルをオープンした場合、 + ファイル位置によらず、ファイルに書き込むあらゆるデータが追加されます。 + </para> + </note> <para> <function>ftell</function>および<function>rewind</function>も参照ください。 </para> http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/fstat.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/reference/filesystem/functions/fstat.xml diff -u phpdoc-ja/reference/filesystem/functions/fstat.xml:1.5 phpdoc-ja/reference/filesystem/functions/fstat.xml:1.6 --- phpdoc-ja/reference/filesystem/functions/fstat.xml:1.5 Mon Nov 22 23:45:33 2004 +++ phpdoc-ja/reference/filesystem/functions/fstat.xml Sat Jul 23 03:00:45 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.12 --> -<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.fstat"> <refnamediv> <refname>fstat</refname> @@ -24,9 +26,52 @@ ファイルの統計情報の配列を返します。配列のフォーマットについては <function>stat</function>のマニュアルをご覧ください。 </para> - - &note.clearstatcache; - + <para> + <example> + <title><function>fstat</function> の例</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// ファイルをオープンする +$fp = fopen("/etc/passwd", "r"); + +// 統計情報を収集する +$fstat = fstat($fp); + +// ファイルをクローズする +fclose($fp); + +// 連想配列部のみ表示する +print_r(array_slice($fstat, 13)); + +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Array +( + [dev] => 771 + [ino] => 488704 + [mode] => 33188 + [nlink] => 1 + [uid] => 0 + [gid] => 0 + [rdev] => 0 + [size] => 1114 + [atime] => 1061067181 + [mtime] => 1056136526 + [ctime] => 1056136526 + [blksize] => 4096 + [blocks] => 8 +) +]]> + </screen> + </example> + </para> + &note.no-remote; </refsect1> http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/ftell.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/reference/filesystem/functions/ftell.xml diff -u phpdoc-ja/reference/filesystem/functions/ftell.xml:1.5 phpdoc-ja/reference/filesystem/functions/ftell.xml:1.6 --- phpdoc-ja/reference/filesystem/functions/ftell.xml:1.5 Sun Jan 2 02:23:32 2005 +++ phpdoc-ja/reference/filesystem/functions/ftell.xml Sat Jul 23 03:00:46 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.ftell"> <refnamediv> <refname>ftell</refname> @@ -23,6 +25,29 @@ ファイルポインタは有効なものでなければならず、また <function>fopen</function>、<function>popen</function> で正常にオープンされたファイルを指している必要があります。 + <function>ftell</function> は、("a" フラグ付きでオープンされた) + 追加のみ可能なストリームに対する結果も未定義です。 + </para> + <para> + <example> + <title><function>ftell</function> の例</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// ファイルをオープンし、データを読み込む +$fp = fopen("/etc/passwd", "r"); +$data = fgets($fp, 12); + +// どこにいるんだ ? +echo ftell($fp); // 11 + +fclose($fp); + +?> +]]> + </programlisting> + </example> </para> <para> <function>fopen</function>, http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/ftruncate.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/filesystem/functions/ftruncate.xml diff -u phpdoc-ja/reference/filesystem/functions/ftruncate.xml:1.4 phpdoc-ja/reference/filesystem/functions/ftruncate.xml:1.5 --- phpdoc-ja/reference/filesystem/functions/ftruncate.xml:1.4 Mon Nov 22 23:45:33 2004 +++ phpdoc-ja/reference/filesystem/functions/ftruncate.xml Sat Jul 23 03:00:46 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.5 --> -<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.ftruncate"> <refnamediv> <refname>ftruncate</refname> @@ -21,6 +23,13 @@ </para> <note> <para> + ファイルポインタは <emphasis>追加</emphasis> モードの時のみ変更されます。 + <emphasis>書き込み</emphasis> モードの場合、 + <function>fseek</function> を追加でコールする必要があります。 + </para> + </note> + <note> + <para> PHP 4.3.3未満では、 <function>ftruncate</function>は成功の場合に <type>boolean</type>の &true; ではなく <type>integer</type>の 1 を返します。 http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/fwrite.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/reference/filesystem/functions/fwrite.xml diff -u phpdoc-ja/reference/filesystem/functions/fwrite.xml:1.5 phpdoc-ja/reference/filesystem/functions/fwrite.xml:1.6 --- phpdoc-ja/reference/filesystem/functions/fwrite.xml:1.5 Sun Jan 2 02:23:32 2005 +++ phpdoc-ja/reference/filesystem/functions/fwrite.xml Sat Jul 23 03:00:46 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.13 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.fwrite"> <refnamediv> <refname>fwrite</refname> @@ -42,9 +44,9 @@ </note> <para> <example> - <title>fwrite の簡単な例</title> + <title><function>fwrite</function> の簡単な例</title> <programlisting role="php"> -<![CDATA[ +<![CDATA[ <?php $filename = 'test.txt'; $somecontent = "Add this to the file\n"; @@ -56,22 +58,22 @@ // ファイルポインタはファイルの終端になりますので // そこがfwrite()で$somecontentが追加される位置になります。 if (!$handle = fopen($filename, 'a')) { - print "Cannot open file ($filename)"; + echo "Cannot open file ($filename)"; exit; } // オープンしたファイルに$somecontentを書き込みます - if (!fwrite($handle, $somecontent)) { - print "Cannot write to file ($filename)"; + if (fwrite($handle, $somecontent) === FALSE) { + echo "Cannot write to file ($filename)"; exit; } - - print "Success, wrote ($somecontent) to file ($filename)"; - + + echo "Success, wrote ($somecontent) to file ($filename)"; + fclose($handle); - + } else { - print "The file $filename is not writable"; + echo "The file $filename is not writable"; } ?> ]]> @@ -79,9 +81,12 @@ </example> </para> <simpara> - <function>fread</function>, <function>fopen</function>, - <function>fsockopen</function>, <function>popen</function>, - <function>fputs</function>も参照ください。 + <function>fread</function>, + <function>fopen</function>, + <function>fsockopen</function>, + <function>popen</function>, + <function>file_put_contents</function> + も参照ください。 </simpara> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/is-dir.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/filesystem/functions/is-dir.xml diff -u phpdoc-ja/reference/filesystem/functions/is-dir.xml:1.4 phpdoc-ja/reference/filesystem/functions/is-dir.xml:1.5 --- phpdoc-ja/reference/filesystem/functions/is-dir.xml:1.4 Mon Nov 22 23:45:33 2004 +++ phpdoc-ja/reference/filesystem/functions/is-dir.xml Sat Jul 23 03:00:46 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.is-dir"> <refnamediv> <refname>is_dir</refname> @@ -18,14 +20,35 @@ <parameter>filename</parameter>は相対的なファイル名です。 カレントディレクトリから相対的にチェックされます。 </para> - &note.clearstatcache; - - &note.no-remote; + <para> + <example> + <title><function>is_dir</function> の例</title> + <programlisting role="php"> +<![CDATA[ +<? +var_dump(is_dir('a_file.txt')) . "\n"; +var_dump(is_dir('bogus_dir/abc')) . "\n"; + +var_dump(is_dir('..')); //一つ上のディレクトリ +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +bool(false) +bool(false) +bool(true) +]]> + </screen> + </example> + </para> + &tip.fopen-wrapper.stat; <para> <function>chdir</function>, <link linkend="class.dir">dir</link>, - <function>opendir</function>, <function>is_file</function> + <function>opendir</function>, <function>is_file</function> <function>is_link</function>も参照してください。 </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/is-executable.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-ja/reference/filesystem/functions/is-executable.xml diff -u phpdoc-ja/reference/filesystem/functions/is-executable.xml:1.6 phpdoc-ja/reference/filesystem/functions/is-executable.xml:1.7 --- phpdoc-ja/reference/filesystem/functions/is-executable.xml:1.6 Sun Jan 2 02:23:32 2005 +++ phpdoc-ja/reference/filesystem/functions/is-executable.xml Sat Jul 23 03:00:46 2005 @@ -1,36 +1,59 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> -<refentry id="function.is-executable"> - <refnamediv> - <refname>is_executable</refname> - <refpurpose>ファイルが実行可能かどうかを調べる</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>is_executable</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <parameter>filename</parameter>が存在しかつ実行可能であれば - &true;を返します。 - </para> - <para> - <function>is_executable</function>は PHP - version 5.0.0 においてWindows上でも使用可能になります - </para> - - &note.clearstatcache; - - &note.no-remote; - - <para> - <function>is_file</function>および<function>is_link</function> - も参照ください。 - </para> - </refsect1> -</refentry> +<!-- EN-Revision: 1.12 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> + <refentry id="function.is-executable"> + <refnamediv> + <refname>is_executable</refname> + <refpurpose>ファイルが実行可能かどうかを調べる</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <methodsynopsis> + <type>bool</type><methodname>is_executable</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <parameter>filename</parameter>が存在しかつ実行可能であれば + &true;を返します。 + </para> + <para> + <function>is_executable</function>は PHP + version 5.0.0 において <productname>Windows</productname> + 上でも使用可能になりました。 + </para> + <para> + <example> + <title><function>is_executable</function> の例</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$file = '/home/vincent/somefile.sh'; + +if (is_executable($file)) { + echo $file.' is executable'; +} else { + echo $file.' is not executable'; +} + +?> +]]> + </programlisting> + </example> + </para> + + &note.clearstatcache; + + &tip.fopen-wrapper.stat; + + <para> + <function>is_file</function>および<function>is_link</function> + も参照ください。 + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/is-file.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/reference/filesystem/functions/is-file.xml diff -u phpdoc-ja/reference/filesystem/functions/is-file.xml:1.5 phpdoc-ja/reference/filesystem/functions/is-file.xml:1.6 --- phpdoc-ja/reference/filesystem/functions/is-file.xml:1.5 Sun Jan 2 02:23:32 2005 +++ phpdoc-ja/reference/filesystem/functions/is-file.xml Sat Jul 23 03:00:46 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.is-file"> <refnamediv> <refname>is_file</refname> @@ -16,10 +18,30 @@ <parameter>filename</parameter>が存在して、かつそれが 通常ファイルであれば&true;を返します。 </para> + <para> + <example> + <title><function>is_file</function> の例</title> + <programlisting role="php"> +<![CDATA[ +<?php +var_dump(is_file('a_file.txt')) . "\n"; +var_dump(is_file('/usr/bin/')) . "\n"; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +bool(true) +bool(false) +]]> + </screen> + </example> + </para> &note.clearstatcache; - - &note.no-remote; + + &tip.fopen-wrapper.stat; <para> <function>is_dir</function>および<function>is_link</function> http://cvs.php.net/diff.php/phpdoc-ja/reference/filesystem/functions/is-link.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/filesystem/functions/is-link.xml diff -u phpdoc-ja/reference/filesystem/functions/is-link.xml:1.4 phpdoc-ja/reference/filesystem/functions/is-link.xml:1.5 --- phpdoc-ja/reference/filesystem/functions/is-link.xml:1.4 Mon Nov 22 23:45:33 2004 +++ phpdoc-ja/reference/filesystem/functions/is-link.xml Sat Jul 23 03:00:46 2005 @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/filesystem.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: shimooka --> <refentry id="function.is-link"> <refnamediv> <refname>is_link</refname> @@ -15,14 +17,13 @@ <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> - <parameter>filename</parameter>が存在し、かつシンボリックリンクで - あれば&true;を返します。 + filename が存在し、かつシンボリックリンクであれば&true;を返します。 </para> - + &note.clearstatcache; - - &note.no-remote; - + + &tip.fopen-wrapper.stat; + <para> <function>is_dir</function>, <function>is_file</function>,