本文档主要介绍如何使用 Python 进行面向对象编程，需要读者对 Python 语法和单片机开发具有基本了解。相比其他讲解 Python 面向对象编程的博客或书籍而言，本文档更加详细、侧重于嵌入式上位机应用，以上位机和下位机的常见串口数据收发、数据处理、动态图绘制等为应用实例，同时使用 Sourcetrail 代码软件对代码进行可视化阅读便于读者理解。

相关示例代码获取链接如下：https://github.com/leezisheng/Python-OOP-Demo

正文

在 Python 中，我们可以为方法、类和模块添加文档字符串，这些文档字符串可以通过一个特殊属性__doc__获取。文档字符串（docstring）是一种用于描述类、函数、模块或方法的字符串，通常位于定义的顶部，并用于提供有关其功能和用法的信息。文档字符串通常被包含在三引号（”’ 或 “””）中，并位于类、函数、模块或方法定义的顶部。

例如，在下列示例中，我们为 MasterClass 主机类及其 StartMaster 开启主机方法添加必要注释，并通过以下语句访问：

_# 访问MasterClass类的__doc__属性_
    print(MasterClass.__doc__)
    _# 访问MasterClass类中StartMaster方法的__doc__属性_
    print(MasterClass.StartMaster.__doc__)

示例代码如下：

class MasterClass(SerialClass,PlotClass):
    '''
    MasterClass：该类表示主机类，主要用于接收传感器数据、收发指令等

    具有如下属性：
        state       —— 表示主机工作状态
        port        —— 表示主机端口号
        wintitle    —— 表示窗口标题
        ... ...

    具有如下方法：
        StartMaster     —— 开启主机
        StopMaster      —— 停止主机
        RecvSensorValue —— 接收传感器数据值
        ... ...
    '''
    ...
    _# 类的初始化_
    def __init__(self,state:int = IDLE_STATE,port:str = "COM17",wintitle:str="Basic plotting examples",plottitle:str="Updating plot",width:int=1000,height:int=600):
        pass
    _# 开启主机_
    def StartMaster(self):
        '''
            StartMaster方法——开启主机
            调用SerialClass.OpenSerial()方法
        :return: 无返回值
        '''
        pass

如下为运行结果：

同时，我们也可以给命名元组添加文档字符串。使用一个类继承对应的命名元组，并在类中添加文档注释，示例代码如下：

from collections import namedtuple

_Sensor = namedtuple("Sensor","ID CURRENTVALUE MAXVALUE MINVALUE")

class Sensor(_Sensor):
    '''
        这是一个继承自表示传感器数据的命名元组的类
        具有四个属性：
            （1） ID              ： 表示传感器ID号
            （2） CURRENTVALUE    ： 传感器采集到的当前数据值
            （3） MAXVALUE        ： 传感器采集到的最大数据值
            （4） MINVALUE        ： 传感器采集到的最小数据值
    '''
sensor_tuple=Sensor(ID="16",CURRENTVALUE=32,MAXVALUE=62,MINVALUE=2)
print(sensor_tuple.__doc__)

运行结果如下：

千百度

1.本站内容仅供参考，不作为任何法律依据。用户在使用本站内容时，应自行判断其真实性、准确性和完整性，并承担相应风险。

2.本站部分内容来源于互联网，仅用于交流学习研究知识，若侵犯了您的合法权益，请及时邮件或站内私信与本站联系，我们将尽快予以处理。

3.本文采用知识共享署名4.0国际许可协议 [BY-NC-SA] 进行授权

4.根据《计算机软件保护条例》第十七条规定“为了学习和研究软件内含的设计思想和原理，通过安装、显示、传输或者存储软件等方式使用软件的，可以不经软件著作权人许可，不向其支付报酬。”您需知晓本站所有内容资源均来源于网络，仅供用户交流学习与研究使用，版权归属原版权方所有，版权争议与本站无关，用户本人下载后不能用作商业或非法用途，需在24个小时之内从您的电脑中彻底删除上述内容，否则后果均由用户承担责任；如果您访问和下载此文件，表示您同意只将此文件用于参考、学习而非其他用途，否则一切后果请您自行承担，如果您喜欢该程序，请支持正版软件，购买注册，得到更好的正版服务。