php/archived-doc-en
1
0
Fork 0
mirror of https://github.com/php/doc-en.git synced 2026-03-23 23:32:18 +01:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@325214 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Jakub Vrana
2012-04-15 21:45:34 +00:00
parent a1daee7a1a
commit 84b8fca68f
68 changed files with 153 additions and 153 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
appendices/aliases.xml
View File

@@ -123,7 +123,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">Miscellaneous functions</link></entry>
</row>
<row>

8
appendices/ini.core.xml
View File

@@ -1043,7 +1043,7 @@
<para>
Specifies the name of a file that is automatically parsed
before the main file. The file is included as if it was
called with the <link linkend="function.require"><literal>require</literal></link> function, so
called with the <function>require</function> function, so
<link linkend="ini.include-path">include_path</link> is used.</para>
<para>
The special value <literal>none</literal>
@@ -1061,14 +1061,14 @@
<para>
Specifies the name of a file that is automatically parsed
after the main file. The file is included as if it was
called with the <link linkend="function.require"><literal>require</literal></link> function, so
called with the <function>require</function> function, so
<link linkend="ini.include-path">include_path</link> is used.</para>
<para>
The special value <literal>none</literal>
disables auto-appending.
<note>
<simpara>
If the script is terminated with <link linkend="function.exit"><literal>exit</literal></link>,
If the script is terminated with <function>exit</function>,
auto-append will <emphasis>not</emphasis> occur.</simpara>
</note>
</para>
@@ -1278,7 +1278,7 @@
<listitem>
<para>
Specifies a list of directories where the
<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> and <function>file_get_contents</function>
functions look for files. The format is like the system's

6
appendices/migration5.xml
View File

@@ -137,17 +137,17 @@
<listitem>
<simpara>
If there are functions defined in the included file, they can be used in the
main file independent if they are before <link linkend="function.return"><literal>return</literal></link> or after.
main file independent if they are before <function>return</function> or after.
If the file is included twice, PHP 5 issues fatal error because functions
were already declared, while PHP 4 doesn't complain about it.
It is recommended to use <link linkend="function.include-once"><literal>include_once</literal></link> instead of
It is recommended to use <function>include_once</function> instead of
checking if the file was already included and conditionally return inside
the included file.
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="function.include-once"><literal>include_once</literal></link> and <link linkend="function.require-once"><literal>require_once</literal></link>
<function>include_once</function> and <function>require_once</function>
first normalize the path of included file on Windows so that including
A.php and a.php include the file just once.
</simpara>

2
appendices/migration53.xml
View File

@@ -149,7 +149,7 @@
<function>func_get_arg</function>, <function>func_get_args</function> and
<function>func_num_args</function> can no longer be called from the
outermost scope of a file that has been included by calling
<link linkend="function.include"><literal>include</literal></link> or <link linkend="function.require"><literal>require</literal></link> from within
<function>include</function> or <function>require</function> from within
a function in the calling file.
</simpara>
</listitem>

18
appendices/reserved.xml
View File

@@ -241,16 +241,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>
@@ -258,10 +258,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>
@@ -270,18 +270,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>

14
appendices/tokens.xml
View File

@@ -239,7 +239,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>
@@ -312,7 +312,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>
@@ -388,12 +388,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>
@@ -598,7 +598,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>
@@ -627,12 +627,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>

2
chapters/tutorial.xml
View File

@@ -108,7 +108,7 @@
<para>
This program is extremely simple and you really did not need to use
PHP to create a page like this. All it does is display:
<literal>Hello World</literal> using the PHP <link linkend="function.echo"><literal>echo</literal></link>
<literal>Hello World</literal> using the PHP <function>echo</function>
statement. Note that the file <emphasis>does not need to be executable</emphasis>
or special in any way. The server finds out that this file needs to be interpreted
by PHP because you used the ".php" extension, which the server is configured

4
faq/using.xml
View File

@@ -212,8 +212,8 @@ echo "myfunc($variable) = " . myfunc($variable);
<para>
To be able to use the results of your function in an expression (such
as concatenating it with other strings in the example above), you need
to <link linkend="function.return"><literal>return</literal></link> the value,
not <link linkend="function.echo"><literal>echo</literal></link> it.
to <function>return</function> the value,
not <function>echo</function> it.
</para>
</answer>
</qandaentry>

2
features/commandline.xml
View File

@@ -148,7 +148,7 @@
<entry>&true;</entry>
<entry>
In a shell environment, it is usually desirable for output, such as
from <link linkend="function.print"><literal>print</literal></link>, <link linkend="function.echo"><literal>echo</literal></link> and
from <function>print</function>, <function>echo</function> and
friends, to be displayed immediately, and not held in a buffer.
Nonetheless, it is still possible to use
<link linkend="ref.outcontrol">output buffering</link> to

10
features/remote-files.xml
View File

@@ -8,9 +8,9 @@
&php.ini;, you can use <acronym>HTTP</acronym> and <acronym>FTP</acronym>
URLs with most of the functions
that take a filename as a parameter. In addition, URLs can be
used with the <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> and
<link linkend="function.require-once"><literal>require_once</literal></link> statements (since PHP 5.2.0,
used with the <function>include</function>,
<function>include_once</function>, <function>require</function> and
<function>require_once</function> statements (since PHP 5.2.0,
<option>allow_url_include</option> must be enabled for these).
See <xref linkend="wrappers"/> for more information about the protocols
supported by PHP.
@@ -27,8 +27,8 @@
<para>
The Windows versions of PHP earlier than PHP 4.3
did not support remote file accessing for the following functions:
<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>,
and the imagecreatefromXXX functions in the <xref linkend="ref.image"/>
extension.
</para>

2
internals2/ze1/zendapi/printing.xml
View File

@@ -4,7 +4,7 @@
<title>Printing Information</title>
<para>
Often it's necessary to print messages to the output stream from
your module, just as <link linkend="function.print"><literal>print</literal></link> would be used
your module, just as <function>print</function> would be used
within a script. PHP offers functions for most generic tasks, such
as printing warning messages, generating output for
<function>phpinfo</function>, and so on. The following sections

6
language/basic-syntax.xml
View File

@@ -87,7 +87,7 @@ echo "Last statement";
<para>
For outputting large blocks of text, dropping out of PHP parsing mode is
generally more efficient than sending all of the text through
<link linkend="function.echo"><literal>echo</literal></link> or <link linkend="function.print"><literal>print</literal></link>.
<function>echo</function> or <function>print</function>.
</para>
<para>
There are four different pairs of opening and closing tags
@@ -194,8 +194,8 @@ echo "Last statement";
<note>
<para>
The closing tag of a PHP block at the end of a file is optional,
and in some cases omitting it is helpful when using <link linkend="function.include"><literal>include</literal></link>
or <link linkend="function.require"><literal>require</literal></link>, so unwanted whitespace will
and in some cases omitting it is helpful when using <function>include</function>
or <function>require</function>, so unwanted whitespace will
not occur at the end of files, and you will still be able to add
headers to the response later. It is also handy if you use output
buffering, and would not like to see added unwanted whitespace

2
language/control-structures/continue.xml
View File

@@ -96,7 +96,7 @@ for ($i = 0; $i < 5; ++$i) {
</screen>
<para>
because the entire <literal>continue print "$i\n";</literal> is evaluated
as a single expression, and so <link linkend="function.print"><literal>print</literal></link> is called only
as a single expression, and so <function>print</function> is called only
when <literal>$i == 2</literal> is true. (The return value of
<literal>print</literal> is passed to <literal>continue</literal> as the
numeric argument.)

4
language/control-structures/include-once.xml
View File

@@ -7,7 +7,7 @@
<para>
The <literal>include_once</literal> statement includes and evaluates
the specified file during the execution of the script.
This is a behavior similar to the <link linkend="function.include"><literal>include</literal></link> statement,
This is a behavior similar to the <function>include</function> statement,
with the only difference being that if the code from a file has already
been included, it will not be included again. As the name suggests,
it will be included just once.
@@ -19,7 +19,7 @@
problems such as function redefinitions, variable value reassignments, etc.
</para>
<para>
See the <link linkend="function.include"><literal>include</literal></link> documentation for information about
See the <function>include</function> documentation for information about
how this function works.
</para>
<para>

20
language/control-structures/include.xml
View File

@@ -9,7 +9,7 @@
the specified file.
</simpara>
<simpara>
The documentation below also applies to <link linkend="function.require"><literal>require</literal></link>.
The documentation below also applies to <function>require</function>.
</simpara>
<simpara>
Files are included based on the file path given or, if none is given, the
@@ -20,7 +20,7 @@
<literal>include</literal> construct will emit a
<link linkend="errorfunc.constants.errorlevels.e-warning">warning</link> if
it cannot find a file; this is different behavior from
<link linkend="function.require"><literal>require</literal></link>, which will emit a
<function>require</function>, which will emit a
<link linkend="errorfunc.constants.errorlevels.e-error">fatal error</link>.
</simpara>
<simpara>
@@ -181,7 +181,7 @@ include 'file.php'; // Works.
information.
</para>
<simpara>
Handling Returns: It is possible to execute a <link linkend="function.return"><literal>return</literal></link>
Handling Returns: It is possible to execute a <function>return</function>
statement inside an included file in order to terminate processing in that
file and return to the script which called it. Also, it's possible to return
values from included files. You can take the value of the include call as
@@ -217,7 +217,7 @@ if ((include 'vars.php') == 'OK') {
</para>
<para>
<example>
<title><literal>include</literal> and the <link linkend="function.return"><literal>return</literal></link> statement</title>
<title><literal>include</literal> and the <function>return</function> statement</title>
<programlisting role="php">
<![CDATA[
return.php
@@ -255,17 +255,17 @@ echo $bar; // prints 1
<simpara>
<literal>$bar</literal> is the value <literal>1</literal> because the include
was successful. Notice the difference between the above examples. The first uses
<link linkend="function.return"><literal>return</literal></link> within the included file while the other does not.
<function>return</function> within the included file while the other does not.
If the file can't be included, &false; is returned and
<constant>E_WARNING</constant> is issued.
</simpara>
<para>
If there are functions defined in the included file, they can be used in the
main file independent if they are before <link linkend="function.return"><literal>return</literal></link> or after.
main file independent if they are before <function>return</function> or after.
If the file is included twice, PHP 5 issues fatal error because functions
were already declared, while PHP 4 doesn't complain about functions
defined after <link linkend="function.return"><literal>return</literal></link>.
It is recommended to use <link linkend="function.include-once"><literal>include_once</literal></link> instead of
defined after <function>return</function>.
It is recommended to use <function>include_once</function> instead of
checking if the file was already included and conditionally return inside
the included file.
</para>
@@ -306,8 +306,8 @@ function get_include_contents($filename) {
&note.language-construct;
<simpara>
See also <link linkend="function.require"><literal>require</literal></link>, <link linkend="function.require-once"><literal>require_once</literal></link>,
<link linkend="function.include-once"><literal>include_once</literal></link>, <function>get_included_files</function>,
See also <function>require</function>, <function>require_once</function>,
<function>include_once</function>, <function>get_included_files</function>,
<function>readfile</function>, <function>virtual</function>, and
<link linkend="ini.include-path">include_path</link>.
</simpara>

4
language/control-structures/require-once.xml
View File

@@ -6,11 +6,11 @@
<?phpdoc print-version-for="require_once"?>
<para>
The <literal>require_once</literal> statement is identical to
<link linkend="function.require"><literal>require</literal></link> except PHP will check if the file has
<function>require</function> except PHP will check if the file has
already been included, and if so, not include (require) it again.
</para>
<para>
See the <link linkend="function.include-once"><literal>include_once</literal></link> documentation for information
See the <function>include_once</function> documentation for information
about the <literal>_once</literal> behaviour, and how it differs from
its non <literal>_once</literal> siblings.
</para>

6
language/control-structures/require.xml
View File

@@ -6,14 +6,14 @@
<?phpdoc print-version-for="require"?>
<para>
<literal>require</literal> is identical to <link linkend="function.include"><literal>include</literal></link>
<literal>require</literal> is identical to <function>include</function>
except upon failure it will also produce a fatal <constant>E_COMPILE_ERROR</constant>
level error. In other words, it will halt the script whereas
<link linkend="function.include"><literal>include</literal></link> only emits a warning
<function>include</function> only emits a warning
(<constant>E_WARNING</constant>) which allows the script to continue.
</para>
<para>
See the <link linkend="function.include"><literal>include</literal></link> documentation for how this works.
See the <function>include</function> documentation for how this works.
</para>
</sect1>

6
language/control-structures/return.xml
View File

@@ -14,11 +14,11 @@
<simpara>
If called from the global scope, then execution of the current
script file is ended. If the current script file was
<link linkend="function.include"><literal>include</literal></link>d or <link linkend="function.require"><literal>require</literal></link>d,
<function>include</function>d or <function>require</function>d,
then control is passed back to the calling file. Furthermore, if
the current script file was <link linkend="function.include"><literal>include</literal></link>d, then
the current script file was <function>include</function>d, then
the value given to <literal>return</literal> will be returned as
the value of the <link linkend="function.include"><literal>include</literal></link> call. If
the value of the <function>include</function> call. If
<literal>return</literal> is called from within the main script
file, then script execution ends. If the current script file was
named by the <link

12
language/functions.xml
View File

@@ -385,18 +385,18 @@ Making a bowl of acidophilus raspberry.
Values are returned by using the optional return statement. Any
type may be returned, including arrays and objects. This causes the
function to end its execution immediately and pass control back to
the line from which it was called. See <link linkend="function.return"><literal>return</literal></link>
the line from which it was called. See <function>return</function>
for more information.
</para>
<note>
<para>
If the <link linkend="function.return"><literal>return</literal></link> is omitted the value &null; will be
If the <function>return</function> is omitted the value &null; will be
returned.
</para>
</note>
<para>
<example>
<title>Use of <link linkend="function.return"><literal>return</literal></link></title>
<title>Use of <function>return</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -471,10 +471,10 @@ $newref =& returns_reference();
</para>
<para>
Variable functions won't work with language constructs such
as <link linkend="function.echo"><literal>echo</literal></link>, <link linkend="function.print"><literal>print</literal></link>,
as <function>echo</function>, <function>print</function>,
<function>unset</function>, <function>isset</function>,
<function>empty</function>, <link linkend="function.include"><literal>include</literal></link>,
<link linkend="function.require"><literal>require</literal></link> and the like. Utilize wrapper functions to make
<function>empty</function>, <function>include</function>,
<function>require</function> and the like. Utilize wrapper functions to make
use of any of these constructs as variable functions.
</para>
<para>

2
language/oop5/changelog.xml
View File

@@ -105,7 +105,7 @@
<entry>
Changed: The <link linkend="object.tostring">__toString()</link>
method was only called when it was directly combined with
<link linkend="function.echo"><literal>echo</literal></link> or <link linkend="function.print"><literal>print</literal></link>.
<function>echo</function> or <function>print</function>.
But now, it is called in any string context (e.g. in
<function>printf</function> with <literal>%s</literal> modifier) but not
in other types contexts (e.g. with <literal>%d</literal> modifier).

2
language/oop5/decon.xml
View File

@@ -126,7 +126,7 @@ $obj = new MyDestructableClass();
</para>
<para>
The destructor will be called even if script execution is stopped using
<link linkend="function.exit"><literal>exit</literal></link>. Calling <link linkend="function.exit"><literal>exit</literal></link> in a destructor
<function>exit</function>. Calling <function>exit</function> in a destructor
will prevent the remaining shutdown routines from executing.
</para>
<note>

2
language/oop5/magic.xml
View File

@@ -172,7 +172,7 @@ Hello
<para>
It is worth noting that before PHP 5.2.0 the <link linkend="object.tostring">__toString()</link>
method was only called when it was directly combined with
<link linkend="function.echo"><literal>echo</literal></link> or <link linkend="function.print"><literal>print</literal></link>.
<function>echo</function> or <function>print</function>.
Since PHP 5.2.0, it is called in any string context (e.g. in
<function>printf</function> with <literal>%s</literal> modifier) but not
in other types contexts (e.g. with <literal>%d</literal> modifier).

2
language/operators.xml
View File

@@ -1451,7 +1451,7 @@ $value = @$cache[$key];
<link linkend="language.expressions">expressions</link>. A simple rule
of thumb is: if you can take the value of something, you can prepend
the @ operator to it. For instance, you can prepend it to variables,
function and <link linkend="function.include"><literal>include</literal></link> calls, constants, and
function and <function>include</function> calls, constants, and
so forth. You cannot prepend it to function or class definitions,
or conditional structures such as <literal>if</literal> and
&foreach;, and so forth.

6
language/types/callable.xml
View File

@@ -22,10 +22,10 @@
<para>
A PHP function is passed by its name as a <type>string</type>. Any built-in
or user-defined function can be used, except language constructs such as:
<function>array</function>, <link linkend="function.echo"><literal>echo</literal></link>,
<function>array</function>, <function>echo</function>,
<function>empty</function>, <function>eval</function>,
<link linkend="function.exit"><literal>exit</literal></link>, <function>isset</function>,
<function>list</function>, <link linkend="function.print"><literal>print</literal></link> or
<function>exit</function>, <function>isset</function>,
<function>list</function>, <function>print</function> or
<function>unset</function>.
</para>

6
language/types/string.xml
View File

@@ -841,7 +841,7 @@ $str[strlen($str)-1] = 'e';
<literal>(string)</literal> cast or the <function>strval</function> function.
<type>String</type> conversion is automatically done in the scope of an
expression where a <type>string</type> is needed. This happens when using the
<link linkend="function.echo"><literal>echo</literal></link> or <link linkend="function.print"><literal>print</literal></link> functions, or when a
<function>echo</function> or <function>print</function> functions, or when a
variable is compared to a <type>string</type>. The sections on
<link linkend="language.types">Types</link> and
<link linkend="language.types.type-juggling">Type Juggling</link> will make
@@ -871,8 +871,8 @@ $str[strlen($str)-1] = 'e';
<para>
<type>Array</type>s are always converted to the <type>string</type>
<literal>"Array"</literal>; because of this, <link linkend="function.echo"><literal>echo</literal></link> and
<link linkend="function.print"><literal>print</literal></link> can not by themselves show the contents of an
<literal>"Array"</literal>; because of this, <function>echo</function> and
<function>print</function> can not by themselves show the contents of an
<type>array</type>. To view a single element, use a construction such as
<literal>echo $arr['foo']</literal>. See below for tips on viewing the entire
contents.

2
language/variables.xml
View File

@@ -122,7 +122,7 @@ $bar = &test(); // Invalid.
<para>
It is not necessary to initialize variables in PHP however it is a very
good practice. Uninitialized variables have a default value of their type depending on the context in which they are used
- booleans default to &false;, integers and floats default to zero, strings (e.g. used in <link linkend="function.echo"><literal>echo</literal></link>) are
- booleans default to &false;, integers and floats default to zero, strings (e.g. used in <function>echo</function>) are
set as an empty string and arrays become to an empty array.
</para>
<para>

2
language/wrappers/php.xml
View File

@@ -69,7 +69,7 @@
<para>
<filename>php://output</filename> is a write-only stream that allows you to
write to the output buffer mechanism in the same way as
<link linkend="function.print"><literal>print</literal></link> and <link linkend="function.echo"><literal>echo</literal></link>.
<function>print</function> and <function>echo</function>.
</para>
</refsect2>

2
reference/apache/functions/apache-child-terminate.xml
View File

@@ -68,7 +68,7 @@
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="function.exit"><literal>exit</literal></link></member>
<member><function>exit</function></member>
</simplelist>
</para>
</refsect1>

4
reference/apache/functions/virtual.xml
View File

@@ -75,8 +75,8 @@
<entry>4.0.6</entry>
<entry>
This function may be used on PHP files. However, it is typically
better to use <link linkend="function.include"><literal>include</literal></link> or
<link linkend="function.require"><literal>require</literal></link> for PHP files.
better to use <function>include</function> or
<function>require</function> for PHP files.
</entry>
</row>
</tbody>

2
reference/apc/ini.xml
View File

@@ -618,7 +618,7 @@
</term>
<listitem>
<para>
Optimize <link linkend="function.include-once"><literal>include_once</literal></link> and <link linkend="function.require-once"><literal>require_once</literal></link>
Optimize <function>include_once</function> and <function>require_once</function>
calls and avoid the expensive system calls used.
</para>
<warning>

2
reference/com/variant.xml
View File

@@ -117,7 +117,7 @@ print "The value is " . $v . "<br/>";
returned as an instance of the VARIANT class. You can force PHP to
convert or evaluate the variant as a PHP native type by using a casting
operator explicitly, or implicitly casting to a string by
<link linkend="function.print"><literal>print</literal></link>ing it. You may use the wide range of variant
<function>print</function>ing it. You may use the wide range of variant
functions to perform arithmetic operations on variants without forcing a
conversion or risking a loss of data.
</para>

2
reference/errorfunc/functions/set-error-handler.xml
View File

@@ -38,7 +38,7 @@
operator</link>.
</para>
<para>
Also note that it is your responsibility to <link linkend="function.die"><literal>die</literal></link> if
Also note that it is your responsibility to <function>die</function> if
necessary. If the error-handler function returns, script execution
will continue with the next statement after the one that caused an error.
</para>

2
reference/filesystem/functions/file.xml
View File

@@ -235,7 +235,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>

4
reference/filesystem/functions/readfile.xml
View File

@@ -114,8 +114,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>

10
reference/filesystem/ini.xml
View File

@@ -91,9 +91,9 @@
<warning>
<para>
On Windows versions prior to PHP 4.3.0, the following functions do not
support remote file accessing: <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> and the imagecreatefromXXX
support remote file accessing: <function>include</function>,
<function>include_once</function>, <function>require</function>,
<function>require_once</function> and the imagecreatefromXXX
functions in the <xref linkend="ref.image"/> extension.
</para>
</warning>
@@ -108,8 +108,8 @@
<listitem>
<para>
This option allows the use of URL-aware fopen wrappers with the following
functions: <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>.
functions: <function>include</function>, <function>include_once</function>,
<function>require</function>, <function>require_once</function>.
</para>
<note>
<para>

4
reference/funchand/functions/func-get-arg.xml
View File

@@ -68,8 +68,8 @@
<entry>5.3.0</entry>
<entry>
If this function is called from the outermost scope of a file
which has been included by calling <link linkend="function.include"><literal>include</literal></link>
or <link linkend="function.require"><literal>require</literal></link> from within a function in the
which has been included by calling <function>include</function>
or <function>require</function> from within a function in the
calling file, it now generates a warning and returns &false;.
</entry>
</row>

4
reference/funchand/functions/func-get-args.xml
View File

@@ -52,8 +52,8 @@
<entry>5.3.0</entry>
<entry>
If this function is called from the outermost scope of a file
which has been included by calling <link linkend="function.include"><literal>include</literal></link>
or <link linkend="function.require"><literal>require</literal></link> from within a function in the
which has been included by calling <function>include</function>
or <function>require</function> from within a function in the
calling file, it now generates a warning and returns &false;.
</entry>
</row>

4
reference/funchand/functions/func-num-args.xml
View File

@@ -52,8 +52,8 @@
<entry>5.3.0</entry>
<entry>
If this function is called from the outermost scope of a file
which has been included by calling <link linkend="function.include"><literal>include</literal></link>
or <link linkend="function.require"><literal>require</literal></link> from within a function in the
which has been included by calling <function>include</function>
or <function>require</function> from within a function in the
calling file, it now generates a warning and returns -1.
</entry>
</row>

2
reference/funchand/functions/function-exists.xml
View File

@@ -43,7 +43,7 @@
<note>
<para>
This function will return &false; for constructs, such as
<link linkend="function.include-once"><literal>include_once</literal></link> and <link linkend="function.echo"><literal>echo</literal></link>.
<function>include_once</function> and <function>echo</function>.
</para>
</note>
</refsect1>

10
reference/funchand/functions/register-shutdown-function.xml
View File

@@ -16,12 +16,12 @@
</methodsynopsis>
<para>
Registers a <parameter>callback</parameter> to be executed after script
execution finishes or <link linkend="function.exit"><literal>exit</literal></link> is called.
execution finishes or <function>exit</function> is called.
</para>
<para>
Multiple calls to <function>register_shutdown_function</function> can be
made, and each will be called in the same order as they were registered.
If you call <link linkend="function.exit"><literal>exit</literal></link> within one registered shutdown
If you call <function>exit</function> within one registered shutdown
function, processing will stop completely and no other registered
shutdown functions will be called.
</para>
@@ -97,8 +97,8 @@
In earlier versions under Apache, the registered shutdown functions
were called after the request has been completed (including sending
any output buffers), so it was not possible to send output to the
browser using <link linkend="function.echo"><literal>echo</literal></link> or
<link linkend="function.print"><literal>print</literal></link>, or retrieve the contents of any output
browser using <function>echo</function> or
<function>print</function>, or retrieve the contents of any output
buffers using <function>ob_get_contents</function>.
Headers were also always already sent.
</entry>
@@ -149,7 +149,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>The section on <link
linkend="features.connection-handling">connection handling</link></member>
</simplelist>

4
reference/inclued/book.xml
View File

@@ -13,8 +13,8 @@
</para>
<para>
The files may have been included using
<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>, or <link linkend="function.require-once"><literal>require_once</literal></link>.
<function>include</function>, <function>include_once</function>,
<function>require</function>, or <function>require_once</function>.
</para>
<para>
Class inheritance dependencies are also reported.

2
reference/inclued/functions/inclued-get-data.xml
View File

@@ -79,7 +79,7 @@ Array
<simplelist>
<member><link linkend="inclued.examples-implementation">inclued examples</link></member>
<member><function>debug_backtrace</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><function>include</function></member>
</simplelist>
</para>
</refsect1>

2
reference/info/functions/get-include-path.xml
View File

@@ -52,7 +52,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>

18
reference/info/functions/get-included-files.xml
View File

@@ -14,8 +14,8 @@
</methodsynopsis>
<para>
Gets the names of all files that have been included using
<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> or <link linkend="function.require-once"><literal>require_once</literal></link>.
<function>include</function>, <function>include_once</function>,
<function>require</function> or <function>require_once</function>.
</para>
</refsect1>
@@ -27,7 +27,7 @@
<para>
The script originally called is considered an "included file," so it will
be listed together with the files referenced by
<link linkend="function.include"><literal>include</literal></link> and family.
<function>include</function> and family.
</para>
<para>
Files that are included or required multiple times only show up once in
@@ -54,8 +54,8 @@
required files ended in the extension <literal>.php</literal>; other
extensions would not be returned. The array returned by
<function>get_included_files</function> was an associative array and
only listed files included by <link linkend="function.include"><literal>include</literal></link> and
<link linkend="function.include-once"><literal>include_once</literal></link>.
only listed files included by <function>include</function> and
<function>include_once</function>.
</entry>
</row>
</tbody>
@@ -116,10 +116,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>

8
reference/info/functions/main.xml
View File

@@ -37,19 +37,19 @@
</thead>
<tbody>
<row>
<entry><link linkend="function.include"><literal>include</literal></link></entry>
<entry><function>include</function></entry>
<entry>5.1.0</entry>
</row>
<row>
<entry><link linkend="function.include-once"><literal>include_once</literal></link></entry>
<entry><function>include_once</function></entry>
<entry>5.1.0</entry>
</row>
<row>
<entry><link linkend="function.require"><literal>require</literal></link></entry>
<entry><function>require</function></entry>
<entry>5.1.0</entry>
</row>
<row>
<entry><link linkend="function.require-once"><literal>require_once</literal></link></entry>
<entry><function>require_once</function></entry>
<entry>5.1.0</entry>
</row>
</tbody>

2
reference/info/functions/restore-include-path.xml
View File

@@ -63,7 +63,7 @@ echo get_include_path(); // .:/usr/local/lib/php
<member><function>ini_restore</function></member>
<member><function>get_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>

2
reference/info/functions/set-include-path.xml
View File

@@ -91,7 +91,7 @@ set_include_path(get_include_path() . PATH_SEPARATOR . $path);
<member><function>ini_set</function></member>
<member><function>get_include_path</function></member>
<member><function>restore_include_path</function></member>
<member><link linkend="function.include"><literal>include</literal></link></member>
<member><function>include</function></member>
</simplelist>
</para>
</refsect1>

2
reference/misc/functions/die.xml
View File

@@ -9,7 +9,7 @@
<refsect1 role="description">
&reftitle.description;
<para>
This language construct is equivalent to <link linkend="function.exit"><literal>exit</literal></link>.
This language construct is equivalent to <function>exit</function>.
</para>
</refsect1>

2
reference/misc/functions/exit.xml
View File

@@ -149,7 +149,7 @@ echo 'This will not be output.';
<note>
<para>
This language construct is equivalent to <link linkend="function.die"><literal>die</literal></link>.
This language construct is equivalent to <function>die</function>.
</para>
</note>
</refsect1>

4
reference/misc/functions/php-check-syntax.xml
View File

@@ -96,7 +96,7 @@
<row>
<entry>5.0.3</entry>
<entry>
Calling <link linkend="function.exit"><literal>exit</literal></link> after
Calling <function>exit</function> after
<function>php_check_syntax</function> resulted in a Segfault.
</entry>
</row>
@@ -135,7 +135,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>

2
reference/network/functions/header.xml
View File

@@ -23,7 +23,7 @@
Remember that <function>header</function> must be called before any
actual output is sent, either by normal HTML tags, blank lines in a
file, or from PHP. It is a very common error to read code with
<link linkend="function.include"><literal>include</literal></link>, or <link linkend="function.require"><literal>require</literal></link>,
<function>include</function>, or <function>require</function>,
functions, or another file access function, and have spaces or empty
lines that are output before <function>header</function> is called.
The same problem exists when using a single PHP/HTML file.

4
reference/nsapi/functions/nsapi-virtual.xml
View File

@@ -25,8 +25,8 @@
</para>
<para>
You cannot make recursive requests with this function to other PHP scripts.
If you want to include PHP scripts, use <link linkend="function.include"><literal>include</literal></link> or
<link linkend="function.require"><literal>require</literal></link>.
If you want to include PHP scripts, use <function>include</function> or
<function>require</function>.
</para>
<note>
<para>

2
reference/outcontrol/book.xml
View File

@@ -15,7 +15,7 @@
after your script has began outputting data. The Output Control
functions do not affect headers sent using
<function>header</function> or <function>setcookie</function>,
only functions such as <link linkend="function.echo"><literal>echo</literal></link> and data between
only functions such as <function>echo</function> and data between
blocks of PHP code.
</para>
<note>

2
reference/outcontrol/examples.xml
View File

@@ -24,7 +24,7 @@ ob_end_flush();
</example>
</para>
<para>
In the above example, the output from <link linkend="function.echo"><literal>echo</literal></link>
In the above example, the output from <function>echo</function>
would be stored in the output buffer until
<function>ob_end_flush</function> was called. In the mean time,
the call to <function>setcookie</function> successfully stored a

2
reference/outcontrol/ini.xml
View File

@@ -101,7 +101,7 @@
output layer to flush itself automatically after every output block.
This is equivalent to calling the PHP function
<function>flush</function> after each and every call to
<link linkend="function.print"><literal>print</literal></link> or <link linkend="function.echo"><literal>echo</literal></link> and each and
<function>print</function> or <function>echo</function> and each and
every <literal>HTML</literal> block.
</para>
<para>

2
reference/parsekit/functions/parsekit-compile-file.xml
View File

@@ -24,7 +24,7 @@
<listitem>
<para>
A string containing the name of the file to compile.
Similar to the argument to <link linkend="function.include"><literal>include</literal></link>.
Similar to the argument to <function>include</function>.
</para>
</listitem>
</varlistentry>

2
reference/pdo/pdo/exec.xml
View File

@@ -60,7 +60,7 @@
<para>
The following example incorrectly relies on the return value of
<function>PDO::exec</function>, wherein a statement that affected 0 rows
results in a call to <link linkend="function.die"><literal>die</literal></link>:
results in a call to <function>die</function>:
<programlisting role="php">
<![CDATA[
<?php

2
reference/phar/Phar/setAlias.xml
View File

@@ -20,7 +20,7 @@
ensure that use of the <literal>phar</literal> stream wrapper to access internal
files always works regardless of the location of the phar archive on the
filesystem. Another alternative is to rely upon Phar's interception of
<link linkend="function.include"><literal>include</literal></link> or to use <function>Phar::interceptFileFuncs</function>
<function>include</function> or to use <function>Phar::interceptFileFuncs</function>
and use relative paths.
</para>
</refsect1>

2
reference/phar/book.xml
View File

@@ -30,7 +30,7 @@
<para>
Phar implements this functionality through a <link linkend="book.stream">Stream
Wrapper</link>. Normally, to use an external file within a PHP script, you
would use <link linkend="function.include"><literal>include</literal></link>
would use <function>include</function>
</para>
<para>
<example>

2
reference/runkit/functions/runkit-import.xml
View File

@@ -16,7 +16,7 @@
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>RUNKIT_IMPORT_CLASS_METHODS</initializer></methodparam>
</methodsynopsis>
<para>
Similar to <link linkend="function.include"><literal>include</literal></link> however any code residing outside
Similar to <function>include</function> however any code residing outside
of a function or class is simply ignored.
Additionally, depending on the value of <parameter>flags</parameter>,
any functions or classes which already exist in the currently running environment

4
reference/runkit/functions/runkit-sandbox-output-handler.xml
View File

@@ -15,8 +15,8 @@
<methodparam choice="opt"><type>mixed</type><parameter>callback</parameter></methodparam>
</methodsynopsis>
<para>
Ordinarily, anything output (such as with <link linkend="function.echo"><literal>echo</literal></link>
or <link linkend="function.print"><literal>print</literal></link>) will be output as though it were printed
Ordinarily, anything output (such as with <function>echo</function>
or <function>print</function>) will be output as though it were printed
from the parent's scope. Using <function>runkit_sandbox_output_handler</function>
however, output generated by the sandbox (including errors), can be captured
by a function outside of the sandbox.

8
reference/runkit/sandbox-parent.xml
View File

@@ -143,13 +143,13 @@ string(6) "Global"
Enabling <literal>parent_call</literal> will allow the sandbox
to call all functions available to the parent scope. Language
constructs are each controlled by their own setting:
<link linkend="function.print"><literal>print</literal></link> and <link linkend="function.echo"><literal>echo</literal></link> are
<function>print</function> and <function>echo</function> are
enabled with <literal>parent_echo</literal>.
<link linkend="function.die"><literal>die</literal></link> and <link linkend="function.exit"><literal>exit</literal></link> are
<function>die</function> and <function>exit</function> are
enabled with <literal>parent_die</literal>.
<function>eval</function> is enabled with <literal>parent_eval</literal>
while <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>, and <link linkend="function.require-once"><literal>require_once</literal></link>
while <function>include</function>, <function>include_once</function>,
<function>require</function>, and <function>require_once</function>
are enabled through <literal>parent_include</literal>.
</para>

8
reference/runkit/sandbox.xml
View File

@@ -205,10 +205,10 @@ bool(false)
Any function defined within the sandbox may be called as
a method on the sandbox object. This also includes a few
pseudo-function language constructs: <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>

4
reference/sam/setup.xml
View File

@@ -52,8 +52,8 @@
<para>
If you only intend to use the built-in MQTT support then you can build and
configure SAM as an extension or simply refer to
<filename>php_sam.php</filename> with a <link linkend="function.require"><literal>require</literal></link> or
<link linkend="function.require-once"><literal>require_once</literal></link> clause in your PHP script. In this case
<filename>php_sam.php</filename> with a <function>require</function> or
<function>require_once</function> clause in your PHP script. In this case
you need only install the code without building the extension using the pear
installer:
<screen>

2
reference/stream/functions/stream-resolve-include-path.xml
View File

@@ -16,7 +16,7 @@
<!-- <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> -->
</methodsynopsis>
<para>
Resolve <parameter>filename</parameter> against the include path according to the same rules as <function>fopen</function>/<link linkend="function.include"><literal>include</literal></link>.
Resolve <parameter>filename</parameter> against the include path according to the same rules as <function>fopen</function>/<function>include</function>.
</para>
</refsect1>

2
reference/strings/functions/echo.xml
View File

@@ -142,7 +142,7 @@ echo $some_var ? 'true': 'false'; // changing the statement around
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="function.print"><literal>print</literal></link></member>
<member><function>print</function></member>
<member><function>printf</function></member>
<member><function>flush</function></member>
<member><link linkend="language.types.string.syntax.heredoc">Heredoc syntax</link></member>

2
reference/strings/functions/print.xml
View File

@@ -104,7 +104,7 @@ END;
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="function.echo"><literal>echo</literal></link></member>
<member><function>echo</function></member>
<member><function>printf</function></member>
<member><function>flush</function></member>
<member><link linkend="language.types.string.syntax.heredoc">Heredoc syntax</link></member>

2
reference/strings/functions/printf.xml
View File

@@ -61,7 +61,7 @@
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="function.print"><literal>print</literal></link></member>
<member><function>print</function></member>
<member><function>sprintf</function></member>
<member><function>vprintf</function></member>
<member><function>sscanf</function></member>