Imported Upstream version 2.2.2upstream/2.2.2

1 files changed, 103 insertions, 0 deletions

diff --git a/zipio.h b/zipio.h
new file mode 100644
index 0000000..1b6557b
--- /dev/null
+++ b/zipio.h
@@ -0,0 +1,103 @@
+/*
+ * zipio.h - stdio emulation library for reading zip files
+ *
+ * Version 1.1.1
+ */
+
+/*
+ * Copyright (c) 1995, Edward B. Hamrick
+ *
+ * Permission to use, copy, modify, distribute, and sell this software and
+ * its documentation for any purpose is hereby granted without fee, provided
+ * that
+ *
+ * (i)  the above copyright notice and the text in this "C" comment block
+ *      appear in all copies of the software and related documentation, and
+ *
+ * (ii) any modifications to this source file must be sent, via e-mail
+ *      to the copyright owner (currently hamrick@primenet.com) within 
+ *      30 days of such modification.
+ *
+ * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
+ * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
+ *
+ * IN NO EVENT SHALL EDWARD B. HAMRICK BE LIABLE FOR ANY SPECIAL, INCIDENTAL,
+ * INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER
+ * RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF
+ * THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ */
+
+/*
+ * Changes from 1.1 to 1.1.1:
+ * Changed "z*" functions to "Z*" to avoid namespace pollution.
+ * Added "zungetc" macro.
+ * John Cowan <cowan@ccil.org>
+ */
+
+/*
+ * This library of routines has the same calling sequence as
+ * the stdio.h routines for reading files.  If these routines
+ * detect that they are reading from a zip file, they transparently
+ * unzip the file and make the application think they're reading
+ * from the uncompressed file.
+ *
+ * Note that this library is designed to work for zip files that
+ * use the deflate compression method, and to read the first file
+ * within the zip archive.
+ *
+ * There are a number of tunable parameters in the reference
+ * implementation relating to in-memory decompression and the
+ * use of temporary files.
+ *
+ * Particular care was taken to make the Zgetc() macro work
+ * as efficiently as possible.  When reading an uncompressed
+ * file with Zgetc(), it has exactly the same performance as
+ * when using getc().  WHen reading a compressed file with
+ * Zgetc(), it has the same performance as fread().  The total
+ * CPU overhead for decompression is about 50 cycles per byte.
+ *
+ * The Zungetc() macro is quite limited.  It ignores the character
+ * specified for pushback, and essentially just forces the last
+ * character read to be re-read.  This is essential when parsing
+ * numbers and such.  (1.1.1)
+ *
+ * There are a few stdio routines that aren't represented here, but
+ * they can be layered on top of these routines if needed.
+ */
+
+#ifndef __ZIPIO_H
+#define __ZIPIO_H
+
+#include <stdio.h>
+
+typedef struct {
+  int            len;
+  unsigned char *ptr;
+} ZFILE;
+
+#define Zgetc(f)                   \
+  ((--((f)->len) >= 0)             \
+    ? (unsigned char)(*(f)->ptr++) \
+    : _Zgetc (f))
+
+#define Zungetc(c,f) \
+  ((f)->ptr--, (f)->len++, (c))
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+ZFILE  *Zopen(const char *path, const char *mode);
+int    _Zgetc(ZFILE *stream);
+size_t  Zread(void *ptr, size_t size, size_t n, ZFILE *stream);
+int     Zseek(ZFILE *stream, long offset, int whence);
+long    Ztell(ZFILE *stream);
+int     Zclose(ZFILE *stream);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif