traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

[doc] struct: update note about network byte order form to be more helpful (GH-22201) 

Update the sentence to provide some context on why network byte order is defined as big endian.
This commit is contained in:
Stargirl Flowers 2020-09-11 08:20:12 -07:00 committed by GitHub
parent 3304cbd990
commit fb27187203
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Doc/library/struct.rst
View File

@ -159,8 +159,8 @@ the :ref:`format-characters` section.
Note the difference between ``'@'`` and ``'='``: both use native byte order, but Note the difference between ``'@'`` and ``'='``: both use native byte order, but
the size and alignment of the latter is standardized. the size and alignment of the latter is standardized.
The form ``'!'`` is available for those poor souls who claim they can't remember The form ``'!'`` represents the network byte order which is always big-endian
whether network byte order is big-endian or little-endian. as defined in `IETF RFC 1700 <IETF RFC 1700_>`_.
There is no way to indicate non-native byte order (force byte-swapping); use the There is no way to indicate non-native byte order (force byte-swapping); use the
appropriate choice of ``'<'`` or ``'>'``. appropriate choice of ``'<'`` or ``'>'``.
@ -467,3 +467,5 @@ The :mod:`struct` module also defines the following type:
.. _half precision format: https://en.wikipedia.org/wiki/Half-precision_floating-point_format .. _half precision format: https://en.wikipedia.org/wiki/Half-precision_floating-point_format
.. _ieee 754 standard: https://en.wikipedia.org/wiki/IEEE_floating_point#IEEE_754-2008 .. _ieee 754 standard: https://en.wikipedia.org/wiki/IEEE_floating_point#IEEE_754-2008
.. _IETF RFC 1700: https://tools.ietf.org/html/rfc1700