<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.filesystem.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'uk',
  ),
  'this' => 
  array (
    0 => 'function.fgetss.php',
    1 => 'fgetss',
    2 => 'Gets line from file pointer and strip HTML tags',
  ),
  'up' => 
  array (
    0 => 'ref.filesystem.php',
    1 => 'Функції Файлової Системи',
  ),
  'prev' => 
  array (
    0 => 'function.fgets.php',
    1 => 'fgets',
  ),
  'next' => 
  array (
    0 => 'function.file.php',
    1 => 'file',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/filesystem/functions/fgetss.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.fgetss" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">fgetss</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">fgetss</span> &mdash; <span class="dc-title">Gets line from file pointer and strip HTML tags</span></p>

 </div>

 <div id="function.fgetss-refsynopsisdiv">
   <div class="warning"><strong class="warning">Увага</strong><p class="simpara">Ця функція
<em>ЗАСТАРІЛА</em>, починаючи з PHP 7.3.0, та
<em>ВИЛУЧЕНА</em> в PHP 8.0.0. Вкрай не рекомендується на неї
покладатися.</p></div>
 </div>

 <div class="refsect1 description" id="refsect1-function.fgetss-description">
  <h3 class="title">Опис</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>fgetss</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$handle</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$length</code><span class="initializer"> = ?</span></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$allowable_tags</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>

  <p class="para rdfs-comment">
   Identical to <span class="function"><a href="function.fgets.php" class="function">fgets()</a></span>, except that
   <span class="function"><strong>fgetss()</strong></span> attempts to strip any NUL bytes, HTML and PHP tags from
   the text it reads.
   The function retains the parsing state from call to call, and as such is not
   equivalent to calling <span class="function"><a href="function.strip-tags.php" class="function">strip_tags()</a></span> on the return value of
   <span class="function"><a href="function.fgets.php" class="function">fgets()</a></span>.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.fgetss-parameters">
  <h3 class="title">Параметри</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">handle</code></dt>
     <dd>
      <p class="para">Вказівник на файл має бути дійсним
та має вказувати на файл, успішно відкритий функцією
<span class="function"><a href="function.fopen.php" class="function">fopen()</a></span> або <span class="function"><a href="function.fsockopen.php" class="function">fsockopen()</a></span> (та не закритий
функцією <span class="function"><a href="function.fclose.php" class="function">fclose()</a></span>).</p>
     </dd>
    
    
     <dt><code class="parameter">length</code></dt>
     <dd>
      <p class="para">
       Length of the data to be retrieved.
      </p>
     </dd>
    
    
     <dt><code class="parameter">allowable_tags</code></dt>
     <dd>
      <p class="para">
       You can use the optional third parameter to specify tags which should
       not be stripped.
       See <span class="function"><a href="function.strip-tags.php" class="function">strip_tags()</a></span> for details regarding
       <code class="parameter">allowable_tags</code>.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.fgetss-returnvalues">
  <h3 class="title">Значення, що повертаються</h3>
  <p class="para">
   Returns a string of up to <code class="parameter">length</code> - 1 bytes read from
   the file pointed to by <code class="parameter">handle</code>, with all HTML and PHP
   code stripped.
  </p>
  <p class="para">
   If an error occurs, returns <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.fgetss-examples">
  <h3 class="title">Приклади</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Приклад #1 Reading a PHP file line-by-line</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$str </span><span style="color: #007700">= &lt;&lt;&lt;EOD<br /></span><span style="color: #DD0000">&lt;html&gt;&lt;body&gt;<br /> &lt;p&gt;Welcome! Today is the &lt;?php echo(date('jS')); ?&gt; of &lt;?= date('F'); ?&gt;.&lt;/p&gt;<br />&lt;/body&gt;&lt;/html&gt;<br />Text outside of the HTML block.<br /></span><span style="color: #007700">EOD;<br /></span><span style="color: #0000BB">file_put_contents</span><span style="color: #007700">(</span><span style="color: #DD0000">'sample.php'</span><span style="color: #007700">, </span><span style="color: #0000BB">$str</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$handle </span><span style="color: #007700">= @</span><span style="color: #0000BB">fopen</span><span style="color: #007700">(</span><span style="color: #DD0000">"sample.php"</span><span style="color: #007700">, </span><span style="color: #DD0000">"r"</span><span style="color: #007700">);<br />if (</span><span style="color: #0000BB">$handle</span><span style="color: #007700">) {<br />    while (!</span><span style="color: #0000BB">feof</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">)) {<br />        </span><span style="color: #0000BB">$buffer </span><span style="color: #007700">= </span><span style="color: #0000BB">fgetss</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">, </span><span style="color: #0000BB">4096</span><span style="color: #007700">);<br />        echo </span><span style="color: #0000BB">$buffer</span><span style="color: #007700">;<br />    }<br />    </span><span style="color: #0000BB">fclose</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">);<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Поданий вище приклад виведе щось
схоже на:</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">Welcome! Today is the  of .

Text outside of the HTML block.</pre>
</div>
    </div>
   </div>
  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-function.fgetss-notes">
  <h3 class="title">Примітки</h3>
  <blockquote class="note"><p><strong class="note">Зауваження</strong>: <span class="simpara">Якщо виникають проблеми з
розпізнаванням закінчення рядків під час читання чи створення файлів на
компʼютері Macintosh, може допомогти застосування директиви <a href="filesystem.configuration.php#ini.auto-detect-line-endings" class="link">auto_detect_line_endings</a> під час
виконання.</span></p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.fgetss-seealso">
  <h3 class="title">Прогляньте також</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.fgets.php" class="function" rel="rdfs-seeAlso">fgets()</a> - Gets line from file pointer</span></li>
    <li><span class="function"><a href="function.fopen.php" class="function" rel="rdfs-seeAlso">fopen()</a> - Opens file or URL</span></li>
    <li><span class="function"><a href="function.popen.php" class="function" rel="rdfs-seeAlso">popen()</a> - Opens process file pointer</span></li>
    <li><span class="function"><a href="function.fsockopen.php" class="function" rel="rdfs-seeAlso">fsockopen()</a> - Open Internet or Unix domain socket connection</span></li>
    <li><span class="function"><a href="function.strip-tags.php" class="function" rel="rdfs-seeAlso">strip_tags()</a> - Видаляє HTML і PHP-теги з рядка</span></li>
    <li><span class="methodname"><a href="splfileobject.fgetss.php" class="methodname" rel="rdfs-seeAlso">SplFileObject::fgetss()</a> - Gets line from file and strip HTML tags</span></li>
    <li>The <a href="filters.string.php#filters.string.strip_tags" class="link">string.strip_tags</a> filter</li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>