C++

Transition from BeginCompressStringENC to FirstChunk/LastChunk

Provides instructions for replacing deprecated BeginCompressStringENC method calls with using FirstChunk/LastChunk properties. C++

#include <CkStringBuilder.h>
#include <CkCompression.h>
#include <CkBinData.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  This example assumes the Chilkat API to have been previously unlocked.
    //  See Global Unlock Sample for sample code.

    CkStringBuilder sbCompressedBase64;

    CkCompression compress;
    compress.put_Algorithm("deflate");
    compress.put_Charset("utf-8");
    compress.put_EncodingMode("base64");

    CkStringBuilder sbIndex;

    //  ----------------------------------------------------------------------------------
    //  This is the deprecated way of compressing in chunks using Begin/More/End methods..
    //  ----------------------------------------------------------------------------------
    int i;
    for (i = 0; i <= 24; i++) {
        //  Note: It is possible (and normal) for a BeginCompress* or MoreCompress* method to return
        //  an empty string (or 0 bytes).  When this happens, the input data is not lost.  It will be flushed
        //  in a subsequent call.
        sbIndex.Clear();
        sbIndex.AppendInt(i);
        if (i == 0) {
            sbCompressedBase64.Append(compress.beginCompressStringENC(sbIndex.getAsString()));
        }
        else {
            sbCompressedBase64.Append(compress.moreCompressStringENC(sbIndex.getAsString()));
        }

        sbCompressedBase64.Append(compress.moreCompressStringENC(": This is a line of data to be compressed...\r\n"));
    }

    //  Flush any remaining output.
    sbCompressedBase64.Append(compress.endCompressStringENC());

    std::cout << "The base64 encoded compressed text:" << "\r\n";
    std::cout << sbCompressedBase64.getAsString() << "\r\n";

    //  Decompress in one call:
    const char *originalText = compress.decompressStringENC(sbCompressedBase64.getAsString());
    std::cout << originalText << "\r\n";

    //  ----------------------------------------------------------------------------------
    //  This is new way of compressing in chunks using FirstChunk and LastChunk properties
    //  ----------------------------------------------------------------------------------

    sbCompressedBase64.Clear();

    compress.put_FirstChunk(true);
    compress.put_LastChunk(false);

    CkBinData bdCompressed;
    CkStringBuilder sbUncompressedChunk;

    for (i = 0; i <= 24; i++) {
        if (i == 24) {
            compress.put_LastChunk(true);
        }

        sbUncompressedChunk.Clear();
        sbUncompressedChunk.AppendInt(i);
        sbUncompressedChunk.Append(": This is a line of data to be compressed...\r\n");

        compress.CompressSb(sbUncompressedChunk,bdCompressed);

        compress.put_FirstChunk(false);
    }

    std::cout << "The base64 encoded compressed text:" << "\r\n";
    std::cout << bdCompressed.getEncoded("base64") << "\r\n";

    //  Decompress in one call:
    originalText = compress.decompressStringENC(bdCompressed.getEncoded("base64"));
    std::cout << originalText << "\r\n";
    }