Differences between revisions 7 and 58 (spanning 51 versions)
Revision 7 as of 2007-12-16 22:46:33
Size: 3961
Editor: KaiJaeger
Comment:
Revision 58 as of 2011-08-31 20:55:41
Size: 1006
Editor: KaiJaeger
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= SevenZip =
{{{SevenZip}}} is part of the CategoryAplTree project.

<<TableOfContents>>
Line 2: Line 7:
The class "SevenZip" relies on an installed version of the Open Source zipper [[http://www.7-zip.org/ | 7zip]].
Line 3: Line 9:
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 makes it very easy to zip as well as unzip stuff.
Line 6: Line 11:
They have disadvantages as well: "SevenZip" suppports the following formats:
 * 7z
 * split
 * zip
 * gzip
 * bzip2
 * tar
Line 8: Line 19:
 * They are slow
 * They return everything as a string
You can either specify an appropriate extension or set the "type" property in order to enforce a certain format.
Line 11: Line 21:
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":
Line 39: Line 22:
[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/'
      myZipper←⎕new #.SevenZip (,⊂'MyZipFile')
      ⎕←myZipper
[SevenZip@MyZipFile]
      myZipper.Add 'foo.txt'
      ⎕←myZipper.List 0
foo.txt
myZipper.Unzip 'c:\output\'
Line 52: Line 31:
You can get any level of information you are interested in: == Project Page ==
Line 54: Line 33:
 * get everything
 * get only a particular section
 * get a particular value in a particular section
For bug reports, future enhancements and a full version history see SevenZip/ProjectPage
Line 58: Line 35:
== Examples == == Version Information ==
||Original author: ||KaiJaeger ||
||Responsible: ||KaiJaeger ||
||Email: || kai@aplteam.com ||
Line 60: Line 40:
{{{
      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'
}}}

Since version 1.1, the class provides a default property. That means you can access values by indexing.

Examples (with the same INI file listed above):

{{{
      MyIni[⊂'GeneRAL:']
20 800 1200 1 1 2 3
            ⊃MyIni[⊂'GeneRAL:FormSize']
800 1200
}}}

You can also change a particular value. However, that value will persist only if you execute the "Save" method at some point:

{{{
      MyIni[⊂'GeneRAL:FormSize']←⊂'¯1 1000
      MyIni.Save
}}}

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:

{{{
      MyIni.Exist 'General:Unknown'
0
      MyIni.Default← ¯1 ¯1
      MyIni[⊂'General:Unknown']
¯1 ¯1
      MyIni[⊂'General:Unknown']←200
      MyIni[⊂'General:Unknown']
200
}}}

||Original author:||KaiJaeger||
||Responsible:||KaiJaeger||
||Email:||kai@aplteam.com||
||Current state:||1.1||

Goto the IniFileDownloadPage
<<Include(APLTreeDownloads)>>
Line 125: Line 43:
CategoryOpenSourceApl CategoryAplAplDyalog CategoryAplTree

SevenZip

SevenZip is part of the CategoryAplTree project.

Overview

The class "SevenZip" relies on an installed version of the Open Source zipper 7zip.

The class makes it very easy to zip as well as unzip stuff.

"SevenZip" suppports the following formats:

  • 7z
  • split
  • zip
  • gzip
  • bzip2
  • tar

You can either specify an appropriate extension or set the "type" property in order to enforce a certain format.

      myZipper←⎕new #.SevenZip (,⊂'MyZipFile')
      ⎕←myZipper
[SevenZip@MyZipFile]
      myZipper.Add 'foo.txt'
      ⎕←myZipper.List 0
foo.txt
myZipper.Unzip 'c:\output\'

Project Page

For bug reports, future enhancements and a full version history see SevenZip/ProjectPage

Version Information

Original author:

KaiJaeger

Responsible:

KaiJaeger

Email:

kai@aplteam.com


CategoryAplTree

SevenZip (last edited 2018-03-03 11:38:43 by KaiJaeger)