mozdev.org

• Sunday May 11th 2008
• Batteries not included.

Skip to Content

JSLib

Page Updated: September 29, 2004 Latest Version: 0.1.359

	Debug | Install | File I/O | RDF | Network | Sound | Utils | XUL | Zip
	Home | Mailing List | Install | Source Code | Downloads | Bugs | docs | clients

ZIP API

Function List

• Zip (aZipFile);
• Constructor - opens and initializes a zip file
• aZipFile - can be a string path, nsIFile, or jsLib File object
  
• extract (aDest, aDomEl);
• extracts an archive to target destination
• aDest - destination directory to extract to (if dest doesn't exist, it will be created)
• aDomEl - any DOM element with a value attribute such as a <label> or <textbox> (this arg is optional)
  
• open ();
• opens and initializes the zip file
• close ();
• closes the zip file if it is open
• aPattern - a string or wildcard to match
• findEntries (aPattern);
• returns a simple enumerator whose elements are of type nsIZipEntry
• getEntries (aPattern);
• returns an array string of entries that match aPattern
• aPattern - a string or wildcard to match
  
• getInputStream (aZipEntry);
• returns an nsIInputStream for an entry
• aZipEntry - an entry string
  
• readEntry (aZipEntry);
• returns a string contents of an entry
• aZipEntry - an entry string to read
  

Example

// using a unix local filepath string var d = "/tmp/ziptest"; var p = "/tmp/jslib.jar"; include (jslib_zip); var z = new Zip(p); // not really needed here since open is called internally in the class constructor z.open(); z.extract(d); z.close(); // this call to open is needed since close was called z.open(); // obtain an array list of all the entries in the archive var list = z.getEntries("*"); // print the number of entries returned in the array jslibPrint(list.length); // iterate through each entry for (var i=0;i<list.length;++i) jslibPrint(list[i]); z.close(); // now lets read the contens of a single entry from the archive z.open(); var contents = z.readEntry("samples/file.xul"); jslibPrint(contents); z.close();