.. include:: ../substitutions

.. oe:namespace:: OEChem

.. meta::
   :keywords: OEReadOEBFile

.. oe:function:: OEReadOEBFile

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

      .. oe:api::

         unsigned int OEReadOEBFile(OEPlatform::oeistream& is, OEMolBase& mol,
                                    const OESystem::OEBinaryIOHandlerBase& handler)
         unsigned int OEReadOEBFile(OEPlatform::oeistream& is,
                                    OEMCMolBase& mol,
                                    const OESystem::OEBinaryIOHandlerBase& handler)

   .. oe:language:: python

      .. oe:api:: python

         OEReadOEBFile(ifs: oeistream, mol: Union[OEGraphMol,OEQMol],
                       handler: OEBinaryIOHandlerBase) -> int
         OEReadOEBFile(ifs: oeistream, mol: OEMol,
                       handler: OEBinaryIOHandlerBase) -> int

   Reads a molecule from the specified input stream in the
   OpenEye Binary Version 2 format. This is considered a low-level
   API for advanced users that will only parse the part of the OEB
   specified by the handlers registered with
   `handler`. :oe:func:`OEChem::OEReadMolecule` is the preferred way to
   read molecules from OEB files, as it will handle many corner cases
   more cleanly. This function only performs the parsing of the
   actual OEB data based upon the given 'handler'.


