.. highlightlang:: us

.. _splitpath:

SplitPath
=========

.. index:: SplitPath

.. us.tag  SplitPath ENGLISH STR

:ref:`SplitPath` breaks a full path into
its four components: drive name, diretory name, file name and
extension.

.. function::  smSplitPath = SplitPath(svFileName)

.. us.return

**Return Value**

*smSplitPath* is a string vector with four elements if *svFileName*
contains one file and a matrix with four columns if *svFileName* contains
more than one filename:

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

   * - Value
     - Meaning
   * - svSplitPath[1]
     - is the drive letter followed by a colon.
   * - svSplitPath[2]
     - is the path of subdirectories, including the trailing slash.
   * - svSplitPath[3]
     - is the file name.
   * - svSplitPath[4]
     - is the extension including the leading period (.).

.. us.params

**Parameters**

.. uparam:: svFileName

   *svFileName* is a complete file name.

.. us.example

**Example**

::

   * SplitPath("d:/test/test.xls")'
   d:
   /test/
   test
   .xls

.. seealso::
   :ref:`overview-files`,
   :ref:`MakeFullPath`,
   :ref:`GetFileAttributes`,
   :ref:`ComparePath`,
   :ref:`MakePath`

:sub:`id-155270`