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, n)

Uncompress(S, output=f)




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



(optional) positive integer number of bytes



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



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



r:=Compresshello world

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



hello world


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