$GunZip: Difference between revisions
mNo edit summary |
(Automatically generated page update) |
||
| (31 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:$GunZip}} | {{DISPLAYTITLE:$GunZip}} | ||
<span class="pageSubtitle" | <span class="pageSubtitle">Decompress a longstring with GUNZIP</span> | ||
<p class=" | <p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $GunZip function is <var>[[Gunzip (String function)|Gunzip]]</var>.</p> | ||
This function extracts information from a GZIP-format longstring. | This function extracts information from a GZIP-format longstring. | ||
The $GunZip function accepts two arguments and returns a longstring result. | The $GunZip function accepts two arguments and returns a longstring result. | ||
==Syntax== | ==Syntax== | ||
<p class="syntax">< | <p class="syntax"><span class="term">%lstrc</span> = <span class="literal">$GunZip</span>(%lstr, type) | ||
</p> | |||
<p | <p> | ||
</p> | </p> | ||
<p | <p>%lstrc is the returned longstring.</p> | ||
The first argument, the longstring to be decompressed, is required. The string must be in GZIP format. | The first argument, the longstring to be decompressed, is required. The string must be in GZIP format. | ||
| Line 40: | Line 41: | ||
In the following example, | In the following example, | ||
<tt> | <tt>%ls</tt> is set to the uncompressed version of the given string The <tt>DATA</tt> value default is implied, since no second argument is given. | ||
<p class="code"> %ls = $GunZip(%lsgz) | <p class="code"> %ls = $GunZip(%lsgz) | ||
| Line 53: | Line 54: | ||
''Note: GZIP-format files can be created with the function [[$GZip]] as well as other file compression utilities.'' | ''Note: GZIP-format files can be created with the function [[$GZip]] as well as other file compression utilities.'' | ||
==Products authorizing {{PAGENAMEE}}== | |||
<ul class="smallAndTightList"> | <ul class="smallAndTightList"> | ||
<li>[[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>[[Janus Open Client]]</li> | <li>[[Media:JoclrNew.pdf|Janus Open Client]]</li> | ||
<li>[[Janus Open Server]]</li> | <li>[[Media:JosrvrNew.pdf|Janus Open Server]]</li> | ||
<li>[[Janus Sockets]]</li> | <li>[[Janus Sockets]]</li> | ||
<li>[[Janus Web Server]]</li> | <li>[[Janus Web Server]]</li> | ||
<li> | <li>Japanese functions</li> | ||
<li>[[Sir2000 Field Migration Facility]]</li> | <li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]]</li> | ||
</ul> | </ul> | ||
<p | <p> | ||
</p> | </p> | ||
[[Category:$Functions|$GunZip]] | [[Category:$Functions|$GunZip]] | ||
Latest revision as of 22:51, 20 September 2018
Decompress a longstring with GUNZIP
Note: Many $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
- Sirius functions
- Fast/Unload User Language Interface
- Janus Open Client
- Janus Open Server
- Janus Sockets
- Janus Web Server
- Japanese functions
- Sir2000 Field Migration Facility