reference/filesystem/functions/fgetss.xml
cb3e68d99d80a70feafc6f9a1b5f678e4d0522af
cb3e68d99d80a70feafc6f9a1b5f678e4d0522af
...
...
@@ -6,6 +6,10 @@
6
6
<refpurpose>Gets line from file pointer and strip HTML tags</refpurpose>
7
7
</refnamediv>
8
8
9
+
<refsynopsisdiv>
10
+
&warn.deprecated.function-7-3-0.removed-8-0-0;
11
+
</refsynopsisdiv>
12
+
9
13
<refsect1 role="description">
10
14
&reftitle.description;
11
15
<methodsynopsis>
...
...
@@ -18,6 +22,9 @@
18
22
Identical to <function>fgets</function>, except that
19
23
<function>fgetss</function> attempts to strip any NUL bytes, HTML and PHP tags from
20
24
the text it reads.
25
+
The function retains the parsing state from call to call, and as such is not
26
+
equivalent to calling <function>strip_tags</function> on the return value of
27
+
<function>fgets</function>.
21
28
</para>
22
29
</refsect1>
23
30
...
...
@@ -45,6 +52,8 @@
45
52
<para>
46
53
You can use the optional third parameter to specify tags which should
47
54
not be stripped.
55
+
See <function>strip_tags</function> for details regarding
56
+
<parameter>allowable_tags</parameter>.
48
57
</para>
49
58
</listitem>
50
59
</varlistentry>
...
...
@@ -64,31 +73,8 @@
64
73
</para>
65
74
</refsect1>
66
75
67
-
<refsect1 role="changelog">
68
-
&reftitle.changelog;
69
-
<para>
70
-
<informaltable>
71
-
<tgroup cols="2">
72
-
<thead>
73
-
<row>
74
-
<entry>&Version;</entry>
75
-
<entry>&Description;</entry>
76
-
</row>
77
-
</thead>
78
-
<tbody>
79
-
<row>
80
-
<entry>5.0.0</entry>
81
-
<entry>
82
-
The <parameter>length</parameter> parameter is optional
83
-
</entry>
84
-
</row>
85
-
</tbody>
86
-
</tgroup>
87
-
</informaltable>
88
-
</para>
89
-
</refsect1>
90
-
91
76
<refsect1 role="examples">
77
+
&reftitle.examples;
92
78
<para>
93
79
<example>
94
80
<title>Reading a PHP file line-by-line</title>
...
...
@@ -140,6 +126,8 @@ Text outside of the HTML block.
140
126
<member><function>popen</function></member>
141
127
<member><function>fsockopen</function></member>
142
128
<member><function>strip_tags</function></member>
129
+
<member><methodname>SplFileObject::fgetss</methodname></member>
130
+
<member>The <link linkend="filters.string.strip_tags">string.strip_tags</link> filter</member>
143
131
</simplelist>
144
132
</para>
145
133
</refsect1>
146
134