Method getDocument

src/App/ObjectIdentifier.cpp:976–1026

}

Document* ObjectIdentifier::getDocument(String name, bool* ambiguous) const
{
    if (name.getString().empty()) {
        name = getDocumentName();
    }

    App::Document* docById = nullptr;

    if (!name.isRealString()) {
        docById = App::GetApplication().getDocument(name.toString().c_str());
        if (name.isForceIdentifier()) {
            return docById;
        }
    }

    App::Document* docByLabel = nullptr;
    const std::vector<App::Document*> docs = App::GetApplication().getDocuments();

    for (auto doc : docs) {
        if (doc->Label.getValue() == name.getString()) {
            /* Multiple hits for same label? */
            if (docByLabel) {
                if (ambiguous) {
                    *ambiguous = true;
                }
                return nullptr;
            }
            docByLabel = doc;
        }
    }

    /* Not found on id? */
    if (!docById) {
        return docByLabel;  // Either not found at all, or on label
    }
    else {
        /* Not found on label? */
        if (!docByLabel) { /* Then return doc by id */
            return docById;
        }

        /* docByLabel and docById could be equal; that is ok */
        if (docByLabel == docById) {
            return docById;
        }
        if (ambiguous) {
            *ambiguous = true;
        }
        return nullptr;
    }
}

DocumentObject* ObjectIdentifier::getDocumentObject() const
{