Description:
------------
---
From manual page: http://www.php.net/function.fscanf#refsect1-function.fscanf-unknown-seealsp
---

In the German version of this documentation it is not mentioned that fscanf only reads one line at a time which causes failure when one wants to scan a (short) file as a whole. For instance, from the German documentation it did not came clear that the code snippet presented below will not work while the English documentation makes clear that this probably will not work.

Test script:
---------------
$file = fopen("filename", "r") or
	die("Could not open file for reading.");
fscanf($file, "%d\n$d", $int1, $int2);
fclose($file);

Expected result:
----------------
That $int1 and $int2 are assigned the integer values from the first or second line of "filename", respectively.

Actual result:
--------------
$int1 is assigned correctly, while $int2 was left undefined. It became 0 due to prior initialization, but leaving out optional parameters and dumping the returned associative array would yield $result['int2'] to equal NULL.