引入模組¶
-
PyObject *PyImport_ImportModule(const char *name)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
這是
PyImport_Import()的包裝器 (wrapper)，它使用 const char* 作為引數，而不是 PyObject*。
-
PyObject *PyImport_ImportModuleNoBlock(const char *name)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
這個函式是
PyImport_ImportModule()的已棄用別名。在 3.3 版的變更: 當引入鎖被其他執行緒持有時，這個函式過去會立即失敗。但在 Python 3.3 中，鎖機制轉換成針對每個模組的鎖 (per-module lock) 來達到大多數目的，所以這個函式的特殊行為就不再需要了。
自從版本 3.13 後不推薦使用，將會自版本 3.15 中移除。: 請改用
PyImport_ImportModule()。
-
PyObject *PyImport_ImportModuleEx(const char *name, PyObject *globals, PyObject *locals, PyObject *fromlist)¶
- 回傳值：新的參照。
引入一個模組。這最好透過參考 Python 內建函式
__import__()來說明。回傳值是對引入的模組或頂層套件的新參照，或者是
NULL，失敗時會設定例外。就像__import__()一樣，當要求一個套件的子模組時，回傳值通常是頂層套件，除非給定一個非空的 fromlist。失敗的引入會移除不完整的模組物件，就像
PyImport_ImportModule()一樣。
-
PyObject *PyImport_ImportModuleLevelObject(PyObject *name, PyObject *globals, PyObject *locals, PyObject *fromlist, int level)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分 自 3.7 版本開始.
引入一個模組。這最好透過參考內建的 Python 函式
__import__()來說明，因為標準的__import__()函式會直接呼叫這個函式。回傳值是對引入的模組或頂層套件的新參照，或者是
NULL，失敗時會設定例外。就像__import__()一樣，當要求一個套件的子模組時，回傳值通常是頂層套件，除非給定一個非空的 fromlist。在 3.3 版被加入.
-
PyObject *PyImport_ImportModuleLevel(const char *name, PyObject *globals, PyObject *locals, PyObject *fromlist, int level)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
類似於
PyImport_ImportModuleLevelObject()，但名稱是 UTF-8 編碼字串，而不是 Unicode 物件。在 3.3 版的變更: 不再接受負的 level 值。
-
PyObject *PyImport_Import(PyObject *name)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
這是一個較高階的介面，用來呼叫目前的「引入掛勾函式 (import hook function)」（明確的 level 為 0，表示絕對引入 (absolute import)）。它從目前全域變數的
__builtins__中呼叫__import__()函式。這表示引入是使用目前環境所安裝的引入掛勾來完成的。此函式總是使用絕對引入。
-
PyObject *PyImport_ReloadModule(PyObject *m)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
重新載入一個模組。回傳重新載入模組的新參照，或在失敗時回傳
NULL並設定例外（在這種情況下模組仍然存在）。
-
PyObject *PyImport_AddModuleRef(const char *name)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分 自 3.13 版本開始.
回傳與模組名稱對應的模組物件。
name 引數的形式可以是
package.module。首先檢查模組字典中是否有，如果沒有，則建立新的模組並插入模組字典中。成功時回傳模組的強參照。失敗時回傳
NULL並設定例外。模組名稱 name 是以 UTF-8 解碼。
這個函式不會載入或引入模組；如果模組尚未載入，你將會得到一個空的模組物件。使用
PyImport_ImportModule()或其變體來引入一個模組。如果尚未存在，則不會建立由 name 的點名稱 (dotted name) 所隱含的套件結構。在 3.13 版被加入.
-
PyObject *PyImport_AddModuleObject(PyObject *name)¶
- 回傳值：借用參照。 為 穩定 ABI 的一部分 自 3.7 版本開始.
類似於
PyImport_AddModuleRef()，但是會回傳一個借用參照且 name 為 Python 的str物件。在 3.3 版被加入.
-
PyObject *PyImport_AddModule(const char *name)¶
- 回傳值：借用參照。 為 穩定 ABI 的一部分.
類似於
PyImport_AddModuleRef()，但是會回傳一個借用參照。
-
PyObject *PyImport_ExecCodeModule(const char *name, PyObject *co)¶
- 回傳值：新的參照。 為 穩定 ABI 的一部分.
給定一個模組名稱（可能為