Display the source code in std/zip.d from which this page was generated on github.

If you spot a problem with this page, click here to create a Bugzilla issue.

Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Module `std.zip`

Read/write data in the zip archive format. Makes use of the etc.c.zlib compression library.

Bugs

Multi-disk zips not supported.
Only Zip version 20 formats are supported.
Only supports compression modes 0 (no compression) and 8 (deflate).
Does not support encryption.
Bugzilla 592
Bugzilla 2137

Example

// Read existing zip file.
import std.digest.crc, std.file, std.stdio, std.zip;

void main(string[] args)
{
    // read a zip file into memory
    auto zip = new ZipArchive(read(args[1]));
    writeln("Archive: ", args[1]);
    writefln("%-10s  %-8s  Name", "Length", "CRC-32");
    // iterate over all zip members
    foreach (name, am; zip.directory)
    {
        // print some data about each member
        writefln("%10s  %08x  %s", am.expandedSize, am.crc32, name);
        assert(am.expandedData.length == 0);
        // decompress the archive member
        zip.expand(am);
        assert(am.expandedData.length == am.expandedSize);
    }
}

// Create and write new zip file.
import std.file : write;
import std.string : representation;

void main()
{
    char[] data = "Test data.\n".dup;
    // Create an ArchiveMember for the test file.
    ArchiveMember am = new ArchiveMember();
    am.name = "test.txt";
    am.expandedData(data.representation);
    // Create an archive and add the member.
    ZipArchive zip = new ZipArchive();
    zip.addMember(am);
    // Build the archive
    void[] compressed_data = zip.build();
    // Write to a file
    write("test.zip", compressed_data);
}

Classes

Name	Description
`ArchiveMember`	A member of the ZipArchive.
`ZipArchive`	Object representing the entire archive. ZipArchives are collections of ArchiveMembers.
`ZipException`	Thrown on error.

Enums

Name	Description
`CompressionMethod`	Compression method used by ArchiveMember

Authors

Walter Bright

License

Boost License 1.0.