Sophie

Sophie

distrib > Mandriva > 9.1 > ppc > media > main > by-pkgid > 0afeee9cca140e167a996902b9a677c5 > files > 2751

php-manual-en-4.3.0-2mdk.noarch.rpm

<HTML
><HEAD
><TITLE
>tempnam</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="PHP Manual"
HREF="index.html"><LINK
REL="UP"
TITLE="Filesystem functions"
HREF="ref.filesystem.html"><LINK
REL="PREVIOUS"
TITLE="symlink"
HREF="function.symlink.html"><LINK
REL="NEXT"
TITLE="tmpfile"
HREF="function.tmpfile.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=ISO-8859-1"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.symlink.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.tmpfile.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.tempnam"
></A
>tempnam</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN27038"
></A
><P
>    (PHP 3, PHP 4 )</P
>tempnam&nbsp;--&nbsp;Create file with unique file name</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN27041"
></A
><H2
>Description</H2
>string <B
CLASS="methodname"
>tempnam</B
> ( string dir, string prefix)<BR
></BR
><P
>&#13;     Creates a file with a unique filename in the specified directory.
     If the directory does not exist, <B
CLASS="function"
>tempnam()</B
> may
     generate a file in the system's temporary directory, and return
     the name of that. 
    </P
><P
>&#13;     Prior to PHP 4.0.6, the behaviour of the
     <B
CLASS="function"
>tempnam()</B
> function was system dependent. On
     Windows the TMP environment variable will override the
     <TT
CLASS="parameter"
><I
>dir</I
></TT
> parameter, on Linux the TMPDIR
     environment variable has precedence, while SVR4 will always use
     your <TT
CLASS="parameter"
><I
>dir</I
></TT
> parameter if the directory it
     points to exists. Consult your system documentation on the
     tempnam(3) function if in doubt.
    </P
><P
>&#13;     Returns the new temporary filename, or the <TT
CLASS="constant"
><B
>FALSE</B
></TT
> string on
     failure.
     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN27060"
></A
><P
><B
>Example 1. <B
CLASS="function"
>tempnam()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="php"
>$tmpfname = tempnam ("/tmp", "FOO");

$handle = fopen($tmpfname, "w");
fwrite($handle, "writing to tempfile");
fclose($handle);

// do here something

unlink($tmpfname);</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Note: </B
>
      This function's behavior changed in 4.0.3. The temporary file is also
      created to avoid a race condition where the file might appear in the
      filesystem between the time the string was generated and before the
      the script gets around to creating the file. Note, that you need
      to remove the file in case you need it no more, it is not done
      automatically.
     </P
></BLOCKQUOTE
></DIV
><P
>&#13;     See also <A
HREF="function.tmpfile.html"
><B
CLASS="function"
>tmpfile()</B
></A
> and <A
HREF="function.unlink.html"
><B
CLASS="function"
>unlink()</B
></A
>.
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.symlink.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.tmpfile.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>symlink</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.filesystem.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>tmpfile</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>