archived-doc-es/reference/filesystem/functions/tempnam.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 65ba344afa6dfcef01797d6aa91a4e671f26d55d Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.tempnam">
 <refnamediv>
  <refname>tempnam</refname>
  <refpurpose>Crea un fichero con un nombre de fichero único</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>tempnam</methodname>
   <methodparam><type>string</type><parameter>dir</parameter></methodparam>
   <methodparam><type>string</type><parameter>prefix</parameter></methodparam>
  </methodsynopsis>
  <para>
   Crea un fichero con un nombre de fichero único, cuyo permiso de acceso está establecido a 0600,
   en el directorio especificado. Si el directorio no existe o no es escribible, <function>tempnam</function>
   puede generar un fichero en el directorio temporal del sistema, y devolver
   la ruta completa de este fichero, incluyendo su nombre.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>dir</parameter></term>
     <listitem>
      <para>
       El directorio donde el nombre de fichero temporal será creado.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>prefix</parameter></term>
     <listitem>
      <para>
       El prefijo del nombre de fichero temporal generado.
      </para>
      <note>
       <simpara>
        Windows usa sólo los tres primeros caracteres del prefijo.
       </simpara>
      </note>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve el nuevo nombre del fichero temporal, o &false; si
   falla.
  </para>
 </refsect1>
 
 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>4.0.3</entry>
       <entry>
        El comportamiento de esta función cambió en 4.0.3. El fichero temporal también es
        creado para evitar una competición donde el fichero pueda aparecer en el
        sistema de ficheros entre el periodo en que la cadena fue generada y antes de que
        el script se dedique a crear el fichero. Observe que se necesita
        eliminar el fichero en caso de que no se requiera más, no se hace
        automáticamente.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>tempnam</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$nombre_fichero_tmp = tempnam("/tmp", "FOO");

$gestor = fopen($nombre_fichero_tmp, "w");
fwrite($gestor, "escribiendo en el fichero temporal");
fclose($gestor);

// hacer aquí algo

unlink($nombre_fichero_tmp);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <simpara>
    Si PHP no puede crear un fichero en el parámetro <parameter>directory</parameter>
    especificado, retrocede al predeterminado del sistema. En NTFS esto también ocurre
    si el parámetro <parameter>directory</parameter> contiene más de 65534 ficheros.
   </simpara>
  </note>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>tmpfile</function></member>
    <member><function>sys_get_temp_dir</function></member>
    <member><function>unlink</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
-->