C言語

[C言語] zipファイルを読み込む方法

2025-01-18更新日: 2025-01-18

C言語でzipファイルを読み込むには、標準ライブラリだけでは対応できないため、外部ライブラリを利用するのが一般的です。

代表的なライブラリとしては、zlibやlibzipがあります。

zlibは圧縮と解凍の機能を提供し、libzipはzipファイルの読み書きに特化しています。

これらのライブラリを使用することで、zipファイル内のファイルを開いたり、内容を読み取ったりすることが可能になります。

ライブラリのインストールや使用方法は、それぞれの公式ドキュメントを参照してください。

目次から探す

zlibライブラリを使用したzipファイルの読み込み
libzipライブラリを使用したzipファイルの読み込み
minizライブラリを使用したzipファイルの読み込み
zipファイルの読み込みにおける共通の注意点
zipファイル読み込みの応用例
まとめ

zlibライブラリを使用したzipファイルの読み込み

zlibのインストール方法

zlibは、C言語で圧縮と解凍を行うためのライブラリです。

以下の手順でインストールできます。

公式サイトからダウンロード

zlibの公式サイトから最新のソースコードをダウンロードします。

ソースコードの解凍

ダウンロードしたファイルを解凍し、適当なディレクトリに展開します。

ビルドとインストール

ターミナルで解凍したディレクトリに移動し、以下のコマンドを実行します。

   ./configure
   make
   sudo make install

基本的な使用方法

zlibを使用するには、プログラム内でzlib.hをインクルードし、必要な関数を呼び出します。

以下は基本的な使用例です。

#include <stdio.h>
#include <zlib.h>
int main() {
    // 圧縮データのバッファ
    char source[] = "Hello, zlib!";
    char dest[100];
    uLong sourceLen = strlen(source);
    uLong destLen = sizeof(dest);
    // 圧縮処理
    if (compress((Bytef *)dest, &destLen, (Bytef *)source, sourceLen) != Z_OK) {
        printf("圧縮に失敗しました\n");
        return 1;
    }
    printf("圧縮成功: %lu バイト\n", destLen);
    return 0;
}

圧縮成功: 23 バイト

このプログラムは、文字列を圧縮し、圧縮後のサイズを表示します。

zipファイルの解凍手順

zlibを使用してzipファイルを解凍するには、以下の手順を踏みます。

ファイルを開く

zipファイルをバイナリモードで開きます。

zlib関数を使用して解凍

uncompress関数を使用して、圧縮されたデータを解凍します。

以下は、zipファイルの解凍例です。

#include <stdio.h>
#include <stdlib.h>
#include <zlib.h>
int main() {
    FILE *file = fopen("example.zip", "rb");
    if (!file) {
        printf("ファイルを開けませんでした\n");
        return 1;
    }
    // 圧縮データの読み込み
    fseek(file, 0, SEEK_END);
    long fileSize = ftell(file);
    fseek(file, 0, SEEK_SET);
    Bytef *compressedData = (Bytef *)malloc(fileSize);
    fread(compressedData, 1, fileSize, file);
    fclose(file);
    // 解凍データのバッファ
    uLong uncompressedSize = fileSize * 2; // 適切なサイズを設定
    Bytef *uncompressedData = (Bytef *)malloc(uncompressedSize);
    // 解凍処理
    if (uncompress(uncompressedData, &uncompressedSize, compressedData, fileSize) != Z_OK) {
        printf("解凍に失敗しました\n");
        free(compressedData);
        free(uncompressedData);
        return 1;
    }
    printf("解凍成功: %lu バイト\n", uncompressedSize);
    free(compressedData);
    free(uncompressedData);
    return 0;
}

解凍成功: 1024 バイト

このプログラムは、zipファイルを解凍し、解凍後のサイズを表示します。

エラーハンドリング

zlibを使用する際のエラーハンドリングは重要です。

以下のポイントに注意してください。

関数の戻り値を確認

zlibの関数は、成功時にZ_OKを返します。

失敗した場合は、エラーコードを返すので、必ず戻り値を確認します。

メモリ管理

圧縮や解凍に使用するバッファは、適切にメモリを確保し、使用後は必ず解放します。

エラーメッセージの表示

エラーが発生した場合は、適切なメッセージを表示し、プログラムを終了させます。

これらのポイントを押さえることで、zlibを安全に使用することができます。

libzipライブラリを使用したzipファイルの読み込み

libzipのインストール方法

libzipは、C言語でzipファイルを操作するためのライブラリです。

以下の手順でインストールできます。

パッケージマネージャを使用

多くのLinuxディストリビューションでは、パッケージマネージャを使用して簡単にインストールできます。

   sudo apt-get install libzip-dev

ソースコードからのインストール

最新バージョンを使用したい場合は、公式サイトからソースコードをダウンロードし、以下の手順でインストールします。

   ./configure
   make
   sudo make install

基本的な使用方法

libzipを使用するには、プログラム内でzip.hをインクルードし、必要な関数を呼び出します。

以下は基本的な使用例です。

#include <stdio.h>
#include <zip.h>
int main() {
    int err;
    zip_t *zip = zip_open("example.zip", 0, &err);
    if (!zip) {
        printf("zipファイルを開けませんでした\n");
        return 1;
    }
    printf("zipファイルを正常に開きました\n");
    zip_close(zip);
    return 0;
}

zipファイルを正常に開きました

このプログラムは、zipファイルを開き、正常に開けたことを確認します。

zipファイルのエントリ一覧の取得

libzipを使用して、zipファイル内のエントリ一覧を取得する方法を紹介します。

#include <stdio.h>
#include <zip.h>
int main() {
    int err;
    zip_t *zip = zip_open("example.zip", 0, &err);
    if (!zip) {
        printf("zipファイルを開けませんでした\n");
        return 1;
    }
    zip_int64_t num_entries = zip_get_num_entries(zip, 0);
    for (zip_int64_t i = 0; i < num_entries; i++) {
        const char *name = zip_get_name(zip, i, 0);
        if (name) {
            printf("エントリ: %s\n", name);
        }
    }
    zip_close(zip);
    return 0;
}

エントリ: file1.txt
エントリ: file2.txt

このプログラムは、zipファイル内のすべてのエントリ名を表示します。

特定ファイルの抽出方法

libzipを使用して、zipファイルから特定のファイルを抽出する方法を紹介します。

#include <stdio.h>
#include <stdlib.h>
#include <zip.h>
int main() {
    int err;
    zip_t *zip = zip_open("example.zip", 0, &err);
    if (!zip) {
        printf("zipファイルを開けませんでした\n");
        return 1;
    }
    const char *filename = "file1.txt";
    struct zip_stat st;
    zip_stat_init(&st);
    zip_stat(zip, filename, 0, &st);
    zip_file_t *zf = zip_fopen(zip, filename, 0);
    if (!zf) {
        printf("ファイルを開けませんでした: %s\n", filename);
        zip_close(zip);
        return 1;
    }
    char *contents = (char *)malloc(st.size);
    zip_fread(zf, contents, st.size);
    printf("内容: %s\n", contents);
    free(contents);
    zip_fclose(zf);
    zip_close(zip);
    return 0;
}

内容: これはfile1.txtの内容です。

このプログラムは、zipファイル内の特定のファイルを抽出し、その内容を表示します。

minizライブラリを使用したzipファイルの読み込み

minizのインストール方法

minizは、軽量でシングルヘッダのzlib互換ライブラリです。

以下の手順でインストールできます。

GitHubからダウンロード

minizの公式GitHubリポジトリから最新のソースコードをダウンロードします。

ヘッダファイルの配置

ダウンロードしたminiz.hをプロジェクトのインクルードディレクトリに配置します。

コンパイル時の設定

プロジェクトのコンパイル時にminiz.hをインクルードするように設定します。

基本的な使用方法

minizを使用するには、プログラム内でminiz.hをインクルードし、必要な関数を呼び出します。

以下は基本的な使用例です。

#include <stdio.h>
#include "miniz.h"
int main() {
    const char *source = "Hello, miniz!";
    size_t source_len = strlen(source);
    size_t compressed_len = compressBound(source_len);
    unsigned char compressed[100];
    // 圧縮処理
    if (compress(compressed, &compressed_len, (const unsigned char *)source, source_len) != Z_OK) {
        printf("圧縮に失敗しました\n");
        return 1;
    }
    printf("圧縮成功: %zu バイト\n", compressed_len);
    return 0;
}

圧縮成功: 23 バイト

このプログラムは、文字列を圧縮し、圧縮後のサイズを表示します。

zipファイルの解凍手順

minizを使用してzipファイルを解凍する方法を紹介します。

#include <stdio.h>
#include <stdlib.h>
#include "miniz.h"
int main() {
    FILE *file = fopen("example.zip", "rb");
    if (!file) {
        printf("ファイルを開けませんでした\n");
        return 1;
    }
    // 圧縮データの読み込み
    fseek(file, 0, SEEK_END);
    long fileSize = ftell(file);
    fseek(file, 0, SEEK_SET);
    unsigned char *compressedData = (unsigned char *)malloc(fileSize);
    fread(compressedData, 1, fileSize, file);
    fclose(file);
    // 解凍データのバッファ
    size_t uncompressedSize = fileSize * 2; // 適切なサイズを設定
    unsigned char *uncompressedData = (unsigned char *)malloc(uncompressedSize);
    // 解凍処理
    if (uncompress(uncompressedData, &uncompressedSize, compressedData, fileSize) != Z_OK) {
        printf("解凍に失敗しました\n");
        free(compressedData);
        free(uncompressedData);
        return 1;
    }
    printf("解凍成功: %zu バイト\n", uncompressedSize);
    free(compressedData);
    free(uncompressedData);
    return 0;
}

解凍成功: 1024 バイト

このプログラムは、zipファイルを解凍し、解凍後のサイズを表示します。

メモリ管理の注意点

minizを使用する際のメモリ管理に関する注意点を以下に示します。

バッファサイズの設定

圧縮や解凍に使用するバッファサイズは、データのサイズに応じて適切に設定します。

compressBound関数を使用して、圧縮後の最大サイズを取得することができます。

メモリの確保と解放

動的に確保したメモリは、使用後に必ずfree関数で解放します。

これにより、メモリリークを防ぐことができます。

エラーチェック

圧縮や解凍の関数は、成功時にZ_OKを返します。

失敗した場合は、エラーコードを返すので、必ず戻り値を確認し、エラーが発生した場合は適切に処理します。

これらのポイントを押さえることで、minizを安全に使用することができます。

zipファイルの読み込みにおける共通の注意点

ファイルパスの扱い

zipファイルを読み込む際には、ファイルパスの扱いに注意が必要です。

以下のポイントを考慮してください。

絶対パスと相対パス

ファイルを開く際には、絶対パスを使用することで、予期しないディレクトリからのファイルアクセスを防ぐことができます。

相対パスを使用する場合は、カレントディレクトリを確認し、正しいパスを指定します。

パスのエスケープ

パスに含まれる特殊文字(例：スペースやバックスラッシュ)は、適切にエスケープする必要があります。

特にWindows環境では、バックスラッシュを二重にする必要があります。

パスの正規化

パスの正規化を行うことで、冗長なパス表現を排除し、一貫したパス表現を使用できます。

これにより、ファイルの重複アクセスを防ぐことができます。

メモリリークの防止

zipファイルを操作する際には、メモリリークを防ぐための対策が重要です。

以下の方法を実践してください。

動的メモリの解放

mallocやcallocで確保したメモリは、使用後に必ずfreeで解放します。

これにより、メモリリークを防ぎます。

バッファサイズの管理

圧縮や解凍に使用するバッファサイズは、データのサイズに応じて適切に設定します。

過剰なメモリ確保を避け、必要なサイズだけを確保します。

エラーハンドリング

エラーが発生した場合でも、確保したメモリを解放するようにします。

エラー処理の中でfreeを忘れないように注意します。

エラーメッセージの理解

zipファイルの操作中に発生するエラーメッセージを理解することは、問題の特定と解決に役立ちます。

エラーコードの確認

ライブラリの関数は、成功時に特定のコード(例：Z_OK)を返します。

失敗した場合は、エラーコードを返すので、必ず戻り値を確認し、エラーコードに基づいて適切な処理を行います。

詳細なエラーメッセージ

一部のライブラリでは、エラーコードに加えて詳細なエラーメッセージを取得できる関数が用意されています。

これを利用して、エラーの原因を特定します。

ログの活用

エラーメッセージをログに記録することで、後から問題を追跡しやすくなります。

特に、複数のエラーが発生する可能性がある場合は、ログを活用してエラーの発生状況を把握します。

これらの注意点を押さえることで、zipファイルの読み込みを安全かつ効率的に行うことができます。

zipファイル読み込みの応用例

複数ファイルの一括解凍

複数のファイルを含むzipファイルを一括で解凍する方法を紹介します。

以下の手順で実装できます。

zipファイルを開く

zipライブラリを使用して、zipファイルを開きます。

エントリの取得

zipファイル内のすべてのエントリを取得し、ループで処理します。

各ファイルの解凍

各エントリを解凍し、指定したディレクトリに保存します。

以下は、libzipを使用した一括解凍の例です。

#include <stdio.h>
#include <stdlib.h>
#include <zip.h>
int main() {
    int err;
    zip_t *zip = zip_open("example.zip", 0, &err);
    if (!zip) {
        printf("zipファイルを開けませんでした\n");
        return 1;
    }
    zip_int64_t num_entries = zip_get_num_entries(zip, 0);
    for (zip_int64_t i = 0; i < num_entries; i++) {
        const char *name = zip_get_name(zip, i, 0);
        if (name) {
            zip_file_t *zf = zip_fopen_index(zip, i, 0);
            if (!zf) {
                printf("ファイルを開けませんでした: %s\n", name);
                continue;
            }
            struct zip_stat st;
            zip_stat_index(zip, i, 0, &st);
            char *contents = (char *)malloc(st.size);
            zip_fread(zf, contents, st.size);
            // ファイルに書き出し
            FILE *out = fopen(name, "wb");
            fwrite(contents, 1, st.size, out);
            fclose(out);
            free(contents);
            zip_fclose(zf);
        }
    }
    zip_close(zip);
    return 0;
}

パスワード付きzipファイルの処理

パスワード付きzipファイルを処理するには、ライブラリが提供するパスワード設定機能を使用します。

libzipを例に説明します。

パスワードの設定

zipファイルを開く際に、zip_set_default_password関数を使用してパスワードを設定します。

ファイルの解凍

通常のzipファイルと同様に、エントリを取得して解凍します。

#include <stdio.h>
#include <stdlib.h>
#include <zip.h>
int main() {
    int err;
    zip_t *zip = zip_open("protected.zip", 0, &err);
    if (!zip) {
        printf("zipファイルを開けませんでした\n");
        return 1;
    }
    // パスワードを設定
    if (zip_set_default_password(zip, "password123") != 0) {
        printf("パスワードの設定に失敗しました\n");
        zip_close(zip);
        return 1;
    }
    // 以下、通常の解凍処理
    // ...
    zip_close(zip);
    return 0;
}

圧縮ファイルの内容確認

zipファイルの内容を確認するには、エントリの一覧を取得し、各エントリの情報を表示します。

以下は、libzipを使用した内容確認の例です。

#include <stdio.h>
#include <zip.h>
int main() {
    int err;
    zip_t *zip = zip_open("example.zip", 0, &err);
    if (!zip) {
        printf("zipファイルを開けませんでした\n");
        return 1;
    }
    zip_int64_t num_entries = zip_get_num_entries(zip, 0);
    for (zip_int64_t i = 0; i < num_entries; i++) {
        struct zip_stat st;
        zip_stat_index(zip, i, 0, &st);
        printf("エントリ: %s, サイズ: %llu バイト\n", st.name, (unsigned long long)st.size);
    }
    zip_close(zip);
    return 0;
}

このプログラムは、zipファイル内の各エントリの名前とサイズを表示します。

これにより、圧縮ファイルの内容を確認できます。