APL Wiki|
Size: 3961
Comment:
|
Size: 1595
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = WinZip = `WinZip` is part of the CategoryAplTree project. <<TableOfContents>> == Warning == Note that WinZip issues an error when you pass something like this with the flag to preserve the directory structure: {{{ C:\My\folder1\file.txt C:\My\folder2\file.txt }}} According to the company behind !WinZip this is nit a bug but by design. Therefore `WinZip` will issue a DOMAIN ERROR if you have to files with the same name in your list of files to be zipped. |
|
| Line 3: | Line 19: |
| INI files are still useful to provide settings to an application. Vista is not going to change this. The Windows API methods provided to read a particular value have an advantage: they follow a clearly defined search path, and following that path they take not only the INI file into account, they also check the Windows registry and the command line parameter. Furthermore, they deliver always up-to-date values. |
The class "WinZip" relies on an installed version of [[http://winzip.com/win/en/index.htm |WinZip]] '''and''' the command line extension. If both are installed on your machine then will will have the two executables `WZZIP.EXE` (for zipping) and `WZUNZIP.EXE` (for unzipping) somewhere, typically in C:\Program Files (x86)\WinZip. |
| Line 6: | Line 21: |
| They have disadvantages as well: * They are slow * They return everything as a string If you are not interested in the Windows registry and command line parameters, and if nobody else is changing your INI files while your application is running, then the "!IniFile" class introduced in this article might attract your attention. This class allows you to use a kind of APL-Syntax in your INI files. Values not enclosed in quotes will be converted to numbers, everything else gets a string. == Details == An entry like: {{{HomeFolder='C:/Windows/Appl/'}}} results in a string holding the path, but an entry like: {{{FormSize=300 400}}} results in a two-element-vector "!FormSize" holding two integers. Furthermore, an entry like: {{{LogFolder='{"HomeFolder}Logsfiles/'}}} is treated in a special way: the name between the curlies is taken as the name of an already defined value. It is then replaced by the value of that entry. After creating an instance from the class: {{{MyIni←⎕New #.IniClass (,⊂'C:/Appl/Example.ini')}}} you can get all information you are interested in by calling the only method "Get". Given this file "Example.ini": {{{ [GENERAL] MaxNoOfErrors=20 FormSize=800 1200 LogfileFlag=1 LogLevels=1 2 3 ; from 1 to 9 [DIR] Home='C:/mainfolder/' AppFolder='{Home}appls/' DocsFolder='{Home}docs/' LogFileFolder='{Home}Logs/' }}} You can get any level of information you are interested in: * get everything * get only a particular section * get a particular value in a particular section |
The class makes it very easy to zip as well as unzip stuff. |
| Line 60: | Line 25: |
| Zip all files in C:\!MyFolder\ recursively into myZipFile.zip: | |
| Line 61: | Line 27: |
| MyIni.Get ⍬ ⍬ GENERAL MAXNOOFERRORS 20 FORMSIZE 800 1200 LOGFILEFLAG 1 LOGLEVELS 1 2 3 DIR HOME C:/mainfolder/ APPFOLDER C:/mainfolder/appls/ DOCSFOLDER C:/mainfolder/docs/ LOGFILEFOLDER C:/mainfolder/Logs/ MyIni.Get'General' ⍬ MAXNOOFERRORS 20 FORMSIZE 800 1200 LOGFILEFLAG 1 LOGLEVELS 1 2 3 MyIni.Get'General' 'FormSize' 800 1200 ¯1 MyIni.Get'General' 'Unknown' ⍝ with default ¯1 MyIni.Get'General' 'Unknown' ⍝ without default Value Error: "Unknown" myDoc.Get'General' 'Unknown' |
(rc more)←#.WinZip.Create 'C:\MyFolder\*' 'myZipFile.zip' |
| Line 86: | Line 30: |
| Since version 1.1, the class provides a default property. That means you can access values by indexing. | Zip two files nto myZipFile.zip: {{{ (rc more)←#.WinZip.Create ('C:\file1' 'C:\file2') 'C:\MyZipFile' }}} |
| Line 88: | Line 35: |
| Examples (with the same INI file listed above): | Unpack C:\!MyZip.zip into C:\!MyUnzippedFiles\: |
| Line 91: | Line 38: |
| MyIni[⊂'GeneRAL:'] 20 800 1200 1 1 2 3 ⊃MyIni[⊂'GeneRAL:FormSize'] 800 1200 |
(rc more)←#.WinZip.Extract 'C:\MyZip.zip' 'C:\MyUnzippedFiles\' |
| Line 97: | Line 41: |
| You can also change a particular value. However, that value will persist only if you execute the "Save" method at some point: | |
| Line 99: | Line 42: |
| {{{ MyIni[⊂'GeneRAL:FormSize']←⊂'¯1 1000 MyIni.Save }}} |
== Project Page == |
| Line 104: | Line 44: |
| Note that using indexing, there is no default. That means that specifying an unknown value leads to an error. There are two ways to escape this problem: | For bug reports, future enhancements and a full version history see WinZip/ProjectPage |
| Line 106: | Line 46: |
| {{{ MyIni.Exist 'General:Unknown' 0 MyIni.Default← ¯1 ¯1 MyIni[⊂'General:Unknown'] ¯1 ¯1 MyIni[⊂'General:Unknown']←200 MyIni[⊂'General:Unknown'] 200 }}} |
== Version Information == ||Original author: ||KaiJaeger || ||Responsible: ||KaiJaeger || ||Email: || kai@aplteam.com || |
| Line 117: | Line 51: |
| ||Original author:||KaiJaeger|| ||Responsible:||KaiJaeger|| ||Email:||kai@aplteam.com|| ||Current state:||1.1|| Goto the IniFileDownloadPage |
<<Include(APLTreeDownloads)>> |
| Line 125: | Line 54: |
| CategoryOpenSourceApl CategoryAplAplDyalog | CategoryAplTree |
WinZip
WinZip is part of the CategoryAplTree project.
Warning
Note that WinZip issues an error when you pass something like this with the flag to preserve the directory structure:
C:\My\folder1\file.txt C:\My\folder2\file.txt
According to the company behind WinZip this is nit a bug but by design. Therefore WinZip will issue a DOMAIN ERROR if you have to files with the same name in your list of files to be zipped.
Overview
The class "WinZip" relies on an installed version of WinZip and the command line extension. If both are installed on your machine then will will have the two executables WZZIP.EXE (for zipping) and WZUNZIP.EXE (for unzipping) somewhere, typically in C:\Program Files (x86)\WinZip.
The class makes it very easy to zip as well as unzip stuff.
Examples
Zip all files in C:\MyFolder\ recursively into myZipFile.zip:
(rc more)←#.WinZip.Create 'C:\MyFolder\*' 'myZipFile.zip'
Zip two files nto myZipFile.zip:
(rc more)←#.WinZip.Create ('C:\file1' 'C:\file2') 'C:\MyZipFile'Unpack C:\MyZip.zip into C:\MyUnzippedFiles\:
(rc more)←#.WinZip.Extract 'C:\MyZip.zip' 'C:\MyUnzippedFiles\'
Project Page
For bug reports, future enhancements and a full version history see WinZip/ProjectPage
Version Information
Original author: |
|
Responsible: |
|
Email: |