GZip.h

Go to the documentation of this file.

/*
 * Copyright(c) Sophist Solutions, Inc. 1990-2025.  All rights reserved
 */
#ifndef _Stroika_Foundation_DataExchange_Compression_GZip_h_
#define _Stroika_Foundation_DataExchange_Compression_GZip_h_ 1
 
#include "Stroika/Foundation/StroikaPreComp.h"
 
#include "Stroika/Foundation/DataExchange/Compression/Common.h"
 
/**
 *  \file
 * 
 *  https://en.wikipedia.org/wiki/GZip
 *
 *  \note Code-Status:  <a href="Code-Status.md#Beta">Beta</a>
 */
 
namespace Stroika::Foundation::DataExchange::Compression::GZip {
 
    /**
     *  Check at compile time if GZip is supported.
     */
    constexpr bool kSupported =
#if qStroika_HasComponent_zlib
        true
#else
        false
#endif
        ;
 
    /**
     *  \par Example Usage
     *      \code
     *          Memory::BLOB  kSample1_   =     Memory::BLOB::Hex ("aa1234abcd01010102030405");
     *          Memory::BLOB  compressed  =     Compression::GZip::Compress::New ().Transform (kSample1_);
     *          Assert (kSample1_ == Compression::Compression::GZip::Decompress::New ().Transform (compressed));
     *      \endcode
     * 
     *  \note if not kSupported, these 'New ()' functions just throw FeatureNotSupportedException{}
     */
    namespace Compress {
        struct Options : Compression::Compress::Options {
            // NYI (see https://stackoverflow.com/questions/72499500/whats-special-about-deflateinit2-that-prevents-deflatesetheader-be-used-with-de)
            optional<Memory::BLOB> fDictionary;
        };
        Ptr New (const Options& o = {});
    }
    namespace Decompress {
        struct Options : Compression::Compress::Options {
            // NYI (see https://stackoverflow.com/questions/72499500/whats-special-about-deflateinit2-that-prevents-deflatesetheader-be-used-with-de)
            optional<Memory::BLOB> fDictionary;
        };
        Ptr New (const Options& o = {});
    }
 
}
 
/*
 ********************************************************************************
 ***************************** Implementation Details ***************************
 ********************************************************************************
 */
 
#endif /*_Stroika_Foundation_DataExchange_Compression_GZip_h_*/