reference/filesystem/functions/fread.xml
ae5b5761e220b355014d0845e060ea1669befe7a
...
...
@@ -1,6 +1,6 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fread">
3
+
<refentry xml:id="function.fread" xmlns="http://docbook.org/ns/docbook">
4
4
<refnamediv>
5
5
<refname>fread</refname>
6
6
<refpurpose>Binary-safe file read</refpurpose>
...
...
@@ -9,14 +9,14 @@
9
9
<refsect1 role="description">
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
-
<type>string</type><methodname>fread</methodname>
13
-
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
12
+
<type class="union"><type>string</type><type>false</type></type><methodname>fread</methodname>
13
+
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
14
14
<methodparam><type>int</type><parameter>length</parameter></methodparam>
15
15
</methodsynopsis>
16
16
<para>
17
17
<function>fread</function> reads up to
18
18
<parameter>length</parameter> bytes from the file pointer
19
-
referenced by <parameter>handle</parameter>. Reading stops as soon as one
19
+
referenced by <parameter>stream</parameter>. Reading stops as soon as one
20
20
of the following conditions is met:
21
21
<itemizedlist>
22
22
<listitem>
...
...
@@ -52,7 +52,7 @@
52
52
<para>
53
53
<variablelist>
54
54
<varlistentry>
55
-
<term><parameter>handle</parameter></term>
55
+
<term><parameter>stream</parameter></term>
56
56
<listitem>
57
57
&fs.file.pointer;
58
58
</listitem>
...
...
@@ -132,7 +132,6 @@ fclose($handle);
132
132
<programlisting role="php">
133
133
<![CDATA[
134
134
<?php
135
-
// For PHP 5 and up
136
135
$handle = fopen("http://www.example.com/", "rb");
137
136
$contents = stream_get_contents($handle);
138
137
fclose($handle);
...
...
@@ -143,9 +142,14 @@ fclose($handle);
143
142
<![CDATA[
144
143
<?php
145
144
$handle = fopen("http://www.example.com/", "rb");
145
+
if (FALSE === $handle) {
146
+
exit("Failed to open stream to URL");
147
+
}
148
+

146
149
$contents = '';
150
+

147
151
while (!feof($handle)) {
148
-
$contents .= fread($handle, 8192);
152
+
$contents .= fread($handle, 8192);
149
153
}
150
154
fclose($handle);
151
155
?>
...
...
@@ -187,13 +191,14 @@ fclose($handle);
187
191
<member><function>fscanf</function></member>
188
192
<member><function>file</function></member>
189
193
<member><function>fpassthru</function></member>
194
+
<member><function>fseek</function></member>
190
195
<member><function>ftell</function></member>
191
196
<member><function>rewind</function></member>
197
+
<member><function>unpack</function></member>
192
198
</simplelist>
193
199
</para>
194
200
</refsect1>
195
201
</refentry>
196
-

197
202
<!-- Keep this comment at the end of the file
198
203
Local variables:
199
204
mode: sgml
200
205