Python中不会自动触发,因需显式实现__lshift__和__rshift__;若未实现或返回NotImplemented,则报TypeError;反向操作需__rlshift__和__rrshift__。

为什么 __lshift__ 和 __rshift__ 不会自动触发?
Python 中的位移运算符( 和 <code>>>)默认只对整数生效;对自定义类,必须显式实现 __lshift__ 和 __rshift__ 才能被调用。不实现就直接报 TypeError: unsupported operand type(s),而不是静默失败或退到 __getattr__。
常见错误是只实现了 __lshift__ 却没考虑左操作数不是当前类的情况——比如 5 会尝试调用 <code>obj.__rlshift__(注意是 __rlshift__,不是 __lshift__),否则回退到 int.__lshift__ 并失败。
- 左移
a → 先查 <code>a.__lshift__(b),若返回NotImplemented或未定义,则查b.__rlshift__(a) - 右移
a >> b→ 同理,先a.__rshift__(b),再b.__rrshift__(a) - 返回
NotImplemented是关键:它告诉 Python “我不处理,换别人”,否则直接抛异常
如何让 MyClass 做有意义的事?
典型场景是把位移当作“配置注入”或“流式构建”语法糖,比如 pipeline 表示输入数据,<code>logger 表示写日志。这时 <code>__lshift__ 应该返回实例本身(支持链式调用)或新实例(保持不可变)。
class Pipeline:
def __init__(self, steps=None):
self.steps = steps or []
<pre class="brush:php;toolbar:false;">def __lshift__(self, item):
# 支持 << 追加步骤或数据
if callable(item):
self.steps.append(item)
return self
else:
# 假设 item 是输入数据,执行整个 pipeline
result = item
for step in self.steps:
result = step(result)
return result
def __rlshift__(self, item):
# 处理 int << pipeline 这种反向调用(较少见,但需兼容)
return self.__lshift__(item)
立即学习“Python免费学习笔记(深入)”;
图片提示词生成器?不止如此。 马甲系统 —— 把脑海中的画面,翻译成AI能理解的专业表达。 用得越多,它越懂你:首次需要多问几句确认方向,用久了几乎一说就懂。 用得越多,它越快:缓存机制让后续对话越来越省。 RAG进化:成功案例持续入库,越跑越聪明。 输入「新手指南」查看完整功能介绍
注意:如果希望 __lshift__ 总是返回新对象(函数式风格),就别改 self,而是 return Pipeline(self.steps + [item])。
__rlshift__ 和 __rrshift__ 什么时候必须写?
只有当你的类可能作为右操作数出现时才需要——比如用户写 "hello" 或 <code>42 >> myobj。大多数情况下你控制调用方(如 myobj ),可以不实现反向方法;但如果库要通用(比如设计 DSL),就必须补全。
-
__rlshift__(self, other)对应other -
__rrshift__(self, other)对应other >> self - 这两个方法里,
self是你的类实例,other是左操作数,类型不确定,务必做类型检查或 duck typing - 如果无法处理
other类型,返回NotImplemented(不是raise TypeError)
性能和陷阱:位移运算符不是魔法,只是普通方法调用
重载 不会带来任何底层优化——它和调用 <code>obj.shift_left(n) 在性能上完全等价,只是语法更紧凑。滥用会导致可读性下降,尤其对不熟悉该类的人。
- 不要用
做跟位运算无关的事(比如启动服务、发 HTTP 请求),这违反直觉 - 如果类同时支持
+、、<code>|等多种运算符,确保语义一致(例如都表示“组合”或“追加”) - 在
__lshift__里做耗时操作(如 I/O、网络请求)会让a 看起来像纯数据操作,实际却阻塞,容易误导调用者
真正要注意的是:Python 3.8+ 没新增限制,但 __lshift__ 返回值类型不会影响类型检查器(如 mypy)推导,得靠类型注解手动补全。

















