# UnzipOpenFile

Definition: | include builtins\LiteZip.e object hzip = UnzipOpenFile(string filename)
Description: | Opens an existing zip archive, for extraction. filename: the name of the archive to open Returns an atom handle or a string error message.
pwa/p2js: | Not supported.
Comments: | Call UnzipClose(hzip) once you have finished processing the archive. You can of course declare hzip as an atom if fail fast is your thing, which it is mine - in other words, a fatal type check error, and the corresponding ex.err file, usually works out far better for me than something akin to `puts(1,"oops"); abort(0)` ever could. Likewise I tend to store any `ZR_OK (=0)|string error` results in an integer and rely on the typecheck from that.
Example: | Copy
    include builtins\LiteZip.e

    atom hzip = UnzipOpenFile("phix.0.7.7.2.zip")
    ...
    UnzipClose(hzip)
See Also: | UnzipClose