SplFileObject::fpassthru
SplFileObject::fseek
SplFileObject
PHP Manual

# SplFileObject::fscanf

(PHP 5 >= 5.1.0)

SplFileObject::fscanf — フォーマットに従ってファイルからの入力をパースする

### 説明

public mixed SplFileObject::fscanf ( string `$format` [, mixed `&$...` ] )

ファイルから 1 行読み込み、sprintf() のドキュメントで説明される規定の `format` に従って解釈されます。

`format` 文字列のホワイトスペースはファイルからの行のホワイトスペースとマッチします。このことが意味するのは付ぉマット文字列のタブ (\t) でさえも入力ストリームの 1 つのスペース文字とマッチしてしまうということです。

### パラメータ

`format`

  規定のフォーマットは sprintf() のドキュメントで説明されています。

`...`

  オプションの割り当て値。

### 返り値

このメソッドに渡される引数が 2 つしかない場合、処理される値は配列として返されます。そうでなければ、オプションパラメータが渡される場合、メソッドは割り当て値の個数を返します。オプションパラメータは参照渡しでなければなりません。

### 例

例1 SplFileObject::fscanf の例

`<?php
$file = new SplFileObject("misc.txt");
while ($userinfo = $file->fscanf("%s %s %s")) {
list ($name, $profession, $countrycode) = $userinfo;
// $name $profession で何かを行う
}
?>`

users.txt の内容

    javier   argonaut    pe
    hiroshi  sculptor    jp
    robert   slacker     us
    luigi    florist     it

### 参考

- fscanf() - フォーマットに基づきファイルからの入力を処理する

SplFileObject::fpassthru
SplFileObject::fseek
SplFileObject
PHP Manual