Python 文档字符串(DocStrings)是个啥??

背景

最近在开发过程中,突然发现还有一个东西叫做文档字符串的玩意,原来函数的注释还能这么用??python再次刷新了我的认知。以前函数注释我都是写在函数之前,现在看来,是我的代码不够规范了。正确的方式应该如下所示,这样直接通过func._doc_就可以获取该函数的说明,可谓是方便至极

Python 文档字符串(DocStrings)

DocStrings 文档字符串是一个重要工具,用于解释文档程序,帮助你的程序文档更加简单易懂。

我们可以在函数体的第一行使用一对三个单引号 ''' 或者一对三个双引号 """ 来定义文档字符串。

你可以使用 __doc__(注意双下划线)调用函数中的文档字符串属性。

#!/usr/bin/python
# -*- coding: UTF-8 -*-def function():''' say something here!'''passprint (function.__doc__) # 调用 doc

输出结果为: say something here!

DocStrings 文档字符串使用惯例:首行简述函数功能,第二行空行,第三行为函数的具体描述

#!/usr/bin/python
# -*- coding: UTF-8 -*-def printMax(x,y):'''打印两个数中的最大值。两个值必须都是整形数。'''x=int(x)y=int(y)if x>y:print(x,'最大')else:print(y,'最大')printMax(3,5)
print (printMax.__doc__) # 调用 doc

输出为:
    打印两个数中的最大值。

    两个值必须都是整形数。
 

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/pingmian/40482.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Lesson 46 Can you ... ?

Lesson 46 Can you … ? 词汇 lift v. 拿起,搬起 n. 电梯(直梯) 用法:1. lift … up 拎起……    例句:我可以拎起那只小猫。       I can lift that cat up.    2. take a lift    例句&#xff1a…

如何在Docker容器中,修改MySQL密码

如果MySQL运行在Docker容器中,修改MySQL密码的方法稍有不同。以下是如何在Docker中修改MySQL密码的步骤: 方法1:使用MySQL命令行工具 1. 找到MySQL容器的ID或者名字: docker ps 2. 进入MySQL容器: docker exec -i…

SQL Server中设置端口号

在SQL Server中设置端口号可以通过SQL Server配置管理器进行。以下是具体步骤: 使用SQL Server 配置管理器设置端口 打开SQL Server配置管理器: 在Windows开始菜单中搜索“SQL Server 配置管理器”,然后打开它。 配置SQL Server网络配置&…

mongodb在windows环境安装部署

一、mongodb 1.释义 MongoDB 是一种开源的文档型 NoSQL 数据库管理系统,使用 C 编写,旨在实现高性能、高可靠性和易扩展性。MongoDB 采用了面向文档的数据模型,数据以 JSON 风格的 BSON(Binary JSON)文档存储&#x…

VSCode使用SSH无需输入密码远程连接服务器

目录 一、密钥生成 1、使用windows11自带的命令行 2、使用putty工具 二、查看密钥 三、设置服务器 这个过程是比较简单的,为了方便后续留用和查看,整理个笔记放着。 一、密钥生成 1、使用windows11自带的命令行 在任一文件夹中,空白处…

数据融合平台的概述、特点及技术方案

在当今数字化时代,数据已成为企业最宝贵的资产之一。然而,数据的分散存储和格式不一,常常导致数据孤岛现象,使得数据的潜在价值难以被充分挖掘和利用。在这样的背景下,数据融合平台应运而生,它的意义不仅在…

【前端】技巧 js 监听所有A标签 拦截 用于安全跳转等

【前端】技巧 监听所有A标签 拦截 用于安全跳转等 监听a标签() 如果有动态的a标签 可以生成动态a标签之后 再执行这个方法 function 监听a标签(){// 获取所有的 <a> 标签const links document.querySelectorAll(a);// 遍历每个 <a> 标签&#xff0c;并添加点击事件…

amis中条件组合器condition-builder的使用 和 解析

1.amis中配置一个条件组合器&#xff0c;condition-builder。并根据自己业务需求配置source。这里用了一些自定义filter来进行预处理。 {"type": "condition-builder","label": "条件组合","name": "node.conditions&q…

ARCGIS PRO SDK 选择对象Dictionary的操作

一、SelectionSet的成员 SelectionSet的3个主要成员&#xff1a; 1、Count&#xff1a;获取选择集中记录的总数。返回的是一个int值。 2、isEmpty&#xff1a;判断当前选择集是否为空。返回的是一个bool值。 3、item&#xff1a;获取成员对象 ID的列表。返回的是一组long值。 二…

Python 插入、替换、提取、或删除Excel中的图片

Excel是主要用于处理表格和数据的工具&#xff0c;我们也能在其中插入、编辑或管理图片&#xff0c;为工作表增添视觉效果&#xff0c;提升报告的吸引力。本文将详细介绍如何使用Python操作Excel中的图片&#xff0c;包含以下4个基础示例&#xff1a; 文章目录 Python 在Excel…

【期末复习】微信小程序复习大纲

前言&#xff1a; 这周开始进入期末复习周&#xff0c;没时间看C/C、linux等知识了&#xff0c;先把期末考试必考的知识捋一遍。 目录 第一章 微信小程序入门 一、填空题 二、判断题 三、选择题 四、简答题 第二章 微信小程序页面制作 一、填空题 二、判…

java.lang.UnsupportedClassVersionError

一、问题描述 在本地打包后&#xff0c;在服务器上运行Jar包&#xff0c;出现&#xff1a; Exception in thread "main" java.lang.UnsupportedClassVersionError: XXX has been compiled by a more recent version of the Java Runtime (class file version 55.0),…

.NET 漏洞情报 | 某整合管理平台SQL注入

01阅读须知 此文所提供的信息只为网络安全人员对自己所负责的网站、服务器等&#xff08;包括但不限于&#xff09;进行检测或维护参考&#xff0c;未经授权请勿利用文章中的技术资料对任何计算机系统进行入侵操作。利用此文所提供的信息而造成的直接或间接后果和损失&#xf…

AI-算力集群通往AGI

背景&#xff1a; 自GPT-4发布以来&#xff0c;全球AI能力的发展势头有放缓的迹象。 但这并不意味着Scaling Law失效&#xff0c;也不是因为训练数据不够&#xff0c;而是结结实实的遇到了算力瓶颈。 具体来说&#xff0c;GPT-4的训练算力约2e25 FLOP&#xff0c;近期发布的几个…

驱使ai学习搭子,写出一份“完美”的代码“文档”

自己把控“核心关键”&#xff0c;ai会把文档写得比您预想的“完美”。 (笔记模板由python脚本于2024年07月04日 10:44:39创建&#xff0c;本篇笔记适合喜欢结伴ai学习的coder翻阅) 【学习的细节是欢悦的历程】 Python 官网&#xff1a;https://www.python.org/ Free&#xff…

入深户考什么中级职称好?这个首选!

如果你学历不够&#xff0c;又想入户深圳的话&#xff0c;不妨试试通过考取一个中级职称证书入户深圳&#xff0c;职称证书是低学历人群入户深圳的热门方式之一。 虽然可以用来入户的证书很多&#xff0c;但是没有比系统集成项目管理工程师更容易考更适合入户的了&#xff01;…

PHP房产小程序微信小程序系统源码

&#x1f3e0;—— 购房租房&#xff0c;一“指”搞定&#x1f3e1; &#x1f50d;【开篇&#xff1a;房产新视界&#xff0c;尽在掌握】 在这个信息爆炸的时代&#xff0c;找房子不再是一场漫长的奔波。有了“房产微信小程序”&#xff0c;无论是购房还是租房&#xff0c;都…

Java之类的生命周期

1.加载&#xff08;Loading&#xff09; Java虚拟机&#xff08;JVM&#xff09;通过类加载器根据类的全限定名通过不同渠道以二进制流的方式获取字节码信息并读取到内存中。类加载器在加载完类之后&#xff0c;Java虚拟机会将字节码中的信息保存到方法区中&#xff0c;生成一…

SVD求解超定方程

SVD求解超定方程: 正交矩阵的保范性&#xff1a;乘一个正交矩阵&#xff0c;其模大小不变&#xff0c;可以想象成乘一个旋转矩阵。 ∥ A x − b ∥ 2 2 ∥ U [ Σ 0 ] V T x − b ∥ 2 2 &#xff08;两边同时乘 U T &#xff0c;不改变模大小&#xff09; ∥ [ Σ 0 ] V T x…

【PCIe】P2P DMA

PCIe P2P (peer-to-peer communication)是PCIe的一种特性&#xff0c;它使两个PCIe设备之间可以直接传输数据&#xff0c;而不需要使用主机RAM作为临时存储。如下图3的走向 比如EP1要发送和数据给EP2,操作流程如下&#xff1a; 1. 打开EP1的dma控制器&#xff1b;--client侧 …