VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-07-30 12:57:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

fgets.xml: уточнил перевод, исправил инфостиль

Browse Source
This commit is contained in:
Mikhail Alferov
2024-06-25 20:50:09 +03:00
committed by GitHub
parent fcf9048719
commit 458597c820
1 changed files with 13 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
reference/filesystem/functions/fgets.xml
View File

@ -33,11 +33,12 @@
<term><parameter>length</parameter></term>
<listitem>
<para>
Чтение заканчивается при достижении параметром <parameter>length</parameter> значения в 1 байт,
либо если встретилась новая строка (которая включается в возвращаемый результат)
или конец файла (в зависимости от того, что наступит раньше).
Если длину не указали, чтение из потока будет продолжаться до тех пор,
пока не достигнет конца строки.
Чтение заканчивается, когда: а) функция прочитала <parameter>length</parameter> - 1 байтов,
б) встретился конец строки (который функция включает в возвращаемое значение)
или в) наступило состояние EOF (функция достигла конца файла) —
в зависимости от того, что наступит раньше.
Чтение из потока будет продолжаться до тех пор,
пока функция не достигнет конца строки, если длину не указали.
</para>
</listitem>
</varlistentry>
@ -48,9 +49,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Функция возвращает строку размером в <parameter>length</parameter> — 1 байт, которую функция прочитала
Функция возвращает строку размером до <parameter>length</parameter> - 1 байтов, которую функция прочитала
из дескриптора файла, на который указывает параметр <parameter>stream</parameter>.
Если данных для чтения больше нет, то функция возвращает &false;.
Функция возвращает &false;, если данных для чтения не осталось.
</para>
<para>
Функция возвращает &false;, если возникла ошибка.
@ -61,7 +62,7 @@
&reftitle.examples;
<para>
<example>
<title>Пример постоянного чтения файла</title>
<title>Пример построчного чтения файла</title>
<programlisting role="php">
<![CDATA[
<?php
@ -74,7 +75,7 @@ if ($fp) {
}
if (!feof($fp)) {
echo "Ошибка: fgets() неожиданно потерпел неудачу\n";
echo "Ошибка: неожиданный сбой функций fgets()\n";
}
fclose($fp);
@ -92,9 +93,9 @@ if ($fp) {
&note.line-endings;
<note>
<para>
Программисты, которые привыкли к семантике функции <function>fgets</function> языка C,
должны принимать во внимание разницу в том, каким образом возвращается
признак достижения конца файла (<literal>EOF</literal>).
Программистам, которые привыкли к семантике функции <function>fgets</function> языка C,
требуется принять во внимание разницу в том, как возвращается
признак конца файла (<literal>EOF</literal>).
</para>
</note>
</refsect1>