Use <function> for language constructs (now supported by PhD)

git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@325214 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Jakub Vrana
2012-04-15 21:45:34 +00:00
parent 5a1e8e20f2
commit cf22b9d89e
33 changed files with 92 additions and 92 deletions

View File

@ -130,7 +130,7 @@
</row>
<row>
<entry>die</entry>
<entry><link linkend="function.exit"><literal>exit</literal></link></entry>
<entry><function>exit</function></entry>
<entry><link linkend="ref.misc">Неклассифицированные функции</link></entry>
</row>
<row>

View File

@ -1066,7 +1066,7 @@
<para>
Определяет имя файла, который будет автоматически обрабатываться
перед основным файлом. Файл вызывается так, будто он был подключен
при помощи функции <link linkend="function.require"><literal>require</literal></link>, так что
при помощи функции <function>require</function>, так что
<link linkend="ini.include-path">include_path</link> также используется.
</para>
<para>
@ -1085,7 +1085,7 @@
<para>
Определяет имя файла, который будет автоматически обрабатываться
после основного файла. Файл вызывается так, будто он был подключен
при помощи функции <link linkend="function.require"><literal>require</literal></link>, так что
при помощи функции <function>require</function>, так что
<link linkend="ini.include-path">include_path</link> тоже используется.
</para>
<para>
@ -1093,7 +1093,7 @@
отключает эту директиву.
<note>
<simpara>
Если скрипт завершает работу при помощи <link linkend="function.exit"><literal>exit</literal></link>,
Если скрипт завершает работу при помощи <function>exit</function>,
auto-append <emphasis>НЕ</emphasis> выполняется.</simpara>
</note>
</para>
@ -1302,7 +1302,7 @@
<listitem>
<para>
Указывает список директорий, в которых функции
<link linkend="function.require"><literal>require</literal></link>, <link linkend="function.include"><literal>include</literal></link>,
<function>require</function>, <function>include</function>,
<function>fopen</function>, <function>file</function>,
<function>readfile</function> и <function>file_get_contents</function>
ищут файлы. Формат соответствует формату системной переменной окружения

View File

@ -148,17 +148,17 @@
<simpara>
Если во включенном файле объявлены какие-либо функции, они могут использоваться и в
главном файле, вне зависимости от того, располагаются они
до <link linkend="function.return"><literal>return</literal></link> или после.
до <function>return</function> или после.
Если файл включается дважды, PHP 5 генерирует фатальную ошибку,
так как функции уже были объявлены, в то время, как PHP 4 не
жалуется на это. Рекомендуется использовать
<link linkend="function.include-once"><literal>include_once</literal></link> вместо проверки, был ли уже
<function>include_once</function> вместо проверки, был ли уже
включен файл и условного возврата внутри включенного файла.
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="function.include-once"><literal>include_once</literal></link> и <link linkend="function.require-once"><literal>require_once</literal></link>
<function>include_once</function> и <function>require_once</function>
сначала стандартизируют путь к включенному файлу в Windows,
так что при включении A.php и a.php файл включается только
один раз.

View File

@ -151,7 +151,7 @@
<function>func_get_arg</function>, <function>func_get_args</function> и
<function>func_num_args</function> теперь не могут быть вызваны
извне зоны видимости файла, который включается директивой
<link linkend="function.include"><literal>include</literal></link> или <link linkend="function.require"><literal>require</literal></link> из
<function>include</function> или <function>require</function> из
функции в вызывающем файле.
</simpara>
</listitem>

View File

@ -243,16 +243,16 @@
<tbody>
<row>
<entry>
<link linkend="function.die"><literal>die</literal></link>
<function>die</function>
</entry>
<entry>
<link linkend="function.echo"><literal>echo</literal></link>
<function>echo</function>
</entry>
<entry>
<function>empty</function>
</entry>
<entry>
<link linkend="function.exit"><literal>exit</literal></link>
<function>exit</function>
</entry>
<entry>
<function>eval</function>
@ -260,10 +260,10 @@
</row>
<row>
<entry>
<link linkend="function.include"><literal>include</literal></link>
<function>include</function>
</entry>
<entry>
<link linkend="function.include-once"><literal>include_once</literal></link>
<function>include_once</function>
</entry>
<entry>
<function>isset</function>
@ -272,18 +272,18 @@
<function>list</function>
</entry>
<entry>
<link linkend="function.require"><literal>require</literal></link>
<function>require</function>
</entry>
</row>
<row>
<entry>
<link linkend="function.require-once"><literal>require_once</literal></link>
<function>require_once</function>
</entry>
<entry>
<link linkend="function.return"><literal>return</literal></link>
<function>return</function>
</entry>
<entry>
<link linkend="function.print"><literal>print</literal></link>
<function>print</function>
</entry>
<entry>
<function>unset</function>

View File

@ -235,7 +235,7 @@
<row>
<entry><constant>T_ECHO</constant></entry>
<entry>echo</entry>
<entry><link linkend="function.echo"><literal>echo</literal></link></entry>
<entry><function>echo</function></entry>
</row>
<row>
<entry><constant>T_ELSE</constant></entry>
@ -306,7 +306,7 @@
<row>
<entry><constant>T_EXIT</constant></entry>
<entry>exit or die</entry>
<entry><link linkend="function.exit"><literal>exit</literal></link>, <link linkend="function.die"><literal>die</literal></link></entry>
<entry><function>exit</function>, <function>die</function></entry>
</row>
<row>
<entry><constant>T_EXTENDS</constant></entry>
@ -381,12 +381,12 @@
<row>
<entry><constant>T_INCLUDE</constant></entry>
<entry>include()</entry>
<entry><link linkend="function.include"><literal>include</literal></link></entry>
<entry><function>include</function></entry>
</row>
<row>
<entry><constant>T_INCLUDE_ONCE</constant></entry>
<entry>include_once()</entry>
<entry><link linkend="function.include-once"><literal>include_once</literal></link></entry>
<entry><function>include_once</function></entry>
</row>
<row>
<entry><constant>T_INLINE_HTML</constant></entry>
@ -583,7 +583,7 @@
<row>
<entry><constant>T_PRINT</constant></entry>
<entry>print()</entry>
<entry><link linkend="function.print"><literal>print</literal></link></entry>
<entry><function>print</function></entry>
</row>
<row>
<entry><constant>T_PRIVATE</constant></entry>
@ -612,12 +612,12 @@
<row>
<entry><constant>T_REQUIRE</constant></entry>
<entry>require()</entry>
<entry><link linkend="function.require"><literal>require</literal></link></entry>
<entry><function>require</function></entry>
</row>
<row>
<entry><constant>T_REQUIRE_ONCE</constant></entry>
<entry>require_once()</entry>
<entry><link linkend="function.require-once"><literal>require_once</literal></link></entry>
<entry><function>require_once</function></entry>
</row>
<row>
<entry><constant>T_RETURN</constant></entry>

View File

@ -109,7 +109,7 @@
Эта программа чрезвычайно проста, и для создания настолько простой
странички даже необязательно использовать PHP. Всё, что она делает,
это вывод <literal>Hello World</literal>, используя инструкцию
PHP <link linkend="function.echo"><literal>echo</literal></link>. Заметьте, что файл <emphasis>не обязан быть
PHP <function>echo</function>. Заметьте, что файл <emphasis>не обязан быть
выполняемым</emphasis> или еще как-то отличаться от других файлов.
Сервер знает, что этот файл должен быть обработан PHP, так как файл обладает
расширением ".php", о котором в настройках сервера сказано, что подобные

View File

@ -214,8 +214,8 @@ echo "myfunc($variable) = " . myfunc($variable);
Для того, чтобы использовать результат вашей функции в выражении
(таком как соединение с другими строками, как в вышеприведённом примере),
вам необходимо вернуть значение с помощью
<link linkend="function.return"><literal>return</literal></link>,
а не выводить его через <link linkend="function.echo"><literal>echo</literal></link>.
<function>return</function>,
а не выводить его через <function>echo</function>.
</para>
</answer>
</qandaentry>

View File

@ -165,8 +165,8 @@
<entry>&true;</entry>
<entry>
Обычно в консоли желательно отображать вывод, например из
из <link linkend="function.print"><literal>print</literal></link>,
<link linkend="function.echo"><literal>echo</literal></link> и др.,
из <function>print</function>,
<function>echo</function> и др.,
сразу же минуя буфер. Тем не менее, попрежнему можно использовать
<link linkend="ref.outcontrol">буферизацию вывода</link> для
отложенного вывода или манипуляций с ним.

View File

@ -11,10 +11,10 @@
<acronym>HTTP</acronym> и <acronym>FTP</acronym> ссылки
в большинстве функций, принимающих в качестве
параметра имя файла. Также вы можете использовать ссылки в операторах
<link linkend="function.include"><literal>include</literal></link>,
<link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link> и
<link linkend="function.require-once"><literal>require_once</literal></link>
<function>include</function>,
<function>include_once</function>,
<function>require</function> и
<function>require_once</function>
(начиная с версии PHP 5.2.0 для корректной работы этих функций
должна быть включена опция <option>allow_url_include</option>).
Дополнительную информацию о поддерживаемых в PHP протоколах вы можете
@ -33,10 +33,10 @@
Дистрибутивы PHP для Windows-платформ до версии 4.3
не поддерживают возможности работы с удаленными файлами для следующих
операторов:
<link linkend="function.include"><literal>include</literal></link>,
<link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link>,
<link linkend="function.require-once"><literal>require_once</literal></link>
<function>include</function>,
<function>include_once</function>,
<function>require</function>,
<function>require_once</function>
и функций вида imagecreatefromXXX в расширении <xref linkend="ref.image"/>.
</para>
</note>

View File

@ -97,7 +97,7 @@ for ($i = 0; $i < 5; ++$i) {
</screen>
<para>
Потому что выражение <literal>continue print "$i\n";</literal> воспринимается
как единое выражение, и <link linkend="function.print"><literal>print</literal></link> вызыватеся только тогда,
как единое выражение, и <function>print</function> вызыватеся только тогда,
когда выражение <literal>$i == 2</literal> истинно. (Возвращаемое значение от
<literal>print</literal> передается к <literal>continue</literal> как
числовой аргумент.)

View File

@ -8,7 +8,7 @@
<para>
Выражение <literal>include_once</literal> включает и выполняет
указанный файл во время выполнения скрипта.
Его поведение идентично выражению <link linkend="function.include"><literal>include</literal></link>,
Его поведение идентично выражению <function>include</function>,
с той лишь разницей, что если код из файла уже один раз
был включен, он не будет включен и выполнен повторно. Как видно из имени,
он включит файл только один раз (include once).
@ -20,7 +20,7 @@
проблем с переопределением функций, переменных и т.д.
</para>
<para>
Смотри документацию по <link linkend="function.include"><literal>include</literal></link> для информации
Смотри документацию по <function>include</function> для информации
как эта функция работает.
</para>
<para>

View File

@ -15,11 +15,11 @@
<simpara>
Если вызывается из глобальной области видимости, выполнение текущего файла
скрипта прекращается. Если текущий файл скрипта был подключен
с помощью функций <link linkend="function.include"><literal>include</literal></link> или <link linkend="function.require"><literal>require</literal></link>,
с помощью функций <function>include</function> или <function>require</function>,
тогда управление возвращается к файлу, который вызывал текущий. Более того, если
текущий файл скрипта был подключен с помощью <link linkend="function.include"><literal>include</literal></link>, тогда
текущий файл скрипта был подключен с помощью <function>include</function>, тогда
значение переданное <literal>return</literal> будет возвращено в качестве
значения вызова <link linkend="function.include"><literal>include</literal></link>. Если
значения вызова <function>include</function>. Если
<literal>return</literal> вызывается из главного файла скрипта,
тогда выполнение скрипта прекращается. Если текущий файл скрипта был
вызван конфигурационными опциями <link

View File

@ -42,7 +42,7 @@
</para>
<para>
Также важно помнить, что на совести обработчика лежит вызов функции
<link linkend="function.die"><literal>die</literal></link> в случае необходимости. Если происходит возврат
<function>die</function> в случае необходимости. Если происходит возврат
их обработчика ошибок, управление передается следующему выражению,
стоящему за тем, что вызвало ошибку.
</para>

View File

@ -239,7 +239,7 @@ $trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
<member><function>fsockopen</function></member>
<member><function>popen</function></member>
<member><function>file_get_contents</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><function>include</function></member>
<member><function>stream_context_create</function></member>
</simplelist>
</para>

View File

@ -116,8 +116,8 @@ if (file_exists($file)) {
<member><function>fpassthru</function></member>
<member><function>file</function></member>
<member><function>fopen</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><link linkend="function.require"><literal>require</literal></link></member>
<member><function>include</function></member>
<member><function>require</function></member>
<member><function>virtual</function></member>
<member><function>file_get_contents</function></member>
<member><xref linkend="wrappers"/></member>

View File

@ -70,8 +70,8 @@
<entry>5.3.0</entry>
<entry>
Если эта функция вызвана в глобальной области видимости файла,
подключенного с помощью <link linkend="function.include"><literal>include</literal></link>
или <link linkend="function.require"><literal>require</literal></link> из функции вызывающего файла,
подключенного с помощью <function>include</function>
или <function>require</function> из функции вызывающего файла,
то теперь будет сгенерировано предупреждение и возвращено
значение &false;.
</entry>

View File

@ -54,8 +54,8 @@
<entry>5.3.0</entry>
<entry>
Если эта функция вызвана в глобальной области видимости файла,
подключенного с помощью <link linkend="function.include"><literal>include</literal></link>
или <link linkend="function.require"><literal>require</literal></link> из функции вызывающего файла,
подключенного с помощью <function>include</function>
или <function>require</function> из функции вызывающего файла,
то теперь будет сгенерировано предупреждение и возвращено
значение &false;.
</entry>

View File

@ -52,8 +52,8 @@
<entry>5.3.0</entry>
<entry>
Если эта функция вызвана в глобальной области видимости файла,
подключенного с помощью <link linkend="function.include"><literal>include</literal></link>
или <link linkend="function.require"><literal>require</literal></link> из функции вызывающего файла,
подключенного с помощью <function>include</function>
или <function>require</function> из функции вызывающего файла,
то теперь будет сгенерировано предупреждение и возвращено
значение -1.
</entry>

View File

@ -45,8 +45,8 @@
<note>
<para>
Эта функция возвращает &false; для языковых конструкций, таких
как <link linkend="function.include-once"><literal>include_once</literal></link>
или <link linkend="function.echo"><literal>echo</literal></link>.
как <function>include_once</function>
или <function>echo</function>.
</para>
</note>
</refsect1>

View File

@ -19,13 +19,13 @@
<para>
Регистрирует функцию <parameter>callback</parameter>, которая
выполнится после завершения работы скрипта или при вызове функции
<link linkend="function.exit"><literal>exit</literal></link>.
<function>exit</function>.
</para>
<para>
Возможна регистрация нескольких подобных функций с помощью
<function>register_shutdown_function</function>, при этом функции будут
выполняться в том порядке, в каком они были зарегистрированы.
Если вы вызовете <link linkend="function.exit"><literal>exit</literal></link> в одной из зарегистрированных
Если вы вызовете <function>exit</function> в одной из зарегистрированных
завершающих функций, процесс будет полностью остановлен и последующие
завершающие функции не будут вызваны.
</para>
@ -102,8 +102,8 @@
зарегистрированные завершающие функции вызывались после того,
как запрос был полностью завершен (включая отсылку всех
буферов вывода), так что было невозможно послать вывод в браузер
с помощью <link linkend="function.echo"><literal>echo</literal></link> или
<link linkend="function.print"><literal>print</literal></link>, или получить содержимое буферов вывода
с помощью <function>echo</function> или
<function>print</function>, или получить содержимое буферов вывода
из <function>ob_get_contents</function>.
Заголовки также уже были посланы к этому моменту.
</entry>
@ -154,7 +154,7 @@ register_shutdown_function('shutdown');
<para>
<simplelist>
<member><link linkend="ini.auto-append-file">auto_append_file</link></member>
<member><link linkend="function.exit"><literal>exit</literal></link></member>
<member><function>exit</function></member>
<member>Раздел "<link
linkend="features.connection-handling">Обработка соединений</link>"</member>
</simplelist>

View File

@ -56,7 +56,7 @@ echo ini_get('include_path');
<member><function>ini_get</function></member>
<member><function>restore_include_path</function></member>
<member><function>set_include_path</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><function>include</function></member>
</simplelist>
</para>
</refsect1>

View File

@ -18,10 +18,10 @@
</methodsynopsis>
<para>
Получает имена всех файлов, которые были включены в скрипт функциями
<link linkend="function.include"><literal>include</literal></link>,
<link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link> или
<link linkend="function.require-once"><literal>require_once</literal></link>.
<function>include</function>,
<function>include_once</function>,
<function>require</function> или
<function>require_once</function>.
</para>
</refsect1>
@ -33,7 +33,7 @@
<para>
Скрипт, который был загружен изначально, рассматривается как
"включенный файл", поэтому он также попадет в список файлов включенных фукнцией
<link linkend="function.include"><literal>include</literal></link> или другими.
<function>include</function> или другими.
</para>
<para>
Файлы добавляемые в скрипт неоднократно попадут в массив только в одном
@ -60,8 +60,8 @@
расширение <literal>.php</literal>; другие файлы просто игнорировались.
Функция <function>get_included_files</function> возвращала ассоциативный
массив, в который попадали файлы, включенные только функциями
<link linkend="function.include"><literal>include</literal></link> и
<link linkend="function.include-once"><literal>include_once</literal></link>.
<function>include</function> и
<function>include_once</function>.
</entry>
</row>
</tbody>
@ -122,10 +122,10 @@ test4.php
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><link linkend="function.include-once"><literal>include_once</literal></link></member>
<member><link linkend="function.require"><literal>require</literal></link></member>
<member><link linkend="function.require-once"><literal>require_once</literal></link></member>
<member><function>include</function></member>
<member><function>include_once</function></member>
<member><function>require</function></member>
<member><function>require_once</function></member>
<member><function>get_required_files</function></member>
</simplelist>
</para>

View File

@ -11,7 +11,7 @@
<refsect1 role="description">
&reftitle.description;
<para>
Данная функция эквивалентна функции <link linkend="function.exit"><literal>exit</literal></link>.
Данная функция эквивалентна функции <function>exit</function>.
</para>
</refsect1>

View File

@ -98,7 +98,7 @@
<row>
<entry>5.0.3</entry>
<entry>
Вызов функции <link linkend="function.exit"><literal>exit</literal></link> после
Вызов функции <function>exit</function> после
<function>php_check_syntax</function> передает результат
в Segfault.
</entry>
@ -138,7 +138,7 @@ PHP Parse error: unexpected T_STRING in /tmp/somefile.php on line 81
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><function>include</function></member>
<member><function>is_readable</function></member>
</simplelist>
</para>

View File

@ -18,7 +18,7 @@
Функции управления выводом не влияют на заголовки, отправленные
с помощью функций <function>header</function> или
<function>setcookie</function>, а влияют только на такие функции,
как <link linkend="function.echo"><literal>echo</literal></link> и данные между блоками PHP кода.
как <function>echo</function> и данные между блоками PHP кода.
</para>
<note>
<para>

View File

@ -26,7 +26,7 @@ ob_end_flush();
</example>
</para>
<para>
В приведенном выше примере вывод из <link linkend="function.echo"><literal>echo</literal></link>
В приведенном выше примере вывод из <function>echo</function>
будет храниться в буфере вывода до вызова
<function>ob_end_flush</function>. В то же время
вызов <function>setcookie</function> успешно сохранится в

View File

@ -104,8 +104,8 @@
данные в буфер, а после каждого отправленного блока автоматически
отправлять данные в выходной слой. Это эквивалентно вызову PHP-функции
<function>flush</function> после каждого вызова
<link linkend="function.print"><literal>print</literal></link>
или <link linkend="function.echo"><literal>echo</literal></link> для
<function>print</function>
или <function>echo</function> для
каждого <literal>HTML</literal>-блока.
</para>
<para>

View File

@ -18,7 +18,7 @@
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>RUNKIT_IMPORT_CLASS_METHODS</initializer></methodparam>
</methodsynopsis>
<para>
Функция похожа на <link linkend="function.include"><literal>include</literal></link>, за исключением того, что
Функция похожа на <function>include</function>, за исключением того, что
весь код вне функций и объявлений классов игнорируется.
В зависимости от значения параметра <parameter>flags</parameter>
существующие функции и классы будут автоматически заменены

View File

@ -17,8 +17,8 @@
<methodparam choice="opt"><type>mixed</type><parameter>callback</parameter></methodparam>
</methodsynopsis>
<para>
Обычно все результаты работы в песочниче (использование функций <link linkend="function.echo"><literal>echo</literal></link>
или <link linkend="function.print"><literal>print</literal></link>) будут выведены в родительском окружении.
Обычно все результаты работы в песочниче (использование функций <function>echo</function>
или <function>print</function>) будут выведены в родительском окружении.
Использование <function>runkit_sandbox_output_handler</function> позволяет
перехватить эти данные функцией вне песочницы.
</para>

View File

@ -139,13 +139,13 @@ string(6) "Global"
песочницы получить доступ к родительским функциям.
Следующими функции и языковыми конструкциями можно
управлять с помощью отдельных настроек:
<link linkend="function.print"><literal>print</literal></link> и <link linkend="function.echo"><literal>echo</literal></link>
<function>print</function> и <function>echo</function>
задействуются с помощью <literal>parent_echo</literal>;
<link linkend="function.die"><literal>die</literal></link> и <link linkend="function.exit"><literal>exit</literal></link>
<function>die</function> и <function>exit</function>
включаются через <literal>parent_die</literal>;
<function>eval</function> разрешается через <literal>parent_eval</literal>.
Функции <link linkend="function.include"><literal>include</literal></link>, <link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link>, и <link linkend="function.require-once"><literal>require_once</literal></link> можно
Функции <function>include</function>, <function>include_once</function>,
<function>require</function>, и <function>require_once</function> можно
подключить, используя параметр <literal>parent_include</literal>.
</para>

View File

@ -215,10 +215,10 @@ bool(false)
вызвана через метод объекта Runkit_Sandbox.
Так же доступны несколько псевдо-функций:
<function>eval</function>,
<link linkend="function.include"><literal>include</literal></link>, <link linkend="function.include-once"><literal>include_once</literal></link>,
<link linkend="function.require"><literal>require</literal></link>, <link linkend="function.require-once"><literal>require_once</literal></link>,
<link linkend="function.echo"><literal>echo</literal></link>, <link linkend="function.print"><literal>print</literal></link>,
<link linkend="function.die"><literal>die</literal></link>, and <link linkend="function.exit"><literal>exit</literal></link>.
<function>include</function>, <function>include_once</function>,
<function>require</function>, <function>require_once</function>,
<function>echo</function>, <function>print</function>,
<function>die</function>, and <function>exit</function>.
</para>
<example>

View File

@ -20,7 +20,7 @@
<para>
Составляет полное имя файла из параметра <parameter>filename</parameter>, используя пути включения
в соответствии с теми же правилами, что и функции
<function>fopen</function>/<link linkend="function.include"><literal>include</literal></link>.
<function>fopen</function>/<function>include</function>.
</para>
</refsect1>