uncompress a string or byte sequence - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Names and Strings : StringTools Package : Miscellaneous Utilities : StringTools/Uncompress

StringTools[Uncompress] - uncompress a string or byte sequence

Calling Sequence

Uncompress(S)

Uncompress(S, n)

Uncompress(S, output=f)

Parameters

S

-

string, Array(datatype=integer[1]), or list(integer)

n

-

(optional) positive integer number of bytes

f

-

(optional) output format: string, rtable, or list

Description

• 

The Uncompress(S) command takes the given string, byte list, or integer[1] array and decompresses it back into its original expanded format.

• 

By default the return value is an Array with datatype=integer[1].  The values in the array range from -128 to 127 as integer[1] is a signed integer format.  

• 

When output=list is specified the return value is a list of integers in the range 0 to 256.  

• 

When output=string is specified the return value is a character string.  This option should only be used when the original uncompressed form was a string.  Converting binary data to this format will be truncated if the data contains NULL bytes.

• 

Both the array output format and the list output format are suitable for use with readbytes and writebytes.

• 

The optional value n indicates that only the first n bytes should be uncompressed.  If n is unspecified, or if n <= 0 or if n exceeds the actual number of bytes, then all of S is uncompressed.

• 

The decompression algorithm is taken from the zlib library written by Jean-loup Gailly and Mark Adler.  See http://zlib.net

Examples

withStringTools&colon;

r:=Compresshello world

r:= 1 .. 20 ArrayData Type: integer1Storage: rectangularOrder: Fortran_order

(1)

Uncompressr&comma;&apos;output&apos;&equals;&apos;string&apos;

hello world

(2)

See Also

Compress,, copyright, readbytes, rtable, StringTools, writebytes


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam