cvs: phpdoc /en/reference/posix constants.xml reference.xml /en/reference/posix/functions posix-access.xml

nlopess Sat Jan 8 07:04:27 2005 EDT Added files: /phpdoc/en/reference/posix constants.xml /phpdoc/en/reference/posix/functions posix-access.xml Modified files: /phpdoc/en/reference/posix reference.xml Log: new PHP 5.1 function: posix_access() http://cvs.php.net/diff.php/phpdoc/en/reference/posix/reference.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/posix/reference.xml diff -u phpdoc/en/reference/posix/reference.xml:1.6 phpdoc/en/reference/posix/reference.xml:1.7 --- phpdoc/en/reference/posix/reference.xml:1.6 Tue Feb 24 03:46:16 2004 +++ phpdoc/en/reference/posix/reference.xml Sat Jan 8 07:04:26 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <reference id="ref.posix"> <title>POSIX Functions</title> <titleabbrev>POSIX</titleabbrev> @@ -33,6 +33,7 @@ </section> &reference.posix.configure; + &reference.posix.constants; <section id="posix.seealso"> &reftitle.seealso; @@ -43,7 +44,6 @@ </para> </section> - </partintro> &reference.posix.functions; http://cvs.php.net/co.php/phpdoc/en/reference/posix/constants.xml?r=1.1&p=1 Index: phpdoc/en/reference/posix/constants.xml +++ phpdoc/en/reference/posix/constants.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <section id="posix.constants"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>POSIX_F_OK</constant> (<type>integer</type>) </term> <listitem> <simpara> Check whether the file exists. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>POSIX_R_OK</constant> (<type>integer</type>) </term> <listitem> <simpara> Check whether the file exists and has read permissions. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>POSIX_W_OK</constant> (<type>integer</type>) </term> <listitem> <simpara> Check whether the file exists and has write permissions. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>POSIX_X_OK</constant> (<type>integer</type>) </term> <listitem> <simpara> Check whether the file exists and has execute permissions. </simpara> </listitem> </varlistentry> </variablelist> <note> <para> These constants are available since PHP 5.1.0. </para> </note> </section> <!-- 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:"../../../../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 --> http://cvs.php.net/co.php/phpdoc/en/reference/posix/functions/posix-access.xml?r=1.1&p=1 Index: phpdoc/en/reference/posix/functions/posix-access.xml +++ phpdoc/en/reference/posix/functions/posix-access.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.posix-access"> <refnamediv> <refname>posix_access</refname> <refpurpose> Determine accessibility of a file </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>posix_access</methodname> <methodparam><type>string</type><parameter>file</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> <function>posix_access</function> checks the user's permission of a file. </para> &note.sm.uidcheck; </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>file</parameter></term> <listitem> <para> The name of the file to be tested. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>mode</parameter></term> <listitem> <para> A mask consisting of one or more of <constant>POSIX_F_OK</constant>, <constant>POSIX_R_OK</constant>, <constant>POSIX_W_OK</constant> and <constant>POSIX_X_OK</constant>. Defaults to <constant>POSIX_F_OK</constant>. </para> <para> <constant>POSIX_R_OK</constant>, <constant>POSIX_W_OK</constant> and <constant>POSIX_X_OK</constant> request checking whether the file exists and has read, write and execute permissions, respectively. <constant>POSIX_F_OK</constant> just requests checking for the existence of the file. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>posix_access</function> example</title> <para> This example will check if the $file is readable and writable, otherwise will print an error message. </para> <programlisting role="php"> <![CDATA[ <?php $file = 'some_file'; if (posix_access($file, POSIX_R_OK | POSIX_W_OK)) { echo 'The file is readable and writable!'; } else { $error = posix_get_last_error(); echo "Error $error: " . posix_strerror($error); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>posix_get_last_error</function></member> <member><function>posix_strerror</function></member> </simplelist> </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:"../../../../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 -->