.. _functx_index-of-string:

======================
functx:index-of-string
====================== 

The position(s) of a substring

Description
~~~~~~~~~~~
The functx:index-of-string function returns one or more integers representing 
the position of a $substring within $arg. Overlapping substrings are not 
counted. If $arg does not contain $substring, the empty sequence is returned.

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - **Parameters**
     - **Description**
   * - arg:string()
     - the string
   * - substring:string()
     - the substring to find

Examples
~~~~~~~~
.. list-table::
   :widths: 50 50
   :header-rows: 1

   * - **XPath**
     - **Results**
   * - functx:index-of-string('abcdabcdabcd','abc')
     - (1, 5, 9)
   * - functx:index-of-string('abcd','abc')
     - 1
   * - functx:index-of-string('xxx','abc')
     - ()

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_index-of-string-first`.
* :ref:`functx_index-of-string-last`.