.. highlightlang:: us

.. index:: search_path

.. _search_path:

search_path
===========

.. us.tag  search_path ENGLISH FILE_MISC New5140

Fast search function to locate a file in a given list of directories.

.. function::  ssCompleteFileName = search_path(ssPath, ssFileName)

.. us.return

**Return Value**

*ssCompleteFileName* is the filename including the path or an empty string ("").

.. us.params

**Parameters**

.. uparam:: ssPath

   One or more directories separated by a semi colon ``;``.

.. uparam:: ssFileName

   Complete file name without a path, e. g. :file:`uniplot.exe`.

.. us.example

**Example**

::

   * search_path(getenv("path"), "latex.exe")
   C:\Program Files (x86)\MiKTeX 2.8\miktex\bin\latex.exe

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.14.0
     - New

.. seealso::
   :ref:`overview-files`,
   :ref:`GetDirectory`,
   :ref:`GetFileAttributes`,
   :ref:`getenv`,
   :ref:`putenv`

:sub:`id-1216897`