Issue 2909: show how to name unpacked fields.

1 files changed, 10 insertions, 0 deletions

diff --git a/Doc/library/struct.rst b/Doc/library/struct.rst
index e2443aa395..63bf9b178e 100644
--- a/Doc/library/struct.rst
+++ b/Doc/library/struct.rst
@@ -233,6 +233,16 @@ end, assuming longs are aligned on 4-byte boundaries.  This only works when
 native size and alignment are in effect; standard size and alignment does not
 enforce any alignment.
 
+Unpacked fields can be named by assigning them to variables or by wrapping
+the result in a named tuple::
+
+    >>> record = 'raymond   \x32\x12\x08\x01\x08'
+    >>> name, serialnum, school, gradelevel = unpack('<10sHHb', record)
+
+    >>> from collections import namedtuple
+    >>> Student = namedtuple('Student', 'name serialnum school gradelevel')
+    >>> Student._make(unpack('<10sHHb', s))
+    Student(name='raymond   ', serialnum=4658, school=264, gradelevel=8)
 
 .. seealso::