.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OESetCIPStereo

.. oe:function:: OESetCIPStereo

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

      .. oe:api::

         bool OESetCIPStereo(OEMolBase& mol, OEAtomBase* atom,
                             unsigned int cipstereo)

   .. oe:language:: python

      .. oe:api:: python

         OESetCIPStereo(mol: Union[OEGraphMol,OEMol,OEQMol], atom: OEAtomBase,
                        cipstereo: int) -> bool

   Sets the internal **OEChem TK** stereochemistry from the given CIP atom stereo descriptor.
   The descriptor must be either :oe:const:`OEChem::OECIPAtomStereo::R` or
   :oe:const:`OEChem::OECIPAtomStereo::S`.
   This function returns true if the stereochemistry was successfully set,
   and false otherwise: *i.e.* the descriptor was invalid or the specified atom
   was not a CIP atom stereo center.

   .. seealso::

      * :oe:func:`OEChem::OEPerceiveCIPStereo` to perceive CIP atom stereo descriptor.
      * :ref:`section_stereochemistry_CIP` section

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

      .. oe:api::

         bool OESetCIPStereo(OEMolBase& mol, OEBondBase* bond,
                             unsigned int cipstereo)

   .. oe:language:: python

      .. oe:api:: python

         OESetCIPStereo(mol: Union[OEGraphMol,OEMol,OEQMol], bond: OEBondBase,
                        cipstereo: int) -> bool

   Sets the internal **OEChem TK** stereochemistry from the given CIP atom stereo descriptor.
   The descriptor must be either :oe:const:`OEChem::OECIPBondStereo::E` or
   :oe:const:`OEChem::OECIPBondStereo::Z`.
   This function returns true if the stereochemistry was successfully set,
   and false otherwise: *i.e.* the descriptor was invalid or the specified bond
   was not a CIP bond stereo center.

   .. seealso::

      * :oe:func:`OEChem::OEPerceiveCIPStereo` to perceive CIP bond stereo descriptor.
      * :ref:`section_stereochemistry_CIP` section

