數據 marshal 操作支持?

這些例程允許 C 代碼處理與 marshal 模塊所用相同數據格式的序列化對象。 其中有些函數可用來(lái)將數據寫(xiě)入這種序列化格式，另一些函數則可用來(lái)讀取并恢復數據。 用于存儲 marshal 數據的文件必須以二進(jìn)制模式打開(kāi)。

數字值在存儲時(shí)會(huì )將最低位字節放在開(kāi)頭。

此模塊支持兩種數據格式版本：第 0 版為歷史版本，第 1 版本會(huì )在文件和 marshal 反序列化中共享固化的字符串。 第 2 版本會(huì )對浮點(diǎn)數使用二進(jìn)制格式。 Py_MARSHAL_VERSION 指明了當前文件的格式（當前取值為 2）。

void PyMarshal_WriteLongToFile(long value, FILE *file, int version)?

將一個(gè) long 整數 value 以 marshal 格式寫(xiě)入 file。 這將只寫(xiě)入 value 最低的 32 位；無(wú)論本機 long 類(lèi)型的長(cháng)度如何。 version 指明文件格式的版本。

void PyMarshal_WriteObjectToFile(PyObject *value, FILE *file, int version)?

將一個(gè) Python 對象 value 以 marshal 格式寫(xiě)入 file。 version 指明文件格式的版本。

PyObject *PyMarshal_WriteObjectToString(PyObject *value, int version)?

Return value: New reference.

返回一個(gè)包含 value 的 marshal 表示形式的字節串對象。 version 指明文件格式的版本。

以下函數允許讀取并恢復存儲為 marshal 格式的值。

long PyMarshal_ReadLongFromFile(FILE *file)?

從打開(kāi)用于讀取的 FILE* 的對應數據流返回一個(gè) C long。 使用只函數只能讀取 32 位的值，無(wú)論本機 long 類(lèi)型的長(cháng)度為何。

發(fā)生錯誤時(shí)，將設置適當的異常 (EOFError) 并返回 -1。

int PyMarshal_ReadShortFromFile(FILE *file)?

從打開(kāi)用于讀取的 FILE* 的對應數據流返回一個(gè) C short。 使用此函數只能讀取 16 位的值，無(wú)論本機 short 類(lèi)型的長(cháng)度為何。

發(fā)生錯誤時(shí)，將設置適當的異常 (EOFError) 并返回 -1。

PyObject *PyMarshal_ReadObjectFromFile(FILE *file)?

Return value: New reference.

從打開(kāi)用于讀取的 FILE* 的對應數據流返回一個(gè) Python 對象。

發(fā)生錯誤時(shí)，將設置適當的異常 (EOFError, ValueError 或 TypeError) 并返回 NULL。

PyObject *PyMarshal_ReadLastObjectFromFile(FILE *file)?

Return value: New reference.

從打開(kāi)用于讀取的 FILE* 的對應數據流返回一個(gè) Python 對象。 不同于 PyMarshal_ReadObjectFromFile()，此函數假定將不再從該文件讀取更多的對象，允許其將文件數據積極地載入內存，以便反序列化過(guò)程可以在內存中的數據上操作而不是每次從文件讀取一個(gè)字節。 只有當你確定不會(huì )再從文件讀取任何內容時(shí)方可使用此形式。

發(fā)生錯誤時(shí)，將設置適當的異常 (EOFError, ValueError 或 TypeError) 并返回 NULL。

PyObject *PyMarshal_ReadObjectFromString(const char *data, Py_ssize_t len)?

Return value: New reference.

從包含指向 data 的 len 個(gè)字節的字節緩沖區對應的數據流返回一個(gè) Python 對象。

發(fā)生錯誤時(shí)，將設置適當的異常 (EOFError, ValueError 或 TypeError) 并返回 NULL。