Implement &return.falseproblem; and &note.bin-safe; entities, and added an example.

This closes bug #21877


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@130621 c90b9560-bf6c-de11-be94-00142212c4b1

reference/filesystem/functions/fgetc.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.fgetc">
    <refnamediv>
@@ -22,13 +22,30 @@
      successfully opened by <function>fopen</function>,
      <function>popen</function>, or <function>fsockopen</function>.
     </para>
+    
+    &return.falseproblem;
+    
     <para>
-     <note>
-      <para>
-       This function is binary safe.
-      </para>
-     </note>
+     <example>
+      <title>A <function>fgetc</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$fp = fopen('somefile.txt', 'r');
+if (!$fp) {
+    echo 'Could not open file somefile.txt';
+}
+while (false !== ($char = fgetc($fp))) {
+    echo "$char\n";
+}
+?>
+]]>
+      </programlisting>
+     </example>
     </para>
+    
+    &note.bin-safe;
+
     <para> 
      See also <function>fread</function>, <function>fopen</function>,
      <function>popen</function>, <function>fsockopen</function>, and