Method convertToTargetHandle

src/utilities/idf/WorkspaceObject.cpp:1117–1156

  }

  boost::optional<Handle> WorkspaceObject_Impl::convertToTargetHandle(const std::string& name, const std::set<std::string>& referenceLists,
                                                                      bool checkValidity) const {
    OS_ASSERT(!m_handle.isNull());

    if (name.empty()) {
      return Handle();
    }  // null pointer

    // name is already handle
    if (boost::regex_match(name, uuidInString())) {
      Handle handle = toUUID(name);
      boost::optional<WorkspaceObject> object = m_workspace->getObject(handle);
      if (object) {
        return handle;
      } else {
        // name is a UUID but no object with that handle exists in the workspace, continue checking if this is a name?
      }
    }

    WorkspaceObjectVector candidates = m_workspace->getObjectsByName(name);

    if (candidates.empty()) {
      return boost::none;
    }
    if (candidates.size() == 1) {
      return candidates[0].handle();
    }

    // multiple. choose first in appropriate reference list.
    for (const WorkspaceObject& candidate : candidates) {
      if (m_workspace->canBeTarget(candidate.handle(), referenceLists)) {
        return candidate.handle();
      }
    }
    // none found. connect to first candidate if no strictness.
    if ((!checkValidity) || (m_workspace->strictnessLevel() < StrictnessLevel::Draft)) {
      return candidates[0].handle();
    }
    return boost::none;
  }

  void WorkspaceObject_Impl::restoreOriginalNumFields(unsigned n) {
    bool popResult = true;