$GunZip: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
(Automatically generated page update)
Line 58: Line 58:
<li>[[List of $functions|Sirius functions]]</li>
<li>[[List of $functions|Sirius functions]]</li>
<li>[[Fast/Unload User Language Interface]]</li>
<li>[[Fast/Unload User Language Interface]]</li>
<li>[[Media:JoclrNew.pdf|Janus Open Client]</li>
<li>[[Media:JoclrNew.pdf|Janus Open Client]]</li>
<li>[http://m204wiki.rocketsoftware.com/images/1/17/JosrvrNew.pdf Janus Open Server]</li>
<li>[http://m204wiki.rocketsoftware.com/images/1/17/JosrvrNew.pdf Janus Open Server]</li>
<li>[[Janus Sockets]]</li>
<li>[[Janus Sockets]]</li>

Revision as of 21:20, 19 February 2015

Decompress a longstring with GUNZIP

Note: Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $GunZip function is Gunzip.

This function extracts information from a GZIP-format longstring.

The $GunZip function accepts two arguments and returns a longstring result.

Syntax

%lstrc = $GunZip(%lstr, type)

%lstrc is the returned longstring.

The first argument, the longstring to be decompressed, is required. The string must be in GZIP format.

The second argument is a string indicating what information should be extracted from the GZIP-format longstring. This argument is optional; if it is not specified, DATA is assumed, and the longstring is decompressed into the result longstring. Valid options and their meanings are:

Options

DATA Indicates that the data in the GZIP longstring is extracted. This is the default.
TIME Indicates that the date and time, known as the "modification time," is returned (in the form YYYY-MM-DD HH:MI:SS).
NAME Indicates that the internal name of the GZIP entity is returned in the result. If no internal name is present, the null string is returned.

Usage notes

  • If an invalid option is passed, or if compression is not enabled for the current run, the request is cancelled.
  • The NCMPBUF parameter must be set by User 0 before the $GZip function can be used. If $GunZip is called with NCMPBUF = 0, the request is cancelled.

Examples

In the following example, %ls is set to the uncompressed version of the given string The DATA value default is implied, since no second argument is given.

%ls = $GunZip(%lsgz)

In the following example,

%dt is set to the last modification date and time of the file contained in the GZIP longstring.

%dt = $GunZip(%lsgz, 'TIME')

Note: GZIP-format files can be created with the function $GZip as well as other file compression utilities.

Products authorizing $GunZip