summaryrefslogtreecommitdiffstats
path: root/Lib/struct.py
diff options
context:
space:
mode:
authorChristian Heimes <christian@cheimes.de>2008-01-04 03:08:33 (GMT)
committerChristian Heimes <christian@cheimes.de>2008-01-04 03:08:33 (GMT)
commit3f419afac56065233fd9a69db3b5e2d4c6113648 (patch)
treeb133e159a1900497b779e3b8505858578887c6a3 /Lib/struct.py
parenta34706f101a16eef8e36054d1f405f794d53ac79 (diff)
downloadcpython-3f419afac56065233fd9a69db3b5e2d4c6113648.zip
cpython-3f419afac56065233fd9a69db3b5e2d4c6113648.tar.gz
cpython-3f419afac56065233fd9a69db3b5e2d4c6113648.tar.bz2
Merged revisions 59696-59702 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk ........ r59696 | amaury.forgeotdarc | 2008-01-04 03:04:15 +0100 (Fri, 04 Jan 2008) | 11 lines Partial port of r59682 from py3k. On Windows, when import fails to load a dll module, the message says "error code 193" instead of a more informative text. It turns out that FormatMessage needs additional parameters for some error codes. For example: 193 means "%1 is not a valid Win32 application". Since it is impossible to know which parameter to pass, we use FORMAT_MESSAGE_IGNORE_INSERTS to get the raw message, which is still better than the number. ........ r59698 | andrew.kuchling | 2008-01-04 03:26:00 +0100 (Fri, 04 Jan 2008) | 1 line Typo fix ........ r59699 | andrew.kuchling | 2008-01-04 03:31:40 +0100 (Fri, 04 Jan 2008) | 1 line Add math items; other edits ........ r59700 | christian.heimes | 2008-01-04 03:46:19 +0100 (Fri, 04 Jan 2008) | 1 line Fixed refleak tests for _struct changes ........ r59701 | christian.heimes | 2008-01-04 03:54:42 +0100 (Fri, 04 Jan 2008) | 1 line Added _struct._clearcache() for regression tests ........
Diffstat (limited to 'Lib/struct.py')
-rw-r--r--Lib/struct.py111
1 files changed, 2 insertions, 109 deletions
diff --git a/Lib/struct.py b/Lib/struct.py
index 45f6729..3784c05 100644
--- a/Lib/struct.py
+++ b/Lib/struct.py
@@ -1,109 +1,2 @@
-"""
-Functions to convert between Python values and C structs.
-Python strings are used to hold the data representing the C struct
-and also as format strings to describe the layout of data in the C struct.
-
-The optional first format char indicates byte order, size and alignment:
- @: native order, size & alignment (default)
- =: native order, std. size & alignment
- <: little-endian, std. size & alignment
- >: big-endian, std. size & alignment
- !: same as >
-
-The remaining chars indicate types of args and must match exactly;
-these can be preceded by a decimal repeat count:
- x: pad byte (no data); c:char; b:signed byte; B:unsigned byte;
- h:short; H:unsigned short; i:int; I:unsigned int;
- l:long; L:unsigned long; f:float; d:double.
-Special cases (preceding decimal count indicates length):
- s:string (array of char); p: pascal string (with count byte).
-Special case (only available in native format):
- P:an integer type that is wide enough to hold a pointer.
-Special case (not in native mode unless 'long long' in platform C):
- q:long long; Q:unsigned long long
-Whitespace between formats is ignored.
-
-The variable struct.error is an exception raised on errors.
-"""
-
-__version__ = '3.0'
-
-
-from _struct import Struct as _Struct, error
-
-class Struct(_Struct):
- def __init__(self, fmt):
- if isinstance(fmt, str):
- fmt = bytes(fmt, 'ascii')
- elif isinstance(fmt, buffer):
- fmt = bytes(fmt)
- _Struct.__init__(self, fmt)
-
-_MAXCACHE = 100
-_cache = {}
-
-def _compile(fmt):
- # Internal: compile struct pattern
- if len(_cache) >= _MAXCACHE:
- _cache.clear()
- s = Struct(fmt)
- _cache[fmt] = s
- return s
-
-def calcsize(fmt):
- """
- Return size of C struct described by format string fmt.
- See struct.__doc__ for more on format strings.
- """
- try:
- o = _cache[fmt]
- except KeyError:
- o = _compile(fmt)
- return o.size
-
-def pack(fmt, *args):
- """
- Return string containing values v1, v2, ... packed according to fmt.
- See struct.__doc__ for more on format strings.
- """
- try:
- o = _cache[fmt]
- except KeyError:
- o = _compile(fmt)
- return bytes(o.pack(*args))
-
-def pack_into(fmt, buf, offset, *args):
- """
- Pack the values v1, v2, ... according to fmt, write
- the packed bytes into the writable buffer buf starting at offset.
- See struct.__doc__ for more on format strings.
- """
- try:
- o = _cache[fmt]
- except KeyError:
- o = _compile(fmt)
- o.pack_into(buf, offset, *args)
-
-def unpack(fmt, s):
- """
- Unpack the string, containing packed C structure data, according
- to fmt. Requires len(string)==calcsize(fmt).
- See struct.__doc__ for more on format strings.
- """
- try:
- o = _cache[fmt]
- except KeyError:
- o = _compile(fmt)
- return o.unpack(s)
-
-def unpack_from(fmt, buf, offset=0):
- """
- Unpack the buffer, containing packed C structure data, according to
- fmt starting at offset. Requires len(buffer[offset:]) >= calcsize(fmt).
- See struct.__doc__ for more on format strings.
- """
- try:
- o = _cache[fmt]
- except KeyError:
- o = _compile(fmt)
- return o.unpack_from(buf, offset)
+from _struct import *
+from _struct import _clearcache