is-writable.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 44aabb8f7e3cc8760d33b0ff60ffae362b9d1ed3 Maintainer: yago Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-writable">
 <refnamediv>
  <refname>is_writable</refname>
  <refpurpose>Indica si un archivo existe y es escribible</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>is_writable</methodname>
   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
  </methodsynopsis>
  <para>
   Devuelve &true; si <parameter>filename</parameter> existe y es
   escribible. El argumento nombre_archivo puede ser el nombre de un directorio, permitiendo así
   comprobar si el directorio es escribible.
  </para>
  <para>
   Tenga en cuenta que PHP puede estar accediendo al archivo bajo el id de ususario
   por el que se está ejecutando el servidor web (a menudo 'nobody'). Las limitaciones
   del modo seguro no se toman en cuenta.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>filename</parameter></term>
     <listitem>
      <para>
       El nombre de archivo que va a ser comprobado.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve &true; si el parámetro <parameter>filename</parameter> existe y es
   escribible.
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>is_writable</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$nombre_archivo = 'prueba.txt';
if (is_writable($nombre_archivo)) {
    echo 'El archivo es escribible';
} else {
    echo 'El archivo no es escribible';
}
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="errors">
  &reftitle.errors;
  &fs.emits.warning.on.failure;
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  
  &note.clearstatcache;
  &tip.fopen-wrapper.stat;
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>is_readable</function></member>
    <member><function>file_exists</function></member>
    <member><function>fwrite</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:"~/.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
-->