python-List(列表)類官方文檔翻譯

此文是本人對help(list)官方文檔的翻譯,可能不是很準確,有誤之處可留言

'''
class list(object)
 |  list(iterable=(), /)
 |  從一個可迭代對象生成列表
 |
 |  Built-in mutable sequence.
 |  列表是一種內置可變序列
 |
 |  If no argument is given, the constructor creates a new empty list.
 |  The argument must be an iterable if specified.
 |  無參時返回新的空列表,參數必須是規定的可迭代對象
 |  
 |  Methods defined here:
 |  對象方法:
 |  所有下劃線開頭基本都是運算符重載,一般不會主動調用,顧不做翻譯
 |  __add__(self, value, /)
 |      Return self+value.
 |  
 |  __contains__(self, key, /)
 |      Return key in self.
 |  
 |  __delitem__(self, key, /)
 |      Delete self[key].
 |  
 |  __eq__(self, value, /)
 |      Return self==value.
 |  
 |  __ge__(self, value, /)
 |      Return self>=value.
 |  
 |  __getattribute__(self, name, /)
 |      Return getattr(self, name).
 |  
 |  __getitem__(...)
 |      x.__getitem__(y) <==> x[y]
 |  
 |  __gt__(self, value, /)
 |      Return self>value.
 |  
 |  __iadd__(self, value, /)
 |      Implement self+=value.
 |  
 |  __imul__(self, value, /)
 |      Implement self*=value.
 |  
 |  __init__(self, /, *args, **kwargs)
 |      Initialize self.  See help(type(self)) for accurate signature.
 |  
 |  __iter__(self, /)
 |      Implement iter(self).
 |  
 |  __le__(self, value, /)
 |      Return self<=value.
 |  
 |  __len__(self, /)
 |      Return len(self).
 |  
 |  __lt__(self, value, /)
 |      Return self<value.
 |  
 |  __mul__(self, value, /)
 |      Return self*value.
 |  
 |  __ne__(self, value, /)
 |      Return self!=value.
 |  
 |  __repr__(self, /)
 |      Return repr(self).
 |  
 |  __reversed__(self, /)
 |      Return a reverse iterator over the list.
 |  
 |  __rmul__(self, value, /)
 |      Return value*self.
 |  
 |  __setitem__(self, key, value, /)
 |      Set self[key] to value.
 |  
 |  __sizeof__(self, /)
 |      Return the size of the list in memory, in bytes.
 |  
 |  append(self, object, /)
 |      Append object to the end of the list.
 |      將object追加至列表末尾
 |  
 |  clear(self, /)
 |      Remove all items from list.
 |      刪除列表中的所有元素
 |  
 |  copy(self, /)
 |      Return a shallow copy of the list.
 |      返回列表的淺拷貝
 |  
 |  count(self, value, /)
 |      Return number of occurrences of value.
 |      返回元素value出現的次數
 |  
 |  extend(self, iterable, /)
 |      Extend list by appending elements from the iterable.
 |      將可迭代對象iterable合併到列表末尾
 |  
 |  index(self, value, start=0, stop=9223372036854775807, /)
 |      Return first index of value.
 |      返回value第一次出現的位置索引,start設定查找起點,stop設定查找終點
 |      
 |      Raises ValueError if the value is not present.
 |      如果value不存在,則拋ValueError異常
 |  
 |  insert(self, index, object, /)
 |      Insert object before index.
 |      在index位置的前面插入對象object
 |  
 |  pop(self, index=-1, /)
 |      Remove and return item at index (default last).
 |      刪除並返回index處的元素,默認index爲-1.
 |      
 |      Raises IndexError if list is empty or index is out of range.
 |      列表爲空或index越界時拋IndexError異常
 |  
 |  remove(self, value, /)
 |      Remove first occurrence of value.
 |      刪除列表中第一個出現的value元素
 |      
 |      Raises ValueError if the value is not present.
 |      元素不存在時拋ValueError異常
 |  
 |  reverse(self, /)
 |      Reverse *IN PLACE*.
 |      列表前後翻轉
 |  
 |  sort(self, /, *, key=None, reverse=False)
 |      Sort the list in ascending order and return None.
 |      按升序對列表排序,返回None
 |      
 |      The sort is in-place (i.e. the list itself is modified) and stable (i.e. the
 |      order of two equal elements is maintained).
 |      排序是原地(不產生新的列表對象)進行且穩定(值相等的元素之間的次序不會改變)的.
 |
 |      If a key function is given, apply it once to each list item and sort them,
 |      ascending or descending, according to their function values.
 |      key設置爲指向一個函數時,將以函數返回值作爲排序的依據,但排序的是元素本身,不是函數的返回值列表。
 |      
 |      The reverse flag can be set to sort in descending order.
 |      reverse標記可以進行逆序排序,默認爲False,即正序。
 |  
 |  ----------------------------------------------------------------------
 |  Static methods defined here:
 |  靜態方法:
 |  
 |  __new__(*args, **kwargs) from builtins.type
 |      Create and return a new object.  See help(type) for accurate signature.
 |      創建並返回一個新對象,通過help(type)能獲取詳細信息
 |
 |  
 |  ----------------------------------------------------------------------
 |  Data and other attributes defined here:
 |  
 |  __hash__ = None
 '''
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章