.. highlightlang:: us

.. index:: GetTempFileName

.. _gettempfilename:

GetTempFileName
===============

.. us.tag  GetTempFileName ENGLISH FILE_MISC Changed500

:ref:`GetTempFileName` creates a name for a temporary file.

.. function::  ssName = GetTempFileName()
    ssTempFileName = GetTempFileName(ssDir)
    ssTempFileName = GetTempFileName(ssDir, ssPrefix)

.. us.return

**Return Value**

*ssTempFileName* is the temporary file name.

.. us.params

**Parameters**

.. uparam:: ssDir

   *ssDir* is a name of a existing directory where the temp file will be created.
   Default is the directory designated for temporary files.

.. uparam:: ssPrefix

   *ssPrefix* is a prefix string. The function uses up to the first three 
   characters of this string as the prefix of the file name. Default is ``~UP``.

.. us.comment

**Comment**

When the system shuts down, temporary files whose names have been created by this
function are not automatically deleted. To delete a temporary file, use
:ref:`DeleteFile`.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.0.0
     - New parameter *ssDir* and *ssPrefix*

.. seealso::
   :ref:`overview-files`,
   :ref:`DeleteFile`,
   :ref:`GetTempPath`

:sub:`id-1763451`