Yurttas/PL/SL/python/docs/core-python-programming/doc/20/api/moduleObjects.html

[[yurttas/PL/SL/python/docs/core-python-programming/doc/20/api/fileObjects.html|]]

[[yurttas/PL/SL/python/docs/core-python-programming/doc/20/api/otherObjects.html|]]

[[yurttas/PL/SL/python/docs/core-python-programming/doc/20/api/cObjects.html|]]

Python/C API Reference Manual

[[yurttas/PL/SL/python/docs/core-python-programming/doc/20/api/contents.html|]]

[[yurttas/PL/SL/python/docs/core-python-programming/doc/20/api/genindex.html|]]

Previous: 7.5.1 File Objects Up: 7.5 Other Objects Next: 7.5.3 CObjects

7.5.2 Module Objects

There are only a few functions special to module objects.

PyTypeObject PyModule_Type: This instance of PyTypeObject represents the Python module type. This is exposed to Python programs as types.ModuleType.

int PyModule_Check (PyObject *p): Returns true if its argument is a module object.

PyObject* PyModule_New (char *name): Return value: New reference.
Return a new module object with the __name__ attribute set to name. Only the module's __doc__ and __name__ attributes are filled in; the caller is responsible for providing a __file__ attribute.

PyObject* PyModule_GetDict (PyObject *module): Return value: Borrowed reference.
Return the dictionary object that implements module's namespace; this object is the same as the __dict__ attribute of the module object. This function never fails.

char* PyModule_GetName (PyObject *module): Return module's __name__ value. If the module does not provide one, or if it is not a string, SystemError is raised and NULL is returned.

char* PyModule_GetFilename (PyObject *module): Return the name of the file from which module was loaded using module's __file__ attribute. If this is not defined, or if it is not a string, raise SystemError and return NULL.

int PyModule_AddObject (PyObject *module, char *name, PyObject *value): Add an object to module as name. This is a convenience function which can be used from the module's initialization function. This steals a reference to value. Returns -1 on error, 0 on success. New in version 2.0.

int PyModule_AddIntConstant (PyObject *module, char *name, int value): Add an integer constant to module as name. This convenience function can be used from the module's initialization function. Returns -1 on error, 0 on success. New in version 2.0.

int PyModule_AddStringConstant (PyObject *module, char *name, char *value): Add a string constant to module as name. This convenience function can be used from the module's initialization function. The string value must be null-terminated. Returns -1 on error, 0 on success. New in version 2.0.