.. highlightlang:: us

.. _xysetdatasource:

XYSetDataSource
===============

.. index:: XYSetDataSource

.. us.tag  XYSetDataSource NOTREADYENGLISH xy.data

:ref:`XYSetDataSource` sets the data source string. The data source string is used
by the function :ref:`datadata-exchange-(page)` to exchange the data of
the given dataset.

.. function::  bool = XYSetDataSource(hData, ssDataSource)

.. us.return

**Return Value**

If the function succeeds, the return value *bool* is TRUE (1); otherwise
it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hData

   *hData* is the handle of a  2D dataset.

.. uparam:: ssDataSource

   *ssDataSource* is a string with the file name, optional import options and a
   list with the variable names. Example: ``c:/data/test.asc{2,BTS} (Speed, Tourque)``.
   The import options are enclosed in ``{}`` and the variabale names are enclosed
   in ``()``. For Excel Files the table name can follow the file name in
   ``[]`` brackets. Example: ``c:/data/test.asc [Tabelle1]{2,BTS} (N, Mom)``

.. seealso::
   :ref:`overview-xy-datasets`,
   :ref:`XYGetDataSource`

:sub:`id-1326983`