.. _functx_left-trim:

================
functx:left-trim
================ 

Trims leading whitespace

Description
~~~~~~~~~~~
The functx:left-trim function removes all whitespace at the beginning of a 
string. Whitespace is defined as it is in XML, namely as the characters space, 
tab, carriage return and line feed. If $arg is the empty sequence, it returns a 
zero-length string.

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

   * - **Parameters**
     - **Description**
   * - arg:string()
     - the string to trim

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

   * - **XPath**
     - **Results**
   * - functx:left-trim('   xyz')
     - xyz
   * - functx:left-trim('   xyz    x')
     - xyz    x
   * - functx:left-trim('xyz')
     - xyz

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_trim`.
* :ref:`functx_right-trim`.
* :ref:`normalize-space`.