CKTIS / Python
collections.namedtuple
Erzeugt eine Unterklasse von tuple mit Zugriff auf Felder nach Namen oder Position.
Version: Python 3.14; repository image, production runtime not attested
Syntax
collections.namedtuple(typename, field_names, *, rename=False, defaults=None, module=None)Erzeugt eine Unterklasse von tuple mit Zugriff auf Felder nach Namen oder Position.
Instanzen lassen sich mit Positions- oder Schlüsselwortargumenten erzeugen. Vorgabewerte gelten für die letzten Felder. rename=True ersetzt ungültige oder doppelte Namen durch positionsbezogene Namen.
Im Beispiel liefern p.x und p[1] die Koordinaten und _replace erzeugt einen neuen Punkt, während p erhalten bleibt.
from collections import namedtuple
Event = namedtuple("Event", ["kind", "count"], defaults=[1])
ev = Event("click")
assert tuple(ev) == ("click", 1) and ev.count == 1
assert ev._replace(count=2).count == 2 and ev.count == 1
assert namedtuple("T", ["x", "x"], rename=True)._fields == ("x", "_1")
Beispiele
import collections
Point = collections.namedtuple("Point", "x y")
p = Point(2, 5)
print(p.x, p[1])
print(p._replace(x=9), p)
Ergebnis
2 5 Point(x=9, y=5) Point(x=2, y=5)
Im Beispiel liefern p.x und p[1] die Koordinaten und _replace erzeugt einen neuen Punkt, während p erhalten bleibt.