learning python--Docstrings使用

最新推荐文章于 2025-12-11 11:44:25 发布

原创最新推荐文章于 2025-12-11 11:44:25 发布 · 840 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#math #class #numbers #python #object #2010

本文介绍了Python中Docstrings的基本用法，包括单行和多行Docstrings的例子，并通过具体代码展示了如何为函数和类编写清晰的文档字符串，以便于理解和维护。

One-Line Docstrings

example ：

def add(x, y):
    """Return the sum of two numbers."""
    return x + y

print add._doc_

Multi-Line Docstrings
 
  example ：
 
 
  Listing 1
 
 
  def subtract(x, y):
    """Return the difference between two numbers.

    Arguments:
    x -- The minuend.
    y -- The subtrahend.

    Returns:
    A number, the difference between x and y (ie. x - y)

    """
    return x - y
substract(5,2)
print substarct_doc_
Listing 2
#!/usr/bin/env python
"""A simple math module.

Exported Classes:

Math -- A simple math class with mathematical functions.

"""

class Math(object):
    """A simple math class with mathematical functions.

    Public functions:
    add -- Adds two numbers together and
    returns the result.

    subtract -- Returns the difference between
    two numbers.

    """

    def subtract(self, x, y):
        """Return the difference between two numbers.

        Arguments:
        x -- The minuend.
        y -- The subtrahend.

        Returns:
        A number, the difference between x and y (ie. x - y)

        """
        return x - y

    def add(self, x, y):
        """Return the sum of two numbers.

        Arguments:
        x -- Number to be summed.
        y -- Number to be summed.

        Returns:
        A number, the sum of x and y (ie. x + y)

        """
        return x + y
print add(4,5)
print add_doc_
www.learningpython.com/2010/01/08/introducing-docstrings/