Chapter 4 ¶_download; &apihelper_funcdef; &apihelper_docstring; &apihelper_docstring2; &apihelper_docstring3; &apihelper_methods; &apihelper_lambda; &apihelper_main; &apihelper_ifname; &apihelper_printdoc; 该模块有一个声明为 &info; 的函数。根据它的函数声明可知，它有三个参数： object、spacing和collapse。实际上后面两个参数都是可选参数，关于这点你很快就会看到。 &info;函数有一个多行的&docstring;，简要地描述了函数的功能。注意这里并没有提到返回值；单独使用这个函数只是为了这个函数产生的效果，并不是为了它的返回值。 函数内的代码是缩进形式的。 &if; &name; 技巧允许这个程序在自己独立运行时做些有用的事情，同时又不妨碍作为其它程序的模块使用。 在这个例子中，程序只是简单地打印出&info; 函数的 &docstring;。 &if;语句 使用 &comparisonequals; 进行比较, 而且不需要括号。 &info; 函数的设计意图是提供给工作在&python; &ide; 中的开发人员使用，它可以使用任何含有函数或者方法的对象（比如模块，含有函数，又比如list，含有方法）作为参数，并打印出对象的所有函数和它们的 &docstring;。 &apihelper_output; 缺省地，程序输出进行了格式化处理易于阅读。多行 &docstring; 被合并到单行中，要改变这个选项需要指定collapse参数的值为0。如果函数名称长于10个字符，你可以将spacing参数的值指定为更大的值以使输出更容易阅读。 &prompt;import &odbchelper_name; &prompt;info(&odbchelper_name;) &odbchelper_funcname; Build a connection string from a dictionary Returns string. &prompt;info(&odbchelper_name;, 30) &odbchelper_funcname; Build a connection string from a dictionary Returns string. &prompt;info(&odbchelper_name;, 30, 0) &odbchelper_funcname; Build a connection string from a dictionary Returns string.

--> &info; 函数就是这样一个例子，它有两个可选参数。 &apihelper_funcdef; spacing 和 collapse 是可选参数，因为它们已经定义了缺省值。object 是必备参数，因为它没有指定缺省值。如果调用&info; 时只指定一个参数，那么spacing 缺省为 10 ，collapse 缺省为 &one;。如果调用 &info; 时指定两个参数，collapse 依然默认为 &one;。 假如你要指定collapse的值，但是又想要接受 spacing的缺省值。在绝大部分语言中，你可能运气就不太好了，因为你需要使用三个参数来调用函数，这势必要重新指定spacing的值。但是在 &python; 中，参数可以通过名称以任意顺序指定。 info(&odbchelper_name;) info(&odbchelper_name;, 12) info(&odbchelper_name;, collapse=0) info(spacing=15, object=&odbchelper_name;) 只使用一个参数，spacing 使用缺省值 10 ，collapse 使用缺省值 &one;。 使用两个参数， collapse 使用缺省值 &one;。 这里你显式命名了collapse并指定了它的值。spacing 将依然使用它的缺省值 10。 甚至必备参数 (例如 object，没有指定缺省值) 也可以采用命名参数的方式, 而且命名参数可以以任意顺序出现。 这些看上去非常累，除非你意识到参数不过是一个字典。通常 不使用参数名称的函数调用只是一个简写的形式，&python; 按照函数声明中定义的的参数顺序将参数值和参数名称匹配起来。大部分时间，你会使用通常方式调用函数，但是如果你需要总是可以提供附加的灵活性。 调用函数时唯一需要做的事情就是为每一个必备参数指定值（以某种方式）；以何种具体的方式和顺序都取决于你。 &pythontutorial; 确切地讨论了 何时、如何进行缺省参数赋值，这都和缺省值是一个list还是一个具有副作用的表达式有关。

&type; 函数返回任意对象的数据型别。在types模块中列出了可能的型别。这对于帮助者函数处理不同种型别的数据非常有用。 &prompt;type(1) <type 'int'> &prompt;li = [] &prompt;type(li) <type 'list'> &prompt;import odbchelper &prompt;type(odbchelper) <type 'module'> &prompt;import types &prompt;type(odbchelper) == types.ModuleType True &type; 可以接收任何东西作为参数 -- 我的意思是任何东西 -- 并返回它的数据型别。整型、字符串、列表、字典、元组、函数、类、模块、甚至类型对象都可以作为参数被type函数接受。 &type; 可以接收变量作为参数，并返回它的数据型别。 &type; 还可以作用于模块。 你可以使用types模块中的常量来进行对象型别的比较。这就是&info; 函数所做的，很快你就会看到。

&str; 将数据强制转型为字符串。每种数据型别都可以强制转型为字符串。 &prompt;str(1) '1' &prompt;horsemen = ['war', 'pestilence', 'famine'] &prompt;horsemen ['war', 'pestilence', 'famine'] &prompt;horsemen.append('&powerbuilder;') &prompt;str(horsemen) "['war', 'pestilence', 'famine', '&powerbuilder;']" &prompt;str(odbchelper) "<module 'odbchelper' from 'c:\\docbook\\dip\\py\\odbchelper.py'>" &prompt;str(None) 'None' 对于简单的数据型别比如整型，你可以预料到 &str; 的正常工作，因为几乎每种语言都有一个将整型转化为字符串的函数。 然而 &str; 可以作用于任何型别的任何对象。这里它作用于一个零碎构建的列表。 &str; 还允许作用于模块。注意模块的字符串形式表示包含了模块在磁盘上的路径名，所以你的显示结果将会有所不同。 &str; 的一个细小但重要的行为是它可以作用于&none;，&none; 是&python;的null值。这个调用返回字符串'None'。你将会使用这一点来提高你的 &info; 函数，这一点你很快就会看到。 &info; 函数的核心是强大的 &dir; 函数。&dir;函数返回任意对象的属性和方法列表，包括模块对象、函数对象、字符串对象、列表对象、字典对象...相当多的东西。 &prompt;li = [] &prompt;dir(li) ['append', 'count', 'extend', 'index', 'insert', 'pop', 'remove', 'reverse', 'sort'] &prompt;d = {} &prompt;dir(d) ['clear', 'copy', 'get', 'has_key', 'items', 'keys', 'setdefault', 'update', 'values'] &prompt;import &odbchelper_name; &prompt;dir(&odbchelper_name;) ['__builtins__', '__doc__', '__file__', '__name__', '&odbchelper_funcname;'] li 是一个列表，所以&dir;(li) 返回所有列表方法的一个列表。注意返回的列表只包含了字符串形式的方法名称，而不是方法对象本身。 d 是一个字典，所以&dir;(d) 返回字典方法的名称列表。其中至少有一个方法，&keys;，看起来还是挺熟悉的。 这里就是真正变得有趣的地方。&odbchelper_modulename; 是一个模块，所以&dir;(&odbchelper_modulename;)返回模块中定义的所有部件的列表，包括内置的属性，例如&name;，&doc;, 以及其它你所定义的属性和方法。在这个例子中，&odbchelper_modulename; 只有一个用户定义的方法，就是在中论述的 &odbchelper_function; 函数。 最后是 &callable; 函数，它接收任何对象作为参数，如果参数对象是可调用的那么返回&true;，否则返回&false;。可调用对象包括函数、类方法，甚至类自身。（下一章将更多的关注类）。 &prompt;import string &prompt;string.punctuation '!"#$&pct;&\'()*+,-./:;<=>?@[\\]^_`{|}~' &prompt;string.join <function join at 00C55A7C> &prompt;callable(string.punctuation) False &prompt;callable(string.join) True &prompt;print string.join.__doc__ join(list [,sep]) -> string Return a string composed of the words in list, with intervening occurrences of sep. The default separator is a single space. (joinfields and join are synonymous) &string; 模块中的函数现在已经不赞成使用了（尽管很多人现在仍然还在使用&join;函数），但是在这个模块中包含了许多有用的变量比如string.punctuation, 这个模块包含了所有标准的标点符号字符 string.join是一个用于连接字符串列表的函数。 string.punctuation是不可调用的对象；它是一个字符串。（字符串确有可调用的方法，但是字符串本身不是可调用的。） string.join是可调用的；这个函数可以接受两个参数。 任何可调用的对象都有 &docstring;。通过将 &callable; 函数作用于一个对象的每个属性，可以确定哪些属性（方法、函数、类）是你要关注的，哪些属性（常量等等）是你可以忽略、之前不需要知道的。

&type;、&str;、&dir; 和其它的 &python; 内置函数都归组到了 &builtins; （前后分别是双下划线）这个特殊的模块中。如果有帮助的话，你可以认为 &python; 在启动时自动执行了from __builtin__ import *，此语句将所有的内置 函数导入该命名空间，所以在这个命名空间中可以直接使用这些内置函数。 像这样考虑的好处是，是你可以获取__builtin__模块信息的，并以组的形式访问所有的内置函数和属性。 猜到什么了吗，&python; 有一个称为&info;的函数。自己尝试一下，略看一下结果列表。后面我们将深入到一些更重要的函数。（一些内置的错误类，比如AttributeError，应该看上去已经熟悉了。） &prompt;from apihelper import info &prompt;import __builtin__ &prompt;info(__builtin__, 20) ArithmeticError Base class for arithmetic errors. AssertionError Assertion failed. AttributeError Attribute not found. EOFError Read beyond end of file. EnvironmentError Base class for I/O related errors. Exception Common base class for all exceptions. FloatingPointError Floating point operation failed. IOError I/O operation failed. [...snip...] &python; 提供了很多出色的参考手册，你应该好好的精读一下所有 &python; 提供的必备 模块。对于其它大部分语言，你会发现自己要常常回头参考手册或者man页来提醒自己如何使用这些模块，但是&python;不同于此，它很大程度上是自文档化的。 &pythonlibraryreference; 对所有的内置函数 和 所有的内置异常都进行了文档化。

&prompt;li = ["Larry", "Curly"] &prompt;li.pop <built-in method pop of list object at 010DF884> &prompt;getattr(li, "pop") <built-in method pop of list object at 010DF884> &prompt;getattr(li, "append")("Moe") &prompt;li ["Larry", "Curly", "Moe"] &prompt;getattr({}, "clear") <built-in method clear of dictionary object at 00F113D4> &prompt;getattr((), "pop") &traceback; AttributeError: 'tuple' object has no attribute 'pop' 该语句获取列表的 &pop; 方法的引用。注意该语句并不是调用 &pop; 方法；调用pop方法应该是 li.pop()。这里指的是方法对象本身。 该语句也是返回 &pop; 方法的引用，但是此时，方法名称是作为一个字符串参数传递给&getattr;函数的。&getattr;是一个有用到令人无法致信的内置函数，可以返回任何对象的任何属性。在这个例子中，对象是一个list，属性是 &pop; 方法。 如果不深信它是多么的有用，试试这个：&getattr; 的返回值是 方法，然后你就可以调用它就像直接使用 li.append("Moe")一样。但是实际上你没有直接调用函数；只是以字符串形式指定了函数名称。 &getattr; 也可以作用于字典。 理论上, &getattr; 可以作用于元组，但是由于元组没有方法, 所以不管你指定什么属性名称&getattr; 都会引发一个异常。

&getattr; 不仅仅适用于内置数据型别，也可作用于模块。 &prompt;import &odbchelper_name; &prompt;&odbchelper_name;.&odbchelper_funcname; <function &odbchelper_funcname; at 00D18DD4> &prompt;getattr(&odbchelper_name;, "&odbchelper_funcname;") <function &odbchelper_funcname; at 00D18DD4> &prompt;object = &odbchelper_name; &prompt;method = "&odbchelper_funcname;" &prompt;getattr(object, method) <function &odbchelper_funcname; at 00D18DD4> &prompt;type(getattr(object, method)) <type 'function'> &prompt;import types &prompt;type(getattr(object, method)) == types.FunctionType True &prompt;callable(getattr(object, method)) True 该语句返回 &odbchelper_modulename; 模块中 &odbchelper_function; 函数的引用，你已经研习过这个方法了。（你看到的这个十六进制地址是我机器上的；你的输出结果会有所不同。） 使用&getattr;，你能够获得同一函数的同一引用。通常，&getattr;(object, "attribute") 等价于 object.attribute。如果 object 是一个模块的话，那么attribute 可能是定义在模块中的任何东西：函数、类或者全局变量。 接下来的是你真正用在 &info; 函数中的东西。object 作为一个参数传递给函数； method 是方法或者函数的名称字符串。 在这个例子中, method 是函数的名称，通过获取 &type; 可以进行验证。 由于 method 是一个函数，所以它是可调用的。

&getattr;常见的使用模式是作为一个分发者。举个例子，如果你有一个程序可以以不同的格式输出数据，你可以为个每种输出格式定义各自的格式输出函数，然后使用唯一的分发函数调用所需的格式输出函数。 例如，让我们假设有一个以&html;、&xml;和普通文本格式打印站点统计的程序。输出格式在命令行中指定，或者保存在配置文件中。statsout 模块定义了三个函数：output_html、output_xml和output_text。然后主程序定义了唯一的输出函数，如下： import statsout def output(data, format="text"): output_function = getattr(statsout, "output_%s" % format) return output_function(data) output 函数接收一个必备参数data，和一个可选参数format。如果没有指定format参数，其缺省值是text并完成普通文本输出函数的调用。 你可以连接format 参数值和"output_"来创建一个函数名称作为参数值，然后从statsout模块中取得该函数。这种方式允许今后很容易的扩展程序以支持其它的输出格式，而且无需修改分发函数。所要做的仅仅是向statsout中添加一个函数，比如output_pdf，之后只要将“pdf”作为format的参数值传递给output 函数即可。 现在你可以简单的调用输出函数就像调用其它函数一样了。output_function 变量是指向statsout 模块中相应函数的引用。 你是否发现前面示例的一个Bug？即字符串和函数之间的松耦合，而且没有错误检查。如果用户传入一个格式参数，但是在statsout中没有定义相应的格式输出函数，会发生什么呢？还好，&getattr; 会返回&none;，它会取代一个有效函数并被赋值给output_function，然后下一行调用函数的语句将会失败并抛出一个异常。这种方式不好。 值得庆幸的是，&getattr; 能够使用可选的第三个参数，一个缺省返回值。 import statsout def output(data, format="text"): output_function = getattr(statsout, "output_%s" % format, statsout.output_text) return output_function(data) 这个函数调用确保可以工作，因为你在调用&getattr; 时添加了第三个参数。第三个参数是一个缺省返回值，如果第二个参数指定的属性或者方法没有找到将返回这个缺省返回值。 正如你所看到，&getattr; 是相当强大的。它是自省的核心，在后面的章节中你将看到它更强大的示例。

--> 过滤列表语法： [mapping-expression for element in source-list if filter-expression] 这是你所知所爱的列表解析的扩展。前三部分都是相同的；最后一部分，以&if;开头的是过滤器表达式。过滤器表达式可以是返回值为真或者假（在&python;是几乎任何东西）的任何表达式。任何经过滤器表达式演算值为元素的真都可以包含在映射中。其它的元素都将忽略，它们不会进入映射表达式，更不会包含在输出列表中。 &prompt;li = ["a", "mpilgrim", "foo", "b", "c", "b", "d", "d"] &prompt;[elem for elem in li if len(elem) > 1] ['mpilgrim', 'foo'] &prompt;[elem for elem in li if elem != "b"] ['a', 'mpilgrim', 'foo', 'c', 'd', 'd'] &prompt;[elem for elem in li if li.count(elem) == 1] ['a', 'mpilgrim', 'foo', 'c'] 这里的映射表达式很简单（只是返回每个元素的值），所以请把注意力集中到过滤器表达式上。由于&python; 会遍历整个列表，它将对每个元素执行过滤器表达式。如果过滤器表达式演算值为真，该元素就会被映射，同时映射表达式的结果将包含在返回的列表中。这里，你过滤掉了所有单字符的字符串，留下了一个都是长字符串的列表。 这里你过滤掉了一个特定值b。 注意这个过滤器会过滤掉所有的 b，因为每次取出 b，过滤表达式都将为假。 &count; 是一个列表方法，返回某个值在列表中出现的次数。你可以认为这个过滤器将从列表中剔除重复元素，返回一个只包含了在原始列表中有着唯一值拷贝的列表。但是不是这样的，因为在原始列表中出现两次的值（在本例中，b 和 d）被完全剔除了。存在从一个列表排除重复值的方法，但过滤并非解决之道。 回到 &apihelper_filename; 中的这一行： &apihelper_methods; 这行看上去挺复杂的，确实也很复杂，但是基本结构都还是一样的。整个过滤表达式返回一个列表，并赋值给 methodList 变量。表达式的前半部分是列表映射部分。映射表达式是一个和遍历元素相同的表达式，因此它返回每个元素的值。&dir;(object) 返回 object 对象的属性和方法列表——你正在映射的列表。所以唯一新出现的部分就是在 &if; 后面的过滤表达式。 过滤表达式看上去很恐怖，其实不是。你已经知道了 &callable;、&getattr; 和 ∈。正如你在 前面的部分 中看到的，如果 object 是一个模块，并且method 是上述模块中某个函数的名称，那么表达式 &apihelper_getattr; 将返回一个函数对象。 所以这个表达式接收一个名为 object 的对象，然后得到它的属性、方法、函数和其他部件的名称列表，接着过滤掉我们不关心的部件。执行过滤行为是通过对每个属性/方法/函数的名称调用 &getattr; 函数取得实际部件的引用，然后检查这些部件对象是否是可调用的，当然这些可调用的部件对象可能是方法或者函数，同时也可能是内置(例如列表的 &pop; 方法)或者用户自定义的（例如 &odbchelper_modulename; 模块的 &odbchelper_function; 函数）。这里你不用关心其它的属性，如内置在每一个模块中的 &name; 属性。 &pythontutorial; 讨论了使用内置过滤器函数过滤列表的另一种方式。

&prompt;'a' and 'b' 'b' &prompt;'' and 'b' '' &prompt;'a' and 'b' and 'c' 'c' 使用 &andfunction; 时，在布尔上下文中从左到右演算表达式的值。&zero;、''、[]、()、{}、&none; 在布尔上下文中为假；其它任何东西都为真。还好，几乎是所有东西。默认情况下，布尔上下文中的类实例为真，但是你可以在类中定义特定的方法使得类实例的演算值为假。你将会在中了解到类和这些特殊方法。如果布尔上下文中的所有值都为真，那么 &andfunction; 返回最后一个值。在这个例子中，&andfunction; 演算 'a' 的值为真，然后是 'b' 的演算值为真，最终返回'b'。 如果布尔上下文中的某个值为假，则 &andfunction; 返回第一个假值。在这个例子中，'' 是第一个假值。 所有值都为真，所以 &andfunction; 返回最后一个真值，'c'。 &prompt;'a' or 'b' 'a' &prompt;'' or 'b' 'b' &prompt;'' or [] or {} {} &prompt;def sidefx(): &continuationprompt;print "in sidefx()" &continuationprompt;return 1 &prompt;'a' or sidefx() 'a' 使用 &orfunction; 时，在布尔上下文中从左到右演算值，就像 &andfunction; 一样。如果有一个值为真，&orfunction; 立刻返回该值。本例中，'a' 是第一个真值。 &orfunction; 演算 '' 的值为假，然后演算 'b' 的值为真，于是返回 'b' 。 如果所有的值都为假，&orfunction; 返回最后一个假值。&orfunction; 演算 '' 的值为假，然后演算 [] 的值为假，依次演算 {} 的值为假，最终返回 {} 。 注意 &orfunction; 在布尔上下文中会一直进行表达式演算直到找到第一个真值，然后就会忽略剩余的比较值。如果某些值具有副作用，这种特性就非常重要了。在这里，函数sidefx 永远都不会被调用，因为 &orfunction; 演算 'a' 的值为真，所以紧接着就立刻返回 'a' 了。 如果你是一名 &c; 语言黑客，肯定很熟悉&candor; 表达式，如果 bool 为真，表达式演算值为 a，否则为 b。基于 &python; 中 &andfunction; 和 &orfunction; 的工作方式，你可以完成相同的事情。

&prompt;a = "first" &prompt;b = "second" &prompt;1 and a or b 'first' &prompt;0 and a or b 'second' 这个语法看起来类似于 &c; 语言中的 &candor; 表达式。整个表达式从左到右进行演算，所以先进行 &andfunction;表达式的演算。 1 and 'first' 演算值为 'first'，然后 'first' or 'second' 的演算值为 'first'。 0 and 'first' 演算值为&false;，然后 0 or 'second' 演算值为 'second'。 然而，由于这种 &python; 表达式单单只是进行布尔逻辑运算，并不是语言的特定构成，这是 &andor; 技巧和 &c; 语言中的 &candor; 语法非常重要的不同。如果 a 为假，表达式就不会按你期望的那样工作了。（你能知道我被这个问题折腾过吗？不只一次？） &prompt;a = "" &prompt;b = "second" &prompt;1 and a or b 'second' 由于 a 是一个空字符串，在 &python; 的布尔上下文中空字符串被认为是假的，1 and '' 的演算值为 ''，最后 '' or 'second' 的演算值为 'second'。噢！这个值并不是你想要的。 &andor; 技巧，bool and a or b表达式，当 a 在布尔上下文中的值为假时，不会像 &c; 语言表达式 &candor; 那样工作。 在 &andor; 技巧后面真正的技巧是，确保 a 的值决不会为假。最常用的方式是使 a 成为 [a] 、 b 成为 [b]，然后使用返回值列表的第一个元素，应该是 a 或 b中的某一个。 &prompt;a = "" &prompt;b = "second" &prompt;(1 and [a] or [b])[0] '' 由于 [a] 是一个非空列表，所以它决不会为假。即使 a 是 &zero; 或者 '' 或者其它假值，列表[a] 也为真，因为它有一个元素。 到现在为止，这个技巧可能看上去问题超过了它的价值。毕竟，使用&if; 语句可以完成相同的事情，那为什么要经历这些麻烦事呢？哦，在很多情况下，你要在两个常量值中进行选择，由于你知道 a 的值总是为真，所以你可以使用这种较为简单的语法而且不用担心。对于使用更为复杂的安全形式，依然有很好的理由要求这样做。例如，在&python; 语言的某些情况下 &if; 语句是不允许使用的，比如在&lambdafunction; 函数中。 &pythoncookbook; 讨论了 其它的 &andor; 技巧。

&prompt;def f(x): &continuationprompt;return x*2 &continuationprompt; &prompt;f(3) 6 &prompt;g = lambda x: x*2 &prompt;g(3) 6 &prompt;(lambda x: x*2)(3) 6 这是一个 &lambdafunction; 函数，完成成同上面普通函数相同的事情。注意这里的简短的语法：在参数列表周围没有括号，而且忽略了 return 关键字（） (it is implied, since the entire function can only be one expression). 而且，该函数没有函数名称，但是可以将它赋值给一个变量进行调用。 你可以使用 &lambdafunction; 函数甚至不需要将它赋值给一个变量。这可能不是最有用的东西 in the world，它只是展示了 lambda 函数只是一个内联函数。 总的来说，&lambdafunction; 函数可以接收任意多个参数（包括 可选参数）并且返回单个表达式的值。&lambdafunction; 函数不能包含命令，包含的表达式不能超过一个。不要试图向 &lambdafunction; 函数中塞入太多的东西；如果你需要更复杂的东西，应该定义一个普通函数，然后想让它多长就多常。 &lambdafunction; 函数是一种风格问题。不一定非要使用它们；任何能够使用它们的地方，都可以定义一个单独的普通函数来进行替换。我将它们用在需要封装特殊的、非重用的代码上 without littering my code with a lot of little one-line functions.

&apihelper_filename; 中的 &lambdafunction; 函数： &apihelper_lambda; 注意这里使用了 &andor; 技巧的简单形式，它是没问题的，因为 &lambdafunction; 函数 在布尔上下文中总是为真。（这并不意味这 &lambdafunction; 函数不能返回假值。这个函数对象的布尔值为真；它的返回值可以是任何东西。） 还要注意的是使用了没有参数的 &split; 函数。你已经看到过它带一个或者两个参数的使用，但是不带参数它按空白进行分割。 &prompt;s = "this is\na\ttest" &prompt;print s this is a test &prompt;print s.split() ['this', 'is', 'a', 'test'] &prompt;print " ".join(s.split()) 'this is a test' 这是一个多行字符串，通过使用转义字符的定义代替了 三重引号。\n 是一个回车，\t 是一个制表符。 不带参数的&split; 按照空格进行分割。所以三个空格、一个回车和一个制表符都是一样的。 通过 &split; 分割字符串你可以将空格统一化；然后再以单个空格作为分隔符用 &join; 将其重新连接起来。这也就是 &info; 函数将多行 &docstring; 合并成单行所做的事情。 那么 &info; 函数到底用这些 &lambdafunction; 函数、&split; 函数和 &andor; 技巧做了些什么呢？ &apihelper_lambda; processFunc 现在是一个函数，但是它到底是哪一个函数还要取决于 collapse 变量。如果 collapse 为真，processFunc(string) 将压缩空白；否则 processFunc(string) 将返回未改变的参数。 在一个不很健壮的语言中实现它，像 &vb;，你很有可能要创建一个函数，接受一个字符串参数和一个 collapse 参数，并使用 &if; 语句确定是否压缩空白，然后再返回相应的值。这种方式是低效的，因为函数可能需要处理每一种可能的情况。每次你调用它，它将不得不在给出你所想要的东西之前，判断是否要压缩空白。在 &python; 中，你可以将决策逻辑拿到函数外面，而定义一个裁减过的 &lambdafunction; 函数提供确切的（唯一的）你想要的。这种方式更为高效、更为优雅，而且很少引起那些令人讨厌的(哦，想到那些参数就头昏)的错误。 &pythonknowledgebase; 讨论了使用 &lambdafunction; 来间接调用函数。 &pythontutorial; 演示了如何 从一个 &lambdafunction; 函数内部访问外部变量。（PEP 227 解释了在 &python; 的未来版本中将如何变化。） &pythonfaq; 有关于 令人模糊的使用 &lambdafunction; 单行语句的例子。

--> 下面是 &apihelper_filename; 的根本 &apihelper_main; 注意这是一条命令，被分隔成了多行，但是并没有使用续行符（\）。还记得我说过 一些表达式可以分割成多行 而不需要使用反斜线吗？列表解析就是这些表达式之一，因为整个表达式包括在方括号里。 现在，让我们从后向前分析。这个 for method in methodList告诉我们这是一个 列表解析。 如你所知 methodList 是 object 中 所有你关心的方法 的一个列表。所以你正在使用 method 遍历列表。 &prompt;import &odbchelper_name; &prompt;object = &odbchelper_name; &prompt;method = '&odbchelper_funcname;' &prompt;getattr(object, method) <function buildConnectionString at 010D6D74> &prompt;print getattr(object, method).__doc__ &odbchelper_docstring; 在 &info; 函数中，object 是要得到帮助的对象，作为一个参数传入。 在你遍历 methodList 时，method 是当前方法的名称。 通过 &getattr; 函数，你可以得到 object 模块中 method 函数的引用。 现在，很容易就可以打印出方法的 &docstring; 。 接下来令人困惑的是 &docstring; 周围 &str; 的使用。你可能记得，&str; 是一个内置函数，它可以 强制将数据转化为字符串。但是一个 &docstring; 应该总是一个字符串，为什么还要费事的使用 &str; 函数呢？答案就是：不是每个函数都有 &docstring; ，如果没有，这个 &doc; 属性为 &none;。 &prompt;>>> def foo(): print 2 &prompt;>>> foo() 2 &prompt;>>> foo.__doc__ &prompt;foo.__doc__ == None True &prompt;str(foo.__doc__) 'None' 你可以很容易的定义一个没有 &docstring; 的函数，这种情况下它的 &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; 是一个你之前没有见过的新字符串方法。 &prompt;s = 'buildConnectionString' &prompt;s.ljust(30) 'buildConnectionString ' &prompt;s.ljust(20) 'buildConnectionString' &ljust; 用空格填充字符串以符合指定的长度。info 函数使用它生成了两列输出并将所有在第二列的 &docstring; 纵向对齐。 如果指定的长度小于字符串的长度，&ljust; 将简单的返回未变化的字符串。它决不会截断字符串。 几乎已经完成了。有了 &ljust; 方法填充过的方法名称和来自调用 processFunc 方法得到的 &docstring;（可能压缩过），你就可以将两者连接起来并得到单个字符串。因为对 methodList 进行了映射，最终你将获得一个字符串列表。利用"\n" 的 &join; 函数，将这个列表连接为单个字符串，列表中每个元素独占一行，接着打印出结果。 &prompt;li = ['a', 'b', 'c'] &prompt;print "\n".join(li) a b c 在你处理列表时，这确实是一个有用的调试技巧。还有一点在 &python; 中，你总是在操纵列表。 上述就是最后一个令人困惑的地方了。但是现在你应该已经理解这段代码了。 &apihelper_main;

--> &apihelper_funcdef; &apihelper_docstring; &apihelper_docstring2; &apihelper_docstring3; &apihelper_methods; &apihelper_lambda; &apihelper_main; &apihelper_ifname; &apihelper_printdoc; &apihelper_filename; 的输出： &apihelper_output; 在研究下一章前，确保你可以无困难的完成下面这些事情： 用 可选和命名参数定义和调用函数 用 &str; 强制转换任意值为字符串形式 用 &getattr; 动态得到函数和其它属性的引用 扩展列表解析语法来进行 列表过滤 识别 &andor; 技巧 并安全的使用它 定义 &lambdafunction; 函数 将函数赋值给变量 然后通过引用变量调用函数。我强调的已经够多了：这种思考方式对于提高对 &python; 的理解力至关重要。从这书中你会随处可见这种技术的更复杂的应用。