Python標準庫---五、內置函數（P-K-R）

上一篇文章： Python標準庫---四、內置函數（L-M-N-O）
下一篇文章： Python標準庫---六、內置函數（P-K-R-S-T-U）

內置函數：

50. pow(x, y[, z])

返回 x 的 y 次冪；若是 z 存在，則對 z 取餘（比直接 pow(x, y) % z 計算更高效）。兩個參數形式的 pow(x, y) 等價於冪運算符： x**y。

參數必須爲數值類型。 對於混用的操做數類型，則適用二元算術運算符的類型強制轉換規則。 對於 int 操做數，結果具備與操做數相同的類型（轉換後），除非第二個參數爲負值；在這種狀況下，全部參數將被轉換爲浮點數並輸出浮點數結果。 例如，102 返回 100，但 10-2 返回 0.01。 若是第二個參數爲負值，則第三個參數必須省略。 若是存在 z，則 x 和 y 必須爲整數類型，且 y 必須爲非負數。

51. print(*objects, sep=' ', end='n', file=sys.stdout, flush=False)

將 objects 打印到 file 指定的文本流，以 sep 分隔並在末尾加上 end。 sep, end, file 和 flush 若是存在，它們必須以關鍵字參數的形式給出。
全部非關鍵字參數都會被轉換爲字符串，就像是執行了 str() 同樣，並會被寫入到流，以 sep 且在末尾加上 end。 sep 和 end 都必須爲字符串；它們也能夠爲 None，這意味着使用默認值。 若是沒有給出 objects，則 print() 將只寫入 end。

file 參數必須是一個具備 write(string) 方法的對象；若是參數不存在或爲 None，則將使用 sys.stdout。 因爲要打印的參數會被轉換爲文本字符串，所以 print() 不能用於二進制模式的文件對象。 對於這些對象，應改用 file.write(...)。

輸出是否被緩存一般決定於 file，但若是 flush 關鍵字參數爲真值，流會被強制刷新。

在 3.3 版更改: 增長了 flush 關鍵字參數。

52. class property(fget=None, fset=None, fdel=None, doc=None)

返回 property 屬性。

fget 是獲取屬性值的函數。 fset 是用於設置屬性值的函數。 fdel 是用於刪除屬性值的函數。而且 doc 爲屬性對象建立文檔字符串。

一個典型的用法是定義一個託管屬性 x:

class C:
    def __init__(self):
        self._x = None

    def getx(self):
        return self._x

    def setx(self, value):
        self._x = value

    def delx(self):
        del self._x

    x = property(getx, setx, delx, "I'm the 'x' property.")

若是 c 是 C 的實例，c.x 將調用getter，c.x = value 將調用setter， del c.x 將調用deleter。

若是給出，doc 將成爲該 property 屬性的文檔字符串。 不然該 property 將拷貝 fget 的文檔字符串（若是存在）。 這令使用 property() 做爲 decorator 來建立只讀的特徵屬性能夠很容易地實現:

class Parrot:
    def __init__(self):
        self._voltage = 100000

    @property
    def voltage(self):
        """Get the current voltage."""
        return self._voltage

以上 @property 裝飾器會將 voltage() 方法轉化爲一個具備相同名稱的只讀屬性的 "getter"，並將 voltage 的文檔字符串設置爲 "Get the current voltage."

特徵屬性對象具備 getter, setter 以及 deleter 方法，它們可用做裝飾器來建立該特徵屬性的副本，並將相應的訪問函數設爲所裝飾的函數。 這最好是用一個例子來解釋:

class C:
    def __init__(self):
        self._x = None

    @property
    def x(self):
        """I'm the 'x' property."""
        return self._x

    @x.setter
    def x(self, value):
        self._x = value

    @x.deleter
    def x(self):
        del self._x

上述代碼與第一個例子徹底等價。 注意必定要給附加函數與原始的特徵屬性相同的名稱 (在本例中爲 x。)

返回的特徵屬性對象一樣具備與構造器參數相對應的屬性 fget, fset 和 fdel。

在 3.5 版更改: 特性屬性對象的文檔字符串如今是可寫的。

53. range(stop)

range(start, stop[, step])

雖然被稱爲函數，但 range 其實是一個不可變的序列類型，參見在 range 對象 與 序列類型 --- list, tuple, range 中的文檔說明。

54. repr(object)

返回包含一個對象的可打印表示形式的字符串。 對於許多類型來講，該函數會嘗試返回的字符串將會與該對象被傳遞給 eval() 時所生成的對象具備相同的值，在其餘狀況下表示形式會是一個括在尖括號中的字符串，其中包含對象類型的名稱與一般包括對象名稱和地址的附加信息。 類能夠經過定義 __repr__() 方法來控制此函數爲它的實例所返回的內容。

55. reversed(seq)

返回一個反向的 iterator。 seq 必須是一個具備 __reversed__() 方法的對象或者是支持該序列協議（具備從 0 開始的整數類型參數的 __len__() 方法和 __getitem__() 方法）。

56. round(number[, ndigits])

返回 number 舍入到小數點後 ndigits 位精度的值。 若是 ndigits 被省略或爲 None，則返回最接近輸入值的整數。

對於支持 round() 的內置類型，值會被舍入到最接近的 10 的負 ndigits 次冪的倍數；若是與兩個倍數的距離相等，則選擇偶數 (所以，round(0.5) 和 round(-0.5) 均爲 0 而 round(1.5) 爲 2)。 任何整數值均可做爲有效的 ndigits (正數、零或負數)。 若是 ndigits 被省略或爲 None 則返回值將爲整數。 不然返回值與 number 的類型相同。

對於通常的 Python 對象 number, round 將委託給 number.__round__。

註解 對浮點數執行 round() 的行爲可能會使人驚訝：例如，round(2.675, 2) 將給出 2.67 而不是指望的 2.68。 這不算是程序錯誤：這一結果是因爲大多數十進制小數實際上都不能以浮點數精確地表示。 請參閱 浮點算術：爭議和限制 瞭解更多信息。

上一篇文章： Python標準庫---四、內置函數（L-M-N-O）
下一篇文章： Python標準庫---六、內置函數（P-K-R-S-T-U）