php-doc-en/reference/stream/functions/stream-resolve-include-path.xml
Jakub Vrana a9b26c34e4 Display language constructs without parentheses
Side effect of this change is that include, require and return are now properly linked. They weren't because they don't live inside <refentry> so PhD doesn't know about them.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@324522 c90b9560-bf6c-de11-be94-00142212c4b1
2012-03-25 08:39:30 +00:00

127 lines
3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xml:id="function.stream-resolve-include-path" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>stream_resolve_include_path</refname>
<refpurpose>
Resolve filename against the include path
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>stream_resolve_include_path</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<!-- <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>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
The filename to resolve.
</para>
</listitem>
</varlistentry>
<!--
<varlistentry>
<term><parameter>context</parameter></term>
<listitem>
<para>
A valid context resource created with <function>stream_context_create</function>.
</para>
</listitem>
</varlistentry>
-->
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns a <type>string</type> containing the resolved absolute filename, &return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>stream_resolve_include_path</function> example</title>
<para>
Basic usage example.
</para>
<programlisting role="php">
<![CDATA[
<?php
var_dump(stream_resolve_include_path("test.php"));
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
string(22) "/var/www/html/test.php"
]]>
</screen>
</example>
</para>
</refsect1>
<!-- FIXME PHP_6
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>6.0.0</entry>
<entry>
The <parameter>context</parameter> parameter was added.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->