.. include:: ../../toolkit-substitutions

.. oe:namespace:: OEChem

.. oe:function:: OEGetHelmChainNames

   .. attention::

      |PRELIMINARY-API|

   .. oe:language:: c++ java csharp

      .. oe:api::

         std::vector<std::string> OEGetHelmChainNames(const std::string& helm)

   .. oe:language:: python

      .. oe:api:: python

         OEGetHelmChainNames(helm: str) -> OEStringVector


   Returns the chain names present in the given :term:`HELM` string.
   
   For example, in case of input  ``"PEPTIDE1{F.A}|CHEM1{[Fmoc]}$PEPTIDE1,CHEM1,1:R1-1:R1$$$"``
   it will return ``PEPTIDE1`` and ``CHEM1``.

   .. warning::

      The :oe:func:`OEChem::OEGetHelmChainNames` function does not perform full validation or parsing of the :term:`HELM` string. 
      It is intended for quickly extracting information from an already validated :term:`HELM`.

   .. seealso::

      * :oe:func:`OEChem::OEGetHelmMonomerCodes` function 
      * :oe:func:`OEChem::OEHelmToMol` function
