初心者向け解説：PHP vfprintf 関数でフォーマットされた文字列を書き込む

PHP vfprintf 関数：可変引数でフォーマットされた文字列をストリームに書き込む

vfprintf 関数は、printf 関数と似ていますが、可変引数ではなく、フォーマット文字列と引数の配列を受け取ります。これは、複数の変数をフォーマットされた文字列に挿入したい場合に便利です。

構文

int vfprintf(resource $handle, string $format, array $args): int

引数

• handle: 書き込み先のストリームリソース。ファイルポインタ、標準出力ストリーム (STDOUT) などが指定できます。
• format: フォーマット文字列。printf 関数と同じフォーマット指定子を 사용할 수 있습니다。
• args: フォーマット文字列に挿入される引数の配列。

返り値

書き込まれた文字列の長さを返します。

例

$name = "John Doe";
$age = 30;

$fp = fopen("output.txt", "w");

vfprintf($fp, "Hello, %s! You are %d years old.\n", [$name, $age]);

fclose($fp);

この例では、vfprintf 関数は output.txt ファイルに次の文字列を書き込みます。

Hello, John Doe! You are 30 years old.

フォーマット指定子

vfprintf 関数は、printf 関数と同じフォーマット指定子を 사용할 수 있습니다。

補足

• vfprintf 関数は、printf 関数よりも柔軟性が高いですが、少し複雑です。
• 可変引数を使用する場合は、vfprintf 関数よりも printf 関数の方が使いやすいかもしれません。
• フォーマット文字列を理解するには、printf 関数のマニュアルを参照してください。

PHP vfprintf 関数：サンプルコード

$name = "John Doe";
$age = 30;

echo "Hello, $name! You are $age years old.\n";
vfprintf(STDOUT, "Hello, %s! You are %d years old.\n", [$name, $age]);

配列の要素をフォーマット

$data = ["John Doe", 30, "Software Engineer"];

echo "Name: $data[0]\n";
echo "Age: $data[1]\n";
echo "Occupation: $data[2]\n";

vfprintf(STDOUT, "Name: %s\nAge: %d\nOccupation: %s\n", $data);

日付と時刻のフォーマット

$date = new DateTime();

echo "Today is " . $date->format("Y-m-d") . "\n";
vfprintf(STDOUT, "Today is %s\n", [$date->format("Y-m-d")]);

ファイルへの書き込み

$name = "John Doe";
$age = 30;

$fp = fopen("output.txt", "w");

fprintf($fp, "Hello, %s! You are %d years old.\n", [$name, $age]);

fclose($fp);

オブジェクトのフォーマット

class Person
{
    public $name;
    public $age;

    public function __construct($name, $age)
    {
        $this->name = $name;
        $this->age = $age;
    }
}

$person = new Person("John Doe", 30);

echo "Name: " . $person->name . "\n";
echo "Age: " . $person->age . "\n";

vfprintf(STDOUT, "Name: %s\nAge: %d\n", [$person->name, $person->age]);

printf 関数との比較

$name = "John Doe";
$age = 30;

printf("Hello, %s! You are %d years old.\n", $name, $age);

$args = [$name, $age];
vfprintf(STDOUT, "Hello, %s! You are %d years old.\n", $args);

この例では、printf 関数と vfprintf 関数は同じ結果を出力します。

可変引数との比較

$name = "John Doe";
$age = 30;

printf("Hello, %s! You are %d years old.\n", $name, $age);

vprintf(STDOUT, "Hello, %s! You are %d years old.\n", func_get_args());

この例では、func_get_args 関数を使用して、可変引数を vfprintf 関数に渡します。

vfprintf 関数は、フォーマットされた文字列をストリームに書き込むための強力なツールです。 可変引数を使用できるため、さまざまな状況で役立ちます。

PHP vfprintf 関数 以外の方法

printf 関数は、vfprintf 関数に似ていますが、可変引数ではなく、フォーマット文字列と引数を個別に指定します。

$name = "John Doe";
$age = 30;

printf("Hello, %s! You are %d years old.\n", $name, $age);

sprintf 関数は、フォーマットされた文字列を生成し、変数に格納します。

$name = "John Doe";
$age = 30;

$message = sprintf("Hello, %s! You are %d years old.\n", $name, $age);

echo $message;

echo / print 文

単純な文字列を出力する場合は、echo 文または print 文を使用できます。

$name = "John Doe";
$age = 30;

echo "Hello, $name! You are $age years old.\n";

ファイルへの書き込み

ファイルを書き込む場合は、fwrite 関数または file_put_contents 関数を使用できます。

$name = "John Doe";
$age = 30;

$fp = fopen("output.txt", "w");

fwrite($fp, "Hello, $name! You are $age years old.\n");

fclose($fp);

オブジェクトのフォーマット方法は、オブジェクトの型によって異なります。 多くのオブジェクトは、__toString メソッドを持っています。 このメソッドは、オブジェクトを文字列に変換するために呼び出されます。

class Person
{
    public $name;
    public $age;

    public function __construct($name, $age)
    {
        $this->name = $name;
        $this->age = $age;
    }

    public function __toString()
    {
        return "{$this->name} ({$this->age})";
    }
}

$person = new Person("John Doe", 30);

echo $person . "\n";

vfprintf 関数は、フォーマットされた文字列をストリームに書き込むための便利なツールですが、他の方法も存在します。 状況に応じて最適な方法を選択してください。