Python类如何实现对索引访问的支持_通过__getitem__自定义切片行为

雨晨大大_7769

雨晨大大_7769

2026-06-02

637人浏览

原创

__getitem__ 能响应 [i] 和 [i:j] 是因为 python 解释器统一调用该方法并传入 int 或 slice 类型的 key;需在方法内用 isinstance 分支处理,切片时用 slice.indices(len(self)) 安全转换并返回同类实例。

python类如何实现对索引访问的支持_通过__getitem__自定义切片行为

为什么 __getitem__ 能响应 [i] 和 [i:j] 两种调用

Python 解释器在遇到 obj[key] 语法时,会直接尝试调用 obj.__getitem__(key),不管 key 是 int、slice 还是其他类型。这意味着你不用额外判断语法形式,只需在 __getitem__ 内区分参数类型即可。

常见错误是只处理整数索引,结果一用切片就报 TypeError: slice indices must be integers or None——其实是你没接住 slice 对象,反而把它传给了底层 list 或 array 的索引逻辑。

  • key 是 int:对应单个元素访问,如 obj[5]
  • key 是 slice:对应切片,如 obj[2:6]、obj[::2],其属性为 .start、.stop、.step
  • key 是其他类型(如 str、tuple):只要你的逻辑支持,也可以处理,比如实现字段名访问

如何安全地支持切片并返回同类实例

多数自定义容器希望切片后仍返回自身类型(比如 MyList[1:4] 返回 MyList,而非 list),这就需要你在 __getitem__ 中识别 slice 并手动构造新实例。

注意 slice.indices(len(self)) ——它能把任意 slice(含 None 或负数)转成明确的 (start, stop, step) 三元组,避免自己手写边界校验。

python-script-generator
python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构,支持CLI、API、爬虫、Bot、Django等多种项目类型,包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载
def __getitem__(self, key):
    if isinstance(key, slice):
        # 将 slice 映射到合法索引范围
        start, stop, step = key.indices(len(self))
        # 构造新实例,传入切片后的数据(假设内部用 list 存储)
        return self.__class__(self._data[start:stop:step])
    elif isinstance(key, int):
        # 处理负索引和越界
        if key <h3>
<code>__getitem__</code> 不处理赋值和删除,别和 <code>__setitem__</code>/<code>__delitem__</code> 混用</h3><p><code>__getitem__</code> 只负责读取,哪怕你返回了可变对象(比如内部列表),对返回值的修改也不会触发任何 magic method。用户写 <code>obj[0].append(x)</code> 是合法的,但这是在操作底层对象,不是你的类在“响应赋值”。</p><p>如果要支持 <code>obj[i] = x</code> 或 <code>del obj[i]</code>,必须单独实现 <code>__setitem__</code> 和 <code>__delitem__</code>,且它们的参数规则与 <code>__getitem__</code> 一致(同样要处理 <code>int</code> 和 <code>slice</code>)。</p>
  • 误以为实现了 __getitem__ 就能用 = 赋值 → 实际会抛 TypeError: 'MyClass' object does not support item assignment
  • 在 __getitem__ 里偷偷修改 self._data → 违反只读语义,容易引发隐蔽 bug
  • 对 slice 参数返回原 list 切片(如 self._data[key])→ 返回的是 list,不是你的类实例,链式调用断裂

性能与兼容性要注意的两个细节

切片行为是否支持步长(step ≠ 1)和空切片(start ≥ stop),直接影响下游库(如 NumPy、pandas)能否将你的类当容器使用。很多工具会试探性调用 obj[0:0:2] 来检测切片能力。

  • 不要在 __getitem__ 开头就 if key == slice(None): return self.copy() ——这漏掉了 obj[::2] 等非全量切片
  • 若内部数据结构不支持高效随机切片(比如链表),应尽早抛出 NotImplementedError,而不是默默降级为遍历生成,否则性能雪崩
  • Python 3.9+ 支持 typing.Self,返回类型注解可写 -> Self,但运行时不生效,仅辅助静态检查

最常被忽略的一点:slice.indices() 的长度参数必须是当前对象的逻辑长度(比如你重写了 __len__,就要用那个值),而不是内部存储的长度——否则负索引计算和越界判断都会错位。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1711

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4304

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1689

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

25137

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3067

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3087

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1163

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2403

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程