--TEST--
Test file() function : third parameter variation 
--FILE--
<?php
/* Prototype  : array file(string filename [, int flags[, resource context]])
 * Description: Read entire file into an array 
 * Source code: ext/standard/file.c
 * Alias to functions: 
 */

echo "*** Testing file() : usage variation ***\n";

// Define error handler
function test_error_handler($err_no, $err_msg, $filename, $linenum, $vars) {
	if (error_reporting() != 0) {
		// report non-silenced errors
		echo "Error: $err_no - $err_msg, $filename($linenum)\n";
	}
}
set_error_handler('test_error_handler');

// Initialise function arguments not being substituted
$filename = __FILE__ . ".tmp";
$fd = fopen($filename, "w+");
fwrite($fd, "Line 1\nLine 2\nLine 3");
fclose($fd);

$flags = 0;

//get an unset variable
$unset_var = 10;
unset ($unset_var);

// define some classes
class classWithToString
{
	public function __toString() {
		return "Class A object";
	}
}

class classWithoutToString
{
}

// heredoc string
$heredoc = <<<EOT
hello world
EOT;

// add arrays
$index_array = array (1, 2, 3);
$assoc_array = array ('one' => 1, 'two' => 2);

// create a file stream resource
$tmp_filename = __FILE__ . ".tmp2";
$file_stream_resource = fopen($tmp_filename, "w+");

//array of values to iterate over
$inputs = array(

      // int data
      'int 0' => 0,
      'int 1' => 1,
      'int 12345' => 12345,
      'int -12345' => -2345,

      // float data
      'float 10.5' => 10.5,
      'float -10.5' => -10.5,
      'float 12.3456789000e10' => 12.3456789000e10,
      'float -12.3456789000e10' => -12.3456789000e10,
      'float .5' => .5,

      // array data
      'empty array' => array(),
      'int indexed array' => $index_array,
      'associative array' => $assoc_array,
      'nested arrays' => array('foo', $index_array, $assoc_array),

      // null data
      'uppercase NULL' => NULL,
      'lowercase null' => null,

      // boolean data
      'lowercase true' => true,
      'lowercase false' =>false,
      'uppercase TRUE' =>TRUE,
      'uppercase FALSE' =>FALSE,

      // empty data
      'empty string DQ' => "",
      'empty string SQ' => '',

      // string data
      'string DQ' => "string",
      'string SQ' => 'string',
      'mixed case string' => "sTrInG",
      'heredoc' => $heredoc,

      // object data
      'instance of classWithToString' => new classWithToString(),
      'instance of classWithoutToString' => new classWithoutToString(),

      // undefined data
      'undefined var' => @$undefined_var,

      // unset data
      'unset var' => @$unset_var,
      
      // file stream resource
      'file stream resource' => $file_stream_resource,
);

// loop through each element of the array for context

foreach($inputs as $key =>$value) {
      echo "\n--$key--\n";
      var_dump( file($filename, $flags, $value) );
};

fclose($file_stream_resource);
unlink($tmp_filename);
unlink($filename);

?>
===DONE===
--EXPECTF--
*** Testing file() : usage variation ***

--int 0--
Error: 2 - file() expects parameter 3 to be resource, integer given, %s(%d)
NULL

--int 1--
Error: 2 - file() expects parameter 3 to be resource, integer given, %s(%d)
NULL

--int 12345--
Error: 2 - file() expects parameter 3 to be resource, integer given, %s(%d)
NULL

--int -12345--
Error: 2 - file() expects parameter 3 to be resource, integer given, %s(%d)
NULL

--float 10.5--
Error: 2 - file() expects parameter 3 to be resource, double given, %s(%d)
NULL

--float -10.5--
Error: 2 - file() expects parameter 3 to be resource, double given, %s(%d)
NULL

--float 12.3456789000e10--
Error: 2 - file() expects parameter 3 to be resource, double given, %s(%d)
NULL

--float -12.3456789000e10--
Error: 2 - file() expects parameter 3 to be resource, double given, %s(%d)
NULL

--float .5--
Error: 2 - file() expects parameter 3 to be resource, double given, %s(%d)
NULL

--empty array--
Error: 2 - file() expects parameter 3 to be resource, array given, %s(%d)
NULL

--int indexed array--
Error: 2 - file() expects parameter 3 to be resource, array given, %s(%d)
NULL

--associative array--
Error: 2 - file() expects parameter 3 to be resource, array given, %s(%d)
NULL

--nested arrays--
Error: 2 - file() expects parameter 3 to be resource, array given, %s(%d)
NULL

--uppercase NULL--
array(3) {
  [0]=>
  string(7) "Line 1
"
  [1]=>
  string(7) "Line 2
"
  [2]=>
  string(6) "Line 3"
}

--lowercase null--
array(3) {
  [0]=>
  string(7) "Line 1
"
  [1]=>
  string(7) "Line 2
"
  [2]=>
  string(6) "Line 3"
}

--lowercase true--
Error: 2 - file() expects parameter 3 to be resource, boolean given, %s(%d)
NULL

--lowercase false--
Error: 2 - file() expects parameter 3 to be resource, boolean given, %s(%d)
NULL

--uppercase TRUE--
Error: 2 - file() expects parameter 3 to be resource, boolean given, %s(%d)
NULL

--uppercase FALSE--
Error: 2 - file() expects parameter 3 to be resource, boolean given, %s(%d)
NULL

--empty string DQ--
Error: 2 - file() expects parameter 3 to be resource, string given, %s(%d)
NULL

--empty string SQ--
Error: 2 - file() expects parameter 3 to be resource, string given, %s(%d)
NULL

--string DQ--
Error: 2 - file() expects parameter 3 to be resource, string given, %s(%d)
NULL

--string SQ--
Error: 2 - file() expects parameter 3 to be resource, string given, %s(%d)
NULL

--mixed case string--
Error: 2 - file() expects parameter 3 to be resource, string given, %s(%d)
NULL

--heredoc--
Error: 2 - file() expects parameter 3 to be resource, string given, %s(%d)
NULL

--instance of classWithToString--
Error: 2 - file() expects parameter 3 to be resource, object given, %s(%d)
NULL

--instance of classWithoutToString--
Error: 2 - file() expects parameter 3 to be resource, object given, %s(%d)
NULL

--undefined var--
array(3) {
  [0]=>
  string(7) "Line 1
"
  [1]=>
  string(7) "Line 2
"
  [2]=>
  string(6) "Line 3"
}

--unset var--
array(3) {
  [0]=>
  string(7) "Line 1
"
  [1]=>
  string(7) "Line 2
"
  [2]=>
  string(6) "Line 3"
}

--file stream resource--
Error: 2 - file(): supplied resource is not a valid Stream-Context resource, %s(%d)
array(3) {
  [0]=>
  string(7) "Line 1
"
  [1]=>
  string(7) "Line 2
"
  [2]=>
  string(6) "Line 3"
}
===DONE===