From 9785d7ff62eaaa8024f77fc8cd0c82813da7b1ec Mon Sep 17 00:00:00 2001
From: Richard Quadling <rquadling@php.net>
Date: Thu, 19 Nov 2009 08:53:30 +0000
Subject: [PATCH] Updated return types for invalid file handle. Updated example
 to include error checking for fopen(). Fix # 50221

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@290968 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/filesystem/functions/fgetcsv.xml | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/reference/filesystem/functions/fgetcsv.xml b/reference/filesystem/functions/fgetcsv.xml
index 5f003fa7d3..63e6d3f6ed 100644
--- a/reference/filesystem/functions/fgetcsv.xml
+++ b/reference/filesystem/functions/fgetcsv.xml
@@ -94,8 +94,9 @@
   </note>
   &note.line-endings;
   <para>
-   <function>fgetcsv</function> returns &false; on error, including end of
-   file.
+   <function>fgetcsv</function> returns &null; if an invalid
+   <parameter>handle</parameter> is supplied or &false; on other errors,
+   including end of file.
   </para>
  </refsect1>
 
@@ -144,16 +145,17 @@
 <![CDATA[
 <?php
 $row = 1;
-$handle = fopen("test.csv", "r");
-while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {
-    $num = count($data);
-    echo "<p> $num fields in line $row: <br /></p>\n";
-    $row++;
-    for ($c=0; $c < $num; $c++) {
-        echo $data[$c] . "<br />\n";
+if (($handle = fopen("test.csv", "r")) !== FALSE) {
+    while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {
+        $num = count($data);
+        echo "<p> $num fields in line $row: <br /></p>\n";
+        $row++;
+        for ($c=0; $c < $num; $c++) {
+            echo $data[$c] . "<br />\n";
+        }
     }
+    fclose($handle);
 }
-fclose($handle);
 ?>
 ]]>
     </programlisting>