编写多个文档字符串以及给我的随机函数的注释

Question

您好，我得到了一个函数，但我不确定每个函数的功能是什么：（是的，这就是我得到的全部）def pumpkin(b1,b2,b3):    b4= b2+b3    b5= []    for b6 in b1:        if b6[0] == b2 and b6[:2] !=b4:           b5.append(b6)        return b5我确实知道 if 函数会执行完毕，并将列表 b6 中位置 0 的字符与 b2 列表进行比较。列表 b6 中位置 0 和 1 的字符。为了使该函数工作，b6[0] 必须等于 b2，并且 b6[:2] 不得等于 b4。任何帮助将不胜感激。我需要有文档字符串和注释来向用户阐明每个函数的作用。

Answer 1

你的函数很疯狂，因为不清楚任何类型是什么。不过根据你的描述，我想我已经能弄清楚了。这是带有“类型注释”的函数：

def pumpkin(as_in, s2, s3):

   s4 = s2 + s3

   as_out = []

   for s in as_in:

      if s[0] == s2 and s[:2] != s4:

         as_out.append(s)

   return as_out

a = pumpkin(['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul'], 'J', 'a')

print(a)

其中as_是字符串数组，s是字符串。如果这是正确的，那么该函数所做的就是获取一个字符串数组。然后它查找与第一个字母匹配但不与第二个字母匹配的元素。如果我是对的，那么你实际上可以像这样简化函数（以及其他方式）：

def pumpkin(as_in, s2, s3):

   as_out = []

   for s in as_in:

      if s[0] == s2 and s[1] != s3:

         as_out.append(s)

   return as_out

无论哪种情况，以我的示例为例，结果都是['Jun', 'Jul']。