您好,首先您描述有誤,應該是__doc__,雙下劃線。
創(chuàng)新互聯(lián)是一家專業(yè)提供九江企業(yè)網站建設,專注與做網站、網站制作、HTML5建站、小程序制作等業(yè)務。10年已為九江眾多企業(yè)、政府機構等服務。創(chuàng)新互聯(lián)專業(yè)網絡公司優(yōu)惠進行中。
每個對象都會有一個__doc__屬性,用于描述該對象的作用。在一個模塊被import時,其文件中的某些特殊的字符串會被python解釋器保存在相應對象的__doc__屬性中。比如,一個模塊有模塊的__doc__,一個class或function也有其對應的__doc__屬性。在python中,一個模塊其實就是一個.py文件。在文件中特殊的地方書寫的字符串就是所謂的docstrings,就是將被放到__doc__的內容。這個“特殊的地方”包括:
1.?一個文件任何一條可執(zhí)行的代碼之前? #模塊的__doc__
2.?一個類,在類定義語句后,任何可執(zhí)行代碼前#類的__doc__
3.?一個函數,在函數定義語句后,任何可執(zhí)行代碼前#函數的__doc__
舉個例子:
#use??__doc__?屬性
class?MyClass:
'string.'
def?printSay():
'print?say?welcome?to?you.'
print?'say?welcome?to?you.'
print?MyClass.__doc__
print?MyClass.printSay.__doc__
#輸出結果
string.
print?say?welcome?to?you.
文檔字符串。注意,是 __doc__ ,前后各兩個下劃線。
一般而言,是對函數/方法/模塊所實現功能的簡單描述。但當指向具體對象時,會顯示此對象從屬的類型的構造函數的文檔字符串。(示例見以下 a.__doc__)
str.__doc__
"str(string[, encoding[, errors]]) - str\n\nCreate a new string object from the given encoded string.\nencoding defaults to the current default string encoding.\nerrors can be 'strict', 'replace' or 'ignore' and defaults to 'strict'."
import math
math.__doc__
'This module is always available. It provides access to the\nmathematical functions defined by the C standard.'
a = [1]
a.count.__doc__
'L.count(value) - integer -- return number of occurrences of value'
a.__doc__
"list() - new empty list\nlist(iterable) - new list initialized from iterable's items"
為自定義的函數創(chuàng)建 __doc__ 的方法示例:
def func():
"""Here's a doc string"""
pass
func.__doc__
"Here's a doc string"
更詳細的資料請參考 Python Tutorial 4.7.6 Documentation Strings.
隨著使用python的時間越來越長,安裝的python模塊也越來越多,有的模塊不常用,也漸漸會忘了里面有哪些函數;或者,一個新的python模塊,沒有官方文檔,要想知道調用哪些函數,怎么調用那些函數,于是乎就需要查看一下自己安裝的python模塊里有哪些函數,現將查看方法總結如下
在命令行下運行如下命令即可查看
在交互式解釋器中輸入如下命令即可,效果跟在命令行下輸入 $ pydoc modules 是一樣的。
python的sys模塊也是可以用來查看模塊信息的
如果你使用的是 pip 來作為你的 python 包管理器的話,可以在命令行下直接運行 $ pip freeze/code 或者 code$ pip list 來查看安裝包的信息,當然其它的包管理器也有類似的功能,同時,你也可以在python交互式解釋器中導入pip模塊來查看包信息。
如果你安裝過 yolk 的話可以使用 yolk 命令來查看包信息,你可以使用 $ pip install yolk 來安裝它 yolk 使用簡單,只需在命令行下操作即可。
python的常用內置函數
1.abs() 函數返回數字的絕對值
abs(-40)=40
2. dict() 函數用于創(chuàng)建一個字典
dict()
{} ? ? ?#創(chuàng)建一個空字典類似于u={},字典的存取方式一般為key-value
例如u = {"username":"tom", ?"age":18}
3. help() 函數用于查看函數或模塊用途的詳細說明
help('math')查看math模塊的用處
a=[1,2,3,4]
help(a)查看列表list幫助信息
4.dir()獲得當前模塊的屬性列表
dir(help)
['__call__', '__class__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__gt__', '__hash__', '__init__', '__le__', '__lt__', '__module__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__']
5.min() 方法返回給定參數的最小值 /參數可以為序列
a=? min(10,20,30,40)
a
10
6. next() 返回迭代器的下一個項目
it = iter([1, 2, 3, 4, 5])
next(it)
1
next(it)
2
7. id() 函數用于獲取對象的內存地址
a=12
id(a)
1550569552
8.enumerate() 函數用于將一個可遍歷的數據對象(如列表、元組或字符串)組合為一個索引序列,同時列出數據和數據下標,一般用在 for 循環(huán)當中。
a=["tom","marry","leblan"]
list(enumerate(a))
[(0, 'tom'), (1, 'marry'), (2, 'leblan')]
9. oct() 函數將一個整數轉換成8進制字符串
oct(15)
'0o17'
oct(10)
'0o12'
10. bin() 返回一個整數 int 或者長整數 long int 的二進制表示
bin(10)
'0b1010'
bin(15)
'0b1111'
11.eval() 函數用來執(zhí)行一個字符串表達式,并返回表達式的值
eval('2+2')
4
12.int() 函數用于將一個字符串會數字轉換為整型
int(3)
3
int(3.6)
3
int(3.9)
3
int(4.0)
4
13.open() 函數用于打開一個文件,創(chuàng)建一個file對象,相關的方法才可以調用它進行讀寫
f=open('test.txt')
14.str() 函數將對象轉化為適于人閱讀的形式
str(3)
'3'
15. bool() 函數用于將給定參數轉換為布爾類型,如果沒有參數,返回 False
bool()
False
bool(1)
True
bool(10)
True
bool(10.0)
True
16.isinstance() 函數來判斷一個對象是否是一個已知的類型
a=5
isinstance(a,int)
True
isinstance(a,str)
False
17. sum() 方法對系列進行求和計算
sum([1,2,3],5)
11
sum([1,2,3])
6
18. super() 函數用于調用下一個父類(超類)并返回該父類實例的方法。super 是用來解決多重繼承問題的,直接用類名調用父類方法
class ? User(object):
? def__init__(self):
class Persons(User):
? ? ? ? super(Persons,self).__init__()
19. float() 函數用于將整數和字符串轉換成浮點數
float(1)
1.0
float(10)
10.0
20. iter() 函數用來生成迭代器
a=[1,2,3,4,5,6]
iter(a)
for i in iter(a):
... ? ? ? ? print(i)
...
1
2
3
4
5
6
21.tuple 函數將列表轉換為元組
a=[1,2,3,4,5,6]
tuple(a)
(1, 2, 3, 4, 5, 6)
22.len() 方法返回對象(字符、列表、元組等)長度或項目個數
s = "playbasketball"
len(s)
14
a=[1,2,3,4,5,6]
len(a)
6
23. property() 函數的作用是在新式類中返回屬性值
class User(object):
?def __init__(self,name):
? ? ? ? ? self.name = name
def get_name(self):
? ? ? ? ? return self.get_name
@property
?def name(self):
? ? ? ? ?return self_name
24.type() 函數返回對象的類型
25.list() 方法用于將元組轉換為列表
b=(1,2,3,4,5,6)
list(b)
[1, 2, 3, 4, 5, 6]
26.range() 函數可創(chuàng)建一個整數列表,一般用在 for 循環(huán)中
range(10)
range(0, 10)
range(10,20)
range(10, 20)
27. getattr() 函數用于返回一個對象屬性值
class w(object):
... ? ? ? ? ? ? s=5
...
a = w()
getattr(a,'s')
5
28. complex() 函數用于創(chuàng)建一個復數或者轉化一個字符串或數為復數。如果第一個參數為字符串,則不需要指定第二個參數
complex(1,2)
(1+2j)
complex(1)
(1+0j)
complex("1")
(1+0j)
29.max() 方法返回給定參數的最大值,參數可以為序列
b=(1,2,3,4,5,6)
max(b)
6
30. round() 方法返回浮點數x的四舍五入值
round(10.56)
11
round(10.45)
10
round(10.45,1)
10.4
round(10.56,1)
10.6
round(10.565,2)
10.56
31. delattr 函數用于刪除屬性
class Num(object):
...? ? a=1
...? ? b=2
...? ? c=3.
.. print1 = Num()
print('a=',print1.a)
a= 1
print('b=',print1.b)
b= 2
print('c=',print1.c)
c= 3
delattr(Num,'b')
print('b=',print1.b)
Traceback (most recent call last):? File "", line 1, inAttributeError: 'Num' object has no attribute 'b'
32. hash() 用于獲取取一個對象(字符串或者數值等)的哈希值
hash(2)
2
hash("tom")
-1675102375494872622
33. set() 函數創(chuàng)建一個無序不重復元素集,可進行關系測試,刪除重復數據,還可以計算交集、差集、并集等。
a= set("tom")
b = set("marrt")
a,b
({'t', 'm', 'o'}, {'m', 't', 'a', 'r'})
ab#交集
{'t', 'm'}
a|b#并集
{'t', 'm', 'r', 'o', 'a'}
a-b#差集
{'o'}