字符串轉(zhuǎn)換與格式化?
用于數(shù)字轉(zhuǎn)換和格式化字符串輸出的函數(shù)
-
int
PyOS_snprintf(char?*str, size_t?size, const char?*format, ...)? 根據(jù)格式字符串 format 和額外參數(shù)，輸出不超過 size 字節(jié)到 str 。請參見Unix手冊頁 snprintf(2) 。
-
int
PyOS_vsnprintf(char?*str, size_t?size, const char?*format, va_list?va)? 根據(jù)格式字符串 format 和 變量參數(shù)列表 va ，不能輸出超過 size 字節(jié)到 str 。請參見Unix手冊頁 vsnprintf(2) 。
PyOS_snprintf() and PyOS_vsnprintf() wrap the Standard C library
functions snprintf() and vsnprintf(). Their purpose is to
guarantee consistent behavior in corner cases, which the Standard C functions do
not.
包裝器確保 str*[*size-1] 在返回時始終是 '\0' 。它們從不寫入超過 size 字節(jié)（包括結(jié)尾的 '\0' ）到字符串。兩函數(shù)都需要滿足 str != NULL , size > 0 和 format != NULL 。
如果平臺沒有 vsnprintf() 而且緩沖區(qū)大小需要避免截斷超出 size 512 字節(jié)以上，Python 會以一個 Py_FatalError() 來中止。
這些函數(shù)的返回值（ rv ）應(yīng)按照以下規(guī)則被解釋：
當
0 <= rv < size，輸出轉(zhuǎn)換成功而且 rv 個字符被寫入 str （不包含末尾 str*[*rv] 的'\0'字節(jié)）當
rv >= size，輸出轉(zhuǎn)換被截斷并且成功需要一個帶有rv + 1字節(jié)的緩沖區(qū)。在這種情況下， str*[*size-1] 的值是'\0'。當
rv < 0，會發(fā)生一些不好的事情。 在這種情況下， str*[*size-1] 的值也是'\0'， 但是 str 的其余部分未被定義。錯誤的確切原因取決于底層平臺。
以下函數(shù)提供與語言環(huán)境無關(guān)的字符串到數(shù)字轉(zhuǎn)換。
-
double
PyOS_string_to_double(const char?*s, char?**endptr, PyObject?*overflow_exception)? 將字符串
s轉(zhuǎn)換為double類型，失敗時引發(fā)Python異常。接受的字符串的集合對應(yīng)于被 Python 的float()構(gòu)造函數(shù)接受的字符串的集合，除了s必須沒有前導或尾隨空格。轉(zhuǎn)換必須獨立于當前的區(qū)域。如果
endptr是NULL，轉(zhuǎn)換整個字符串。引發(fā)ValueError并且 返回-1.0如果字符串不是浮點數(shù)的有效的表達方式。如果
endptr不是NULL，盡可能多的轉(zhuǎn)換字符串并將*endptr設(shè)置為指向第一個未轉(zhuǎn)換的字符。如果字符串的初始段不是浮點數(shù)的有效的表達方式，將* endptr設(shè)置為指向字符串的開頭，引發(fā) ValueError 異常，并且返回-1.0。如果
s表示一個太大而不能存儲在一個浮點數(shù)中的值（比方說，"1e500"在許多平臺上是一個字符串）然后如果overflow_exception是NULL返回Py_HUGE_VAL（用適當?shù)姆枺┎⑶也辉O(shè)置任何異常。 在其他方面，overflow_exception必須指向一個 Python 異常對象；引發(fā)異常并返回-1.0。在這兩種情況下，設(shè)置*endptr指向轉(zhuǎn)換值之后的第一個字符。如果在轉(zhuǎn)換期間發(fā)生任何其他錯誤（比如一個內(nèi)存不足的錯誤），設(shè)置適當?shù)?Python 異常并且返回
-1.0。3.1 新版功能.
-
char*
PyOS_double_to_string(double?val, char?format_code, int?precision, int?flags, int?*ptype)? 轉(zhuǎn)換
doubleval 為一個使用 format_code， precision 和 flags 的字符串格式碼 必須是以下其中之一,
'e','E','f','F','g','G'或者'r'。對于'r', 提供的 精度 必須是0。'r'格式碼指定了標準函數(shù)repr()格式。flags 可以為零或者其他值
Py_DTSF_SIGN,Py_DTSF_ADD_DOT_0或Py_DTSF_ALT或其組合：Py_DTSF_SIGN表示總是在返回的字符串前附加一個符號字符，即使 val 為非負數(shù)。Py_DTSF_ADD_DOT_0表示確保返回的字符串看起來不像是一個整數(shù)。Py_DTSF_ALT表示應(yīng)用 "替代的" 格式化規(guī)則。 相關(guān)細節(jié)請參閱PyOS_snprintf()'#'定義文檔。
如果 ptype 不為
NULL，則它指向的值將被設(shè)為Py_DTST_FINITE,Py_DTST_INFINITE或Py_DTST_NAN中的一個，分別表示 val 是一個有限數(shù)字、無限數(shù)字或非數(shù)字。返回值是一個指向包含轉(zhuǎn)換后字符串的 buffer 的指針，如果轉(zhuǎn)換失敗則為
NULL。 調(diào)用方要負責調(diào)用PyMem_Free()來釋放返回的字符串。3.1 新版功能.
-
int
PyOS_stricmp(const char?*s1, const char?*s2)? 字符串不區(qū)分大小寫。該函數(shù)幾乎與
strcmp()的工作方式相同，只是它忽略了大小寫。
-
int
PyOS_strnicmp(const char?*s1, const char?*s2, Py_ssize_t ?size)? 字符串不區(qū)分大小寫。該函數(shù)幾乎與
strncmp()的工作方式相同，只是它忽略了大小寫。