.. oe:namespace:: OEChem



.. meta::
   :keywords: OEDefaultConfTest, DefaultConfTest


.. _OEChem_OEDefaultConfTest:

.. oe:class:: OEDefaultConfTest

   .. oe:api::


      class OEDefaultConfTest : public OEConfTestBase

   This class represents `OEDefaultConfTest`.

   This is the default implementation of
   :ref:`OEConfTestBase <OEChem_OEConfTestBase>`. It never combines connection tables
   into multi-conformer molecules. This function is set as the
   conformer test to use by all of the :ref:`oemolistream <OEChem_oemolistream>`
   constructors.

   The following methods are publicly inherited from :ref:`OEConfTestBase <OEChem_OEConfTestBase>`:

   =========================================================== =========================================================== ==========================================================
   :oe:meth:`CombineMols<OEChem::OEConfTestBase::CombineMols>` :oe:meth:`CompareMols<OEChem::OEConfTestBase::CompareMols>` :oe:meth:`CreateCopy<OEChem::OEConfTestBase::CreateCopy>` 
   =========================================================== =========================================================== ==========================================================


   .. oe:method:: CombineMols

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

         .. oe:api::

            bool CombineMols(OEMCMolBase& m1, OEMolBase& m2)

      .. oe:language:: python

         .. oe:api:: python

            CombineMols(m1: OEMol, m2: Union[OEGraphMol,OEMol,OEQMol]) -> bool

      Adds ``m2`` as a new conformer in ``m1`` and returns whether the
      combination was successful.

   .. oe:method:: CompareMols

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

         .. oe:api::

            bool CompareMols(OEMolBase& m1, OEMolBase& m2) const

      .. oe:language:: python

         .. oe:api:: python

            CompareMols(m1: Union[OEGraphMol,OEMol,OEQMol],
                        m2: Union[OEGraphMol,OEMol,OEQMol]) -> bool

      This method always returns ``false``.

   .. oe:method:: CreateCopy

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

         .. oe:api::

            OEConfTestBase* CreateCopy() const

      .. oe:language:: python

         .. oe:api:: python

            CreateCopy() -> OEConfTestBase

      Deep copy constructor that returns a copy of the object.
      The memory for the returned :ref:`OEDefaultConfTest <OEChem_OEDefaultConfTest>`
      object is dynamically allocated  and owned by the caller.

      .. oe:language:: c++ 

         The returned copy should be deallocated using C++
         delete operator in order to prevent a memory leak. 
 
   .. oe:method:: HasCompareMols

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

         .. oe:api::

            bool HasCompareMols() const

      .. oe:language:: python

         .. oe:api:: python

            HasCompareMols() -> bool

      Always returns ``false`` for this object to indicate that the
      implementation of the
      :oe:meth:`OEChem::OEConfTestBase::CompareMols` method is
      "trivial" and always returns ``false``, indicating molecule
      copying can be elided in :oe:func:`OEChem::OEReadMolecule`. 
