Files
php-doc-ru/reference/filesystem/functions/tmpfile.xml
2023-01-25 23:35:57 +03:00

103 lines
3.1 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 65bea242c8fe4217602a9759eb8289ddf0d9e899 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.tmpfile">
<refnamediv>
<refname>tmpfile</refname>
<refpurpose>Создаёт временный файл</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>resource</type><type>false</type></type><methodname>tmpfile</methodname>
<void/>
</methodsynopsis>
<para>
Создаёт временный файл с уникальным именем, открывая его в режиме
бинарного чтения и записи (w+b) и возвращает файловый указатель.
</para>
<para>
Этот файл автоматически удаляется после закрытия (например, путём вызова
функции <function>fclose</function> или если не осталось
ни одной ссылки на указатель файла, возвращаемый <function>tmpfile</function>),
или при завершении работы скрипта.
</para>
<caution>
<simpara>
Если скрипт неожиданно завершится, временный файл не может быть удалён.
</simpara>
</caution>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает дескриптор файла, аналогичный тому, который возвращает
функция <function>fopen</function> для новых файлов&return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования функции <function>tmpfile</function></title>
<programlisting role="php">
<![CDATA[
<?php
$temp = tmpfile();
fwrite($temp, "записываем во временный файл");
fseek($temp, 0);
echo fread($temp, 1024);
fclose($temp); // происходит удаление файла
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
записываем во временный файл
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>tempnam</function></member>
<member><function>sys_get_temp_dir</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
-->