深入 Python :Dive Into Python 中文版

    print "\n".join(["%s %s" %
                      (method.ljust(spacing),
                       processFunc(str(getattr(object, method).__doc__)))
                     for method in methodList])

注意這是一條命令，被分隔成了多行，但是并沒有使用續行符 (\)。還記得我說過一些表達式可以分割成多行而不需要使用反斜線嗎？列表解析就是這些表達式之一，因為整個表達式包括在方括號里。

現在，讓我們從后向前分析。

for method in methodList

告訴我們這是一個列表解析。如你所知 methodList 是 object 中所有你關心的方法的一個列表。所以你正在使用 method 遍歷列表。

例 4.22. 動態得到 doc string

>>> import odbchelper
>>> object = odbchelper                   
>>> method = 'buildConnectionString'      
>>> getattr(object, method)               
<function buildConnectionString at 010D6D74>
>>> print getattr(object, method).__doc__ 
Build a connection string from a dictionary of parameters.

    Returns string.

	在 info 函數中，object 是要得到幫助的對象，作為一個參數傳入。
	在你遍歷 methodList 時，method 是當前方法的名稱。
	通過 getattr 函數，你可以得到 object 模塊中 method 函數的引用。
	現在，很容易就可以打印出方法的 doc string 。

接下來令人困惑的是 doc string 周圍 str 的使用。你可能記得，str 是一個內置函數，它可以強制將數據轉化為字符串。但是一個 doc string 應該總是一個字符串，為什么還要費事地使用 str 函數呢？答案就是：不是每個函數都有 doc string ，如果沒有，這個 __doc__ 屬性為 None。

例 4.23. 為什么對一個 doc string 使用 str ？

>>> >>> def foo(): print 2
>>> >>> foo()
2
>>> >>> foo.__doc__     
>>> foo.__doc__ == None 
True
>>> str(foo.__doc__)    
'None'

	你可以很容易的定義一個沒有 doc string 的函數，這種情況下它的 __doc__ 屬性為 None。令人迷惑的是，如果你直接演算 __doc__ 屬性的值，Python IDE 什么都不會打印。這是有意義的 (前提是你考慮了這個結果的來由)，但是卻沒有什么用。
	你可以直接通過 __doc__ 屬性和 None 的比較驗證 __doc__ 屬性的值。
	str 函數可以接收值為 null 的參數，然后返回它的字符串表示，'None'。

	在 SQL 中，你必須使用 IS NULL 代替 = NULL 進行 null 值比較。在 Python，你可以使用 == None 或者 is None 進行比較，但是 is None 更快。

現在你確保有了一個字符串，可以把這個字符串傳給 processFunc，這個函數已經定義是一個既可以壓縮空白也可以不壓縮空白的函數。現在你看出來為什么使用 str 將 None 轉化為一個字符串很重要了。processFunc 假設接收到一個字符串參數然后調用 split 方法，如果你傳入 None ，將導致程序崩潰，因為 None 沒有 split 方法。

再往回走一步，你再一次使用了字符串格式化來連接 processFunc 的返回值 和 method 的 ljust 方法的返回值。ljust 是一個你之前沒有見過的新字符串方法。

例 4.24. ljust 方法介紹

>>> s = 'buildConnectionString'
>>> s.ljust(30) 
'buildConnectionString         '
>>> s.ljust(20) 
'buildConnectionString'

	ljust 用空格填充字符串以符合指定的長度。info 函數使用它生成了兩列輸出并將所有在第二列的 doc string 縱向對齊。
	如果指定的長度小于字符串的長度，ljust 將簡單地返回未變化的字符串。它決不會截斷字符串。

幾乎已經完成了。有了 ljust 方法填充過的方法名稱和來自調用 processFunc 方法得到的 doc string (可能壓縮過)，你就可以將兩者連接起來并得到單個字符串。因為對 methodList 進行了映射，最終你將獲得一個字符串列表。利用 "\n" 的 join 函數，將這個列表連接為單個字符串，列表中每個元素獨占一行，接著打印出結果。

例 4.25. 打印列表

>>> li = ['a', 'b', 'c']
>>> print "\n".join(li) 
a
b
c

在你處理列表時，這確實是一個有用的調試技巧。在 Python 中，你會十分頻繁地操作列表。

上述就是最后一個令人困惑的地方了。但是現在你應該已經理解這段代碼了。

    print "\n".join(["%s %s" %
                      (method.ljust(spacing),
                       processFunc(str(getattr(object, method).__doc__)))
                     for method in methodList])