.. highlightlang:: us

.. _stringtofield:

StringToField
=============

.. index:: StringToField

.. us.tag  StringToField ENGLISH STR

:ref:`StringToField` works the same way as the :ref:`FileToField` function. The only
difference is that the first parameter of :ref:`StringToField` is a scalar string.

.. function::  rmMat = StringToField(ssString)
    rmMat = StringToField(ssString, ssFieldSep)
    rmMat = StringToField(ssString, ssFieldSep, ssDecimalSep)
    rmMat = StringToField(ssString, ssFieldSep, ssDecimalSep, ssRecordSep)
    rmMat = StringToField(ssString, ssFieldSep, ssDecimalSep, ssRecordSep, hStatusWnd)
    rmMat = StringToField(ssString, ssFieldSep, ssDecimalSep, ssRecordSep, hStatusWnd, bQuotedNumberConversion)
    <smMat, smType > = StringToField(ssString)
    <smMat, smType > = StringToField(ssString, ssFieldSep, ssDecimalSep, ssRecordSep, hStatusWnd)
    <smMat, smType > = StringToField(ssString, ssFieldSep, ssDecimalSep, ssRecordSep, hStatusWnd, bQuotedNumberConversion)
    <rmMat, smMat, smType > = StringToField(ssString, ssFieldSep, ssDecimalSep, ssRecordSep, hStatusWnd)
    <rmMat, smMat, smType > = StringToField(ssString, ssFieldSep, ssDecimalSep, ssRecordSep, hStatusWnd, bQuotedNumberConversion)

.. us.example

**Example**

::

   rmData = StringToField("1,2,3,4", ",");

.. seealso::
   :ref:`overview-strings`,
   :ref:`FileToField`,
   :ref:`ClipboardToField`

:sub:`id-2044531`