Method ReadFile

code/Common/Importer.cpp:587–785

------------------------------------------------------------------------------------------------ Reads the given file and returns its contents if successful.

// ------------------------------------------------------------------------------------------------
// Reads the given file and returns its contents if successful.
const aiScene* Importer::ReadFile( const char* _pFile, unsigned int pFlags) {
    ai_assert(nullptr != pimpl);

    ASSIMP_BEGIN_EXCEPTION_REGION();
    const std::string pFile(_pFile);

    // ----------------------------------------------------------------------
    // Put a large try block around everything to catch all std::exception's
    // that might be thrown by STL containers or by new().
    // ImportErrorException's are throw by ourselves and caught elsewhere.
    //-----------------------------------------------------------------------

    WriteLogOpening(pFile);

#ifdef ASSIMP_CATCH_GLOBAL_EXCEPTIONS
    try
#endif // ! ASSIMP_CATCH_GLOBAL_EXCEPTIONS
    {
        // Check whether this Importer instance has already loaded
        // a scene. In this case we need to delete the old one
        if (pimpl->mScene)  {

            ASSIMP_LOG_DEBUG("(Deleting previous scene)");
            FreeScene();
        }

        // First check if the file is accessible at all
        if( !pimpl->mIOHandler->Exists( pFile)) {

            pimpl->mErrorString = "Unable to open file \"" + pFile + "\".";
            ASSIMP_LOG_ERROR(pimpl->mErrorString);
            return nullptr;
        }

        std::unique_ptr<Profiler> profiler(GetPropertyInteger(AI_CONFIG_GLOB_MEASURE_TIME, 0) ? new Profiler() : nullptr);
        if (profiler) {
            profiler->BeginRegion("total");
        }

        // Find an worker class which can handle the file extension.
        // Multiple importers may be able to handle the same extension (.xml!); gather them all.
        SetPropertyInteger("importerIndex", -1);
        struct ImporterAndIndex {
            BaseImporter * importer;
            unsigned int   index;
        };
        std::vector<ImporterAndIndex> possibleImporters;
        for (unsigned int a = 0; a < pimpl->mImporter.size(); a++)  {

            // Every importer has a list of supported extensions.
            std::set<std::string> extensions;
            pimpl->mImporter[a]->GetExtensionList(extensions);

            if (BaseImporter::HasExtension(pFile, extensions)) {
                ImporterAndIndex candidate = { pimpl->mImporter[a], a };
                possibleImporters.push_back(candidate);
            }
        }