is-readable.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fa99d27fdb00500e03b2d466dd42aca1bc8cab1d Maintainer: yago Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-readable">
 <refnamediv>
  <refname>is_readable</refname>
  <refpurpose>Indica si un fichero existe y es legible</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>is_readable</methodname>
   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
  </methodsynopsis>
  <para>
   Indica si un fichero existe y es legible.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>filename</parameter></term>
     <listitem>
      <para>
       La ruta del fichero.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve &true; si el fichero o directorio especificado por
   <parameter>filename</parameter> existe y es legible, &false; si no.
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>is_readable</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$nombre_fichero = 'prueba.txt';
if (is_readable($nombre_fichero)) {
    echo 'El fichero es legible';
} else {
    echo 'El fichero no es legible';
}
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="errors">
  &reftitle.errors;
  &fs.emits.warning.on.failure;
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  <para>
   Tenga en cuenta que PHP puede estar accediendo al fichero 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 antes de PHP 5.1.5.
  </para>
  &note.clearstatcache;
  &tip.fopen-wrapper.stat;
  <note>
   <para>
    La comprobación se realiza usando el UID/GID real en vez del efectivo.
   </para>
  </note>
  <para>
   Esta función podría devolver &true; si se le proporcina un directorio. Use
   <function>is_dir</function> para distinguir entre ficheros y directorios.
  </para>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>is_writable</function></member>
    <member><function>file_exists</function></member>
    <member><function>fgets</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
-->