【学习心得】Python的注解/Type Hints(简介)

2024-02-17 07:52

本文主要是介绍【学习心得】Python的注解/Type Hints(简介),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

        Python3.5之后出现的新特性(Python Type Hints),中文翻译可以叫做“注解”、“类型标注”、“类型提示”。类型标注的作用是:指明某个变量或者返回值的类型,他的语法形式是什么样子的呢?这篇文章是我自己学习Python过程中的一个知识点小记,希望能帮助到大家。

一、基本语法

(1)变量类型注解

variable_name: type

举例说明 

age: int = 30  # 变量age被注解为整数类型
name: str = "Alice"  # 变量name被注解为字符串类型
a = 1
type(a)  # <class 'int'>a: int = 1
type(a)  # <class 'int'>a: int = "你好"
type(a)  # <class 'str'>


 

【注】从上图可以看出,Python的类型标注,虽然指明了希望你赋值一个int类型但你仍然可以按照你自己的想法去改变赋值的数据类型。

(2)函数参数类型注解

在函数定义中,可以在参数名后跟一个冒号和类型,还可以用"->"箭来指定返回值类型。

 举例说明

def greeting(name: str) -> str:return 'hello ' + name

 


【注】从上图可以看出, 开发者可以通过类型标注确保函数接口的一致性,这样其他开发者在调用该函数时会清楚应该传递何种类型的参数,从而避免错误。

(3)函数带有关键字参数和默认值的情况

def calculate_area(radius: float = 1.0) -> float:return 3.14 * radius ** 2


 

(4)元组和列表类型注解

元组类型提示:variable_name: tuple[type1, type2, ...]

列表类型提示:variable_name: list[type]

元组或者列表类型后面用中括号表明所装元素的类型

 举例说明一

# 元组类型提示
coordinates: tuple[int, int] = (100, 50)# 列表类型提示
students: list[str] = ['小明', '小花', '小红']


 

举例说明二

def scale(scalar: float, vector: list[float]) -> list[float]:return [scalar * num for num in vector]new_vector = scale(2.0, [1.0, -4.2, 5.4])

 (5)字典类型注解

 variable_name: dict[key_type, value_type]

这里的 key_type 和 value_type 分别代表字典中键和值的预期数据类型。

举例说明 

# 字典类型注解的实例
person_info: dict[str, any] = {"name": "Alice","age": 30,"city": "New York"
}

 


 

【注】 中括号中第一个位置是key的类型,第二个位置是value的类型。可以用any来表明value可以是任意类型数据。

 (6)给类型取别名

类型别名是使用type语句来定义type Vector = list[float]

type语句是在 Python 3.12 中新增加的。 为了向下兼容,类型别名也可以通过简单的赋值来创建Vector = list[float]

举例说明

# type Vector = list[float]
Vector = list[float]def scale(scalar: float, vector: Vector) -> Vector:return [scalar * num for num in vector]new_vector = scale(2.0, [1.0, -4.2, 5.4])

 二、类型注解的好处

(1)提升代码可读性

        类型标注能够使阅读代码的人快速理解每个变量、函数参数和返回值的预期类型,这在大型项目或团队协作开发中尤为重要,有助于减少误解,提高代码的自文档化能力。

(2)提高代码的可用性和可靠性

        开发者可以通过类型标注确保函数接口的一致性,这样其他开发者在调用该函数时会清楚应该传递何种类型的参数。类型标注也可以作为API文档的一部分,指导用户正确地使用代码。

(3)静态类型检查与错误预防

        虽然Python是动态类型的语言,但在编写类型标注后可以配合静态类型检查工具(如mypy)进行类型检查。这些工具能够在编译阶段发现潜在的类型错误,从而提前修复,减少运行时由于类型错误引发的异常。

三、静态类型检查mypy的简单使用

(1)安装 

pip install mype

(2)使用

这里有一个叫做test.py的文件 

# 双向链表节点
class Node:def __init__(self, data: int, prev: "Node"):self.data = dataself.next = Noneself.prev = prev

 用mype test.py来执行静态类型检查,静态类型检查的意思是在没有运行程序的情况下检查出语法错误。检查变量是否被赋予了正确的数据类型,函数参数是否匹配其声明的类型,以及函数返回值是否符合预期类型。

mypy test.py

这篇关于【学习心得】Python的注解/Type Hints(简介)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/717140

相关文章

使用Python删除Excel中的行列和单元格示例详解

《使用Python删除Excel中的行列和单元格示例详解》在处理Excel数据时,删除不需要的行、列或单元格是一项常见且必要的操作,本文将使用Python脚本实现对Excel表格的高效自动化处理,感兴... 目录开发环境准备使用 python 删除 Excphpel 表格中的行删除特定行删除空白行删除含指定

Python通用唯一标识符模块uuid使用案例详解

《Python通用唯一标识符模块uuid使用案例详解》Pythonuuid模块用于生成128位全局唯一标识符,支持UUID1-5版本,适用于分布式系统、数据库主键等场景,需注意隐私、碰撞概率及存储优... 目录简介核心功能1. UUID版本2. UUID属性3. 命名空间使用场景1. 生成唯一标识符2. 数

Python办公自动化实战之打造智能邮件发送工具

《Python办公自动化实战之打造智能邮件发送工具》在数字化办公场景中,邮件自动化是提升工作效率的关键技能,本文将演示如何使用Python的smtplib和email库构建一个支持图文混排,多附件,多... 目录前言一、基础配置:搭建邮件发送框架1.1 邮箱服务准备1.2 核心库导入1.3 基础发送函数二、

Python包管理工具pip的升级指南

《Python包管理工具pip的升级指南》本文全面探讨Python包管理工具pip的升级策略,从基础升级方法到高级技巧,涵盖不同操作系统环境下的最佳实践,我们将深入分析pip的工作原理,介绍多种升级方... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

基于Python实现一个图片拆分工具

《基于Python实现一个图片拆分工具》这篇文章主要为大家详细介绍了如何基于Python实现一个图片拆分工具,可以根据需要的行数和列数进行拆分,感兴趣的小伙伴可以跟随小编一起学习一下... 简单介绍先自己选择输入的图片,默认是输出到项目文件夹中,可以自己选择其他的文件夹,选择需要拆分的行数和列数,可以通过

Python中反转字符串的常见方法小结

《Python中反转字符串的常见方法小结》在Python中,字符串对象没有内置的反转方法,然而,在实际开发中,我们经常会遇到需要反转字符串的场景,比如处理回文字符串、文本加密等,因此,掌握如何在Pyt... 目录python中反转字符串的方法技术背景实现步骤1. 使用切片2. 使用 reversed() 函

Python中将嵌套列表扁平化的多种实现方法

《Python中将嵌套列表扁平化的多种实现方法》在Python编程中,我们常常会遇到需要将嵌套列表(即列表中包含列表)转换为一个一维的扁平列表的需求,本文将给大家介绍了多种实现这一目标的方法,需要的朋... 目录python中将嵌套列表扁平化的方法技术背景实现步骤1. 使用嵌套列表推导式2. 使用itert

使用Docker构建Python Flask程序的详细教程

《使用Docker构建PythonFlask程序的详细教程》在当今的软件开发领域,容器化技术正变得越来越流行,而Docker无疑是其中的佼佼者,本文我们就来聊聊如何使用Docker构建一个简单的Py... 目录引言一、准备工作二、创建 Flask 应用程序三、创建 dockerfile四、构建 Docker

Python使用vllm处理多模态数据的预处理技巧

《Python使用vllm处理多模态数据的预处理技巧》本文深入探讨了在Python环境下使用vLLM处理多模态数据的预处理技巧,我们将从基础概念出发,详细讲解文本、图像、音频等多模态数据的预处理方法,... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

Python使用pip工具实现包自动更新的多种方法

《Python使用pip工具实现包自动更新的多种方法》本文深入探讨了使用Python的pip工具实现包自动更新的各种方法和技术,我们将从基础概念开始,逐步介绍手动更新方法、自动化脚本编写、结合CI/C... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核