mirror of
https://github.com/python/cpython.git
synced 2025-08-04 08:59:19 +00:00
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 ........
This commit is contained in:
parent
a34706f101
commit
3f419afac5
2 changed files with 46 additions and 112 deletions
111
Lib/struct.py
111
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
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue