Method getSubObject

src/App/DocumentObjectPyImp.cpp:532–693

}

PyObject* DocumentObjectPy::getSubObject(PyObject* args, PyObject* keywds)
{
    enum class ReturnType
    {
        PyObject = 0,
        DocObject = 1,
        DocAndPyObject = 2,
        Placement = 3,
        Matrix = 4,
        LinkAndPlacement = 5,
        LinkAndMatrix = 6
    };

    PyObject* obj;
    short retType = 0;
    PyObject* pyMat = nullptr;
    PyObject* doTransform = Py_True;
    short depth = 0;

    static const std::array<const char*, 6> kwlist {"subname",
                                                    "retType",
                                                    "matrix",
                                                    "transform",
                                                    "depth",
                                                    nullptr};
    if (!Base::Wrapped_ParseTupleAndKeywords(args,
                                             keywds,
                                             "O|hO!O!h",
                                             kwlist,
                                             &obj,
                                             &retType,
                                             &Base::MatrixPy::Type,
                                             &pyMat,
                                             &PyBool_Type,
                                             &doTransform,
                                             &depth)) {
        return nullptr;
    }

    if (retType < 0 || static_cast<size_t>(retType) > kwlist.size()) {
        PyErr_SetString(PyExc_ValueError, "invalid retType, can only be integer 0~6");
        return nullptr;
    }

    ReturnType retEnum = ReturnType(retType);
    std::vector<std::string> subs;
    bool single = true;

    if (PyUnicode_Check(obj)) {
        subs.emplace_back(PyUnicode_AsUTF8(obj));
    }
    else if (PySequence_Check(obj)) {
        single = false;
        Py::Sequence shapeSeq(obj);
        for (Py::Sequence::iterator it = shapeSeq.begin(); it != shapeSeq.end(); ++it) {
            PyObject* item = (*it).ptr();
            if (PyUnicode_Check(item)) {
                subs.emplace_back(PyUnicode_AsUTF8(item));