[Python-checkins] CVS: python/dist/src/Doc/lib libstruct.tex,1.30,1.31

Tim Peters tim_one@users.sourceforge.net
Sat, 15 Sep 2001 11:09:24 -0700


Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv1297/python/Doc/lib

Modified Files:
	libstruct.tex 
Log Message:
SF bug [#461674] struct 'p' format doesn't work (maybe)
Rewrote the 'p' description.


Index: libstruct.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libstruct.tex,v
retrieving revision 1.30
retrieving revision 1.31
diff -C2 -d -r1.30 -r1.31
*** libstruct.tex	2001/07/06 20:30:11	1.30
--- libstruct.tex	2001/09/15 18:09:22	1.31
***************
*** 95,105 ****
  string (while \code{'0c'} means 0 characters).
  
! The \character{p} format character can be used to encode a Pascal
! string.  The first byte is the length of the stored string, with the
! bytes of the string following.  If count is given, it is used as the
! total number of bytes used, including the length byte.  If the string
! passed in to \function{pack()} is too long, the stored representation
! is truncated.  If the string is too short, padding is used to ensure
! that exactly enough bytes are used to satisfy the count.
  
  For the \character{I}, \character{L}, \character{q} and \character{Q}
--- 95,109 ----
  string (while \code{'0c'} means 0 characters).
  
! The \character{p} format character encodes a "Pascal string", meaning
! a short variable-length string stored in a fixed number of bytes.
! The count is the total number of bytes stored.  The first byte stored is
! the length of the string, or 255, whichever is smaller.  The bytes
! of the string follow.  If the string passed in to \function{pack()} is too
! long (longer than the count minus 1), only the leading count-1 bytes of the
! string are stored,  If the string is shorter than count-1, it is padded
! with null bytes so that exactly count bytes in all are used.  Note that
! for \function{unpack()}, the \character{p} format character consumes count
! bytes, but that the string returned can never contain more than 255
! characters.
  
  For the \character{I}, \character{L}, \character{q} and \character{Q}