PHPのftell()関数とは？ファイルポインタの現在位置を取得する方法

ftell()関数は、fopen()で開いたファイル内における現在の読み書き位置（ファイルポインタの位置）を取得するための関数です。正常に処理できた場合は現在のポインタ位置を整数で返し、失敗した場合はFALSEを返します。

基本構文

ftell(file_pointer)

パラメータ

• file_pointer − fopen()を使って作成したファイルポインタを指定します。必須の引数です。

戻り値

現在のファイルポインタの位置（先頭からのバイト数）を整数で返します。エラーが発生した場合はFALSEを返します。

使用例1：ファイルを開いた直後の位置を確認する

ファイルを読み込みモードで開いた直後は、ポインタは必ず先頭（0バイト目）にあります。以下の例で確認してみましょう。

<?php
    $file_pointer = fopen("new.txt", "r");
    echo ftell($file_pointer);
    fclose($file_pointer);
?>

出力結果

0

このように、新しく開いたファイルではポインタ位置が「0」と表示されます。

使用例2：fseek()で位置を移動してから確認する

次に、fseek()を使ってポインタ位置を変更した後に、ftell()でその位置を取得する例を見てみましょう。

<?php
    $file_pointer = fopen("new.txt", "r");

    // ポインタ位置を10バイト目へ移動
    fseek($file_pointer, 10);

    // 現在のポインタ位置を表示
    echo ftell($file_pointer);

    fclose($file_pointer);
?>

出力結果

10

fseek()で10バイト目に移動したため、ftell()は現在の位置である「10」を返しています。

まとめ

ftell()は、ファイル操作の進行状況を把握したり、fseek()と組み合わせて特定の位置からデータを読み書きしたりする際に便利な関数です。なお、fseek()の第2引数には数値（オフセット）を指定するのが正しい使い方なので、実装時には文字列ではなく整数を渡すようにしましょう。