fgetc

関数の概要

PHPの fgetc 関数は、ファイルポインタが指すファイルから1文字ずつ読み込むための関数です。主にテキストファイルの内容を文字単位で処理したい場合に便利です。ファイルから一文字ずつ読み取ることで、細かい解析やカスタム処理が可能になります。

パラメータの説明

  • resource $handle：必須。読み込み対象のファイルハンドル。fopenなどで開いたファイルリソースを指定します。

戻り値

ファイルから読み込んだ1文字を文字列（長さ1の文字）として返します。読み込む文字がもう無い場合やエラー時には false を返します。

使用例

基本的な使い方

<?php
$fp = fopen("sample.txt", "r");
if ($fp) {
    while (($char = fgetc($fp)) !== false) {
        echo $char;
    }
    fclose($fp);
} else {
    echo "ファイルを開けませんでした。";
}
?>

この例ではファイルを開き、fgetcで1文字ずつ読み取りながら出力しています。ファイルの末尾に達するとループは終了します。

改行を検知して行ごとに区切る処理

<?php
$fp = fopen("sample.txt", "r");
if ($fp) {
    $line = "";
    while (($char = fgetc($fp)) !== false) {
        if ($char === "n") {
            echo "行の内容: " . $line . "<br>";
            $line = "";
        } else {
            $line .= $char;
        }
    }
    if ($line !== "") {
        echo "行の内容: " . $line . "<br>";
    }
    fclose($fp);
} else {
    echo "ファイルを開けませんでした。";
}
?>

ここでは文字を読み込みながら改行コードで区切り、1行ごとに出力しています。改行を境に行単位の文字列を組み立てます。

特定の文字をカウントする例

<?php
$fp = fopen("sample.txt", "r");
$count = 0;
if ($fp) {
    while (($char = fgetc($fp)) !== false) {
        if ($char === "a") {
            $count++;
        }
    }
    fclose($fp);
    echo "'a' の文字数は " . $count . " です。";
} else {
    echo "ファイルを開けませんでした。";
}
?>

ファイル内の文字’a’の出現回数を数える例です。ファイルを1文字ずつ読込みながら条件判定を行っています。

関連する関数

  • fgets：ファイルから1行単位で読み込みます。
  • fread：ファイルから指定したバイト数を読み込みます。
  • fopen：ファイルを開くための関数です。
  • feof：ファイルポインタがファイル終端に達しているか判定します。

まとめ

fgetc はファイルから1文字ずつ読み込みたい場合に非常に便利な関数です。文字単位でファイル内容を精密に扱いたい時に使い、テキスト解析や特定文字のカウントなど応用が可能です。
ファイル操作では必ずファイルのオープンとクローズを忘れずに行い、安全に扱うことが重要です。
今回紹介した使い方を参考に、文字単位での柔軟なファイル処理を実装してみてください。

スポンサーリンク