.. highlightlang:: us

.. _splitplaceholder:

SplitPlaceholder
================

.. index:: SplitPlaceholder

.. us.tag  SplitPlaceholder ENGLISH STR NEW560

:ref:`SplitPlaceholder` splits a placeholder text into tokens.

.. function::  smSplitPlaceholder = SplitPlaceholder(svPlaceholder)

.. us.return

**Return Value**

*smSplitPlaceholder* is a matrix with 8 columns:

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

   * - Value
     - Meaning
   * - smSplitPlaceholder[1]
     - Channel name or empty string if global attribute
   * - smSplitPlaceholder[2]
     - Attribute name.
   * - smSplitPlaceholder[3]
     - Channel point index.
   * - smSplitPlaceholder[4]
     - File Alias.
   * - smSplitPlaceholder[5]
     - Format string.
   * - smSplitPlaceholder[6]
     - \* or $.
   * - smSplitPlaceholder[7]
     - Unit text.
   * - smSplitPlaceholder[8]
     - sort index for place holder dialog or ! (hide in dialog).

.. us.params

**Parameters**

.. uparam:: svPlaceholder

   *svFileName* is a string vektor with one or more place holders.
   Examples:

.. highlight:: none

::

   $Origin$
   $NMOTW.units$
   $NMOTW.1$
   $NMOTW.-1$
   $NMOTW.1;%.3lf$
   $NMOTW[1/min].1;%.3lf$
   $File1:NMOTW.1;%.1lf$
   $File2:NMOTW[1/min].1;%.1lf$
   $(10)Engine$

.. us.example

**Example**

::

   * SplitPlaceholder("$File1:Nmot[1/s].units;%.1lf$")'
   Nmot
   units

   File1
   %.1lf
   $
   1/s

.. highlight:: us

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

:sub:`id-750593`