.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OEReadMolecule

.. oe:function:: OEReadMolecule

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

      .. oe:api::

         bool OEReadMolecule(oemolistream& ifs, OEMol& mol)
         bool OEReadMolecule(oemolistream& ifs, OEQMol& mol)
         bool OEReadMolecule(oemolistream& ifs, OEMolBase& mol)
         bool OEReadMolecule(oemolithread& ifs, OEMolBase& mol)
         bool OEReadMolecule(oemolistream& ifs, OEGraphMol& mol)
         bool OEReadMolecule(oemolithread& ifs, OEQMolBase& mol)
         bool OEReadMolecule(oemolistream& ifs, OEQMolBase& mol)
         bool OEReadMolecule(oemolistream& ifs, OEMCMolBase& mol)
         bool OEReadMolecule(oemolithread& ifs, OEMCMolBase& mol)

   .. oe:language:: python

      .. oe:api:: python

         OEReadMolecule(ifs: oemolistream, mol: OEMol) -> bool
         OEReadMolecule(ifs: oemolistream, mol: OEQMol) -> bool
         OEReadMolecule(ifs: oemolistream, mol: OEGraphMol) -> bool
         OEReadMolecule(ifs: oemolithread, mol: OEGraphMol) -> bool
         OEReadMolecule(ifs: oemolithread, mol: OEQMol) -> bool
         OEReadMolecule(ifs: oemolithread, mol: OEMol) -> bool


   Reads the contents of the input molstream into the specified molecule
   using the file format currently associated with the
   :ref:`oemolistream <OEChem_oemolistream>`.  The assumed file format may be
   specified using the :oe:meth:`OEChem::oemolistream::SetFormat` method.

.. seealso::

  .. oe:language:: c++

      * Example program :ref:`convert.cpp<section_example_oechem_convert>`

  .. oe:language:: python

      * Example program :ref:`convert.py<section_example_oechem_convert>`

  .. oe:language:: java

      * Example program :ref:`Convert.java<section_example_oechem_convert>`

  .. oe:language:: csharp

      * Example program :ref:`Convert.cs<section_example_oechem_convert>`

