Added support for setting recover option in mz_zip_reader before opening the file.

doc/mz_zip_rw.md

@@ -42,6 +42,7 @@ The _mz_zip_reader_ and _mz_zip_writer_ objects allows you to easily extract or
   - [mz_zip_reader_get_raw](#mz_zip_reader_get_raw)
   - [mz_zip_reader_get_zip_cd](#mz_zip_reader_get_zip_cd)
   - [mz_zip_reader_get_comment](#mz_zip_reader_get_comment)
+  - [mz_zip_reader_set_recover](#mz_zip_reader_set_recover)
   - [mz_zip_reader_set_encoding](#mz_zip_reader_set_encoding)
   - [mz_zip_reader_set_sign_required](#mz_zip_reader_set_sign_required)
   - [mz_zip_reader_set_overwrite_cb](#mz_zip_reader_set_overwrite_cb)
@@ -976,6 +977,26 @@ if (mz_zip_reader_get_comment(zip_reader, &global_comment) == MZ_OK) {
 }
 ```
 
+### mz_zip_reader_set_recover
+
+Sets the ability to recover the central dir by reading local file headers.
+
+**Arguments**
+|Type|Name|Description|
+|-|-|-|
+|void *|handle|_mz_zip_reader_ instance|
+|uint8_t|recover|Set to 1 if recover method is supported, 0 otherwise.|
+
+**Return**
+|Type|Description|
+|-|-|
+|void|No return|
+
+**Example**
+```
+mz_zip_reader_set_recover(zip_reader, 1);
+```
+
 ### mz_zip_reader_set_encoding
 
 Sets whether or not it should support a special character encoding in zip file names.

mz_zip.h

@@ -74,19 +74,19 @@ int32_t mz_zip_get_comment(void *handle, const char **comment);
 /* Get a pointer to the global comment */
 
 int32_t mz_zip_set_comment(void *handle, const char *comment);
-/* Set the global comment used for writing zip file */
+/* Sets the global comment used for writing zip file */
 
 int32_t mz_zip_get_version_madeby(void *handle, uint16_t *version_madeby);
 /* Get the version made by */
 
 int32_t mz_zip_set_version_madeby(void *handle, uint16_t version_madeby);
-/* Set the version made by used for writing zip file */
+/* Sets the version made by used for writing zip file */
 
 int32_t mz_zip_set_recover(void *handle, uint8_t recover);
-/* Set the ability to recover the central dir by reading local file headers */
+/* Sets the ability to recover the central dir by reading local file headers */
 
 int32_t mz_zip_set_data_descriptor(void *handle, uint8_t data_descriptor);
-/* Set the use of data descriptor flag when writing zip entries */
+/* Sets the use of data descriptor flag when writing zip entries */
 
 int32_t mz_zip_get_stream(void *handle, void **stream);
 /* Get a pointer to the stream used to open */

mz_zip_rw.c

@@ -62,6 +62,7 @@ typedef struct mz_zip_reader_s {
     uint8_t     cd_verified;
     uint8_t     cd_zipped;
     uint8_t     entry_verified;
+    uint8_t     recover;
 } mz_zip_reader;
 
 /***************************************************************************/
@@ -83,7 +84,7 @@ int32_t mz_zip_reader_open(void *handle, void *stream) {
     reader->cd_zipped = 0;
 
     mz_zip_create(&reader->zip_handle);
-    mz_zip_set_recover(reader->zip_handle, 1);
+    mz_zip_set_recover(reader->zip_handle, reader->recover);
 
     err = mz_zip_open(reader->zip_handle, stream, MZ_OPEN_MODE_READ);
 
@@ -906,6 +907,14 @@ int32_t mz_zip_reader_get_comment(void *handle, const char **comment) {
     return mz_zip_get_comment(reader->zip_handle, comment);
 }
 
+int32_t mz_zip_reader_set_recover(void *handle, uint8_t recover) {
+    mz_zip_reader *reader = (mz_zip_reader *)handle;
+    if (reader == NULL)
+        return MZ_PARAM_ERROR;
+    reader->recover = recover;
+    return MZ_OK;
+}
+
 void mz_zip_reader_set_encoding(void *handle, int32_t encoding) {
     mz_zip_reader *reader = (mz_zip_reader *)handle;
     reader->encoding = encoding;
@@ -963,6 +972,7 @@ void *mz_zip_reader_create(void **handle) {
     reader = (mz_zip_reader *)MZ_ALLOC(sizeof(mz_zip_reader));
     if (reader != NULL) {
         memset(reader, 0, sizeof(mz_zip_reader));
+        reader->recover = 1;
         reader->progress_cb_interval_ms = MZ_DEFAULT_PROGRESS_INTERVAL;
         *handle = reader;
     }

mz_zip_rw.h

@@ -125,6 +125,9 @@ int32_t mz_zip_reader_get_zip_cd(void *handle, uint8_t *zip_cd);
 int32_t mz_zip_reader_get_comment(void *handle, const char **comment);
 /* Gets the comment for the central directory */
 
+int32_t mz_zip_reader_set_recover(void *handle, uint8_t recover);
+/* Sets the ability to recover the central dir by reading local file headers */
+
 void    mz_zip_reader_set_encoding(void *handle, int32_t encoding);
 /* Sets whether or not it should support a special character encoding in zip file names. */