ftell

ファイルの読み書き用ポインタの現在位置を返す

説明

intfalse ftell(resource $stream)

stream ファイルの読み書き用ポインタの現在位置を返します。

パラメータ

stream

ファイルポインタは有効なものでなければならず、また fopenpopen で正常にオープンされたファイルを指している必要があります。 ftell は、("a" フラグ付きでオープンされた) 追加のみ可能なストリームに対する結果も未定義です。

戻り値

stream が示すファイルポインタの位置、 すなわちファイル・ストリーム上のオフセットを整数値で返します。

エラーが起こった場合 false を返します。

注意: PHP の数値型は符号付整数であり、 多くのプラットフォームでは 32 ビットの整数を取るため、 ファイルシステム関数の中には 2GB より大きなファイルについては期待とは違う値を返すものがあります。

例1 ftell の例

<?php

// ファイルをオープンし、データを読み込む
$fp = fopen("/etc/passwd", "r");
$data = fgets($fp, 12);

// どこにいるんだ ?
echo ftell($fp); // 11

fclose($fp);

?>

参考

  • fopen
  • popen
  • fseek
  • rewind