From 551b169f3cfce4ac9aab4dcb9a089cc49c06682a Mon Sep 17 00:00:00 2001
From: Philip Olson <philip@php.net>
Date: Sun, 8 Jun 2003 14:29:25 +0000
Subject: [PATCH] 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 | 29 +++++++++++++++++++-----
 1 file changed, 23 insertions(+), 6 deletions(-)

diff --git a/reference/filesystem/functions/fgetc.xml b/reference/filesystem/functions/fgetc.xml
index 90fc5b03e9..b2952066b9 100644
--- a/reference/filesystem/functions/fgetc.xml
+++ b/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