💾 Archived View for gmi.noulin.net › gitRepositories › lz4 › file › lz4.h.gmi captured on 2024-08-18 at 18:49:48. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2023-01-29)

-=-=-=-=-=-=-

lz4

Log

Files

Refs

LICENSE

lz4.h (24342B)

     1 /*
     2  *  LZ4 - Fast LZ compression algorithm
     3  *  Header File
     4  *  Copyright (C) 2011-2017, Yann Collet.
     5 
     6    BSD 2-Clause License (http://www.opensource.org/licenses/bsd-license.php)
     7 
     8    Redistribution and use in source and binary forms, with or without
     9    modification, are permitted provided that the following conditions are
    10    met:
    11 
    12        * Redistributions of source code must retain the above copyright
    13    notice, this list of conditions and the following disclaimer.
    14        * Redistributions in binary form must reproduce the above
    15    copyright notice, this list of conditions and the following disclaimer
    16    in the documentation and/or other materials provided with the
    17    distribution.
    18 
    19    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    20    "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
    21    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    22    A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
    23    OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    24    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    25    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    26    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
    27    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    28    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    29    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    30 
    31    You can contact the author at :
    32     - LZ4 homepage : http://www.lz4.org
    33     - LZ4 source repository : https://github.com/lz4/lz4
    34 */
    35 #if defined (__cplusplus)
    36 extern "C" {
    37 #endif
    38 
    39 #ifndef LZ4_H_2983827168210
    40 #define LZ4_H_2983827168210
    41 
    42 /* --- Dependency --- */
    43 #include <stddef.h>   /* size_t */
    44 
    45 
    46 /**
    47   Introduction
    48 
    49   LZ4 is lossless compression algorithm, providing compression speed at 400 MB/s per core,
    50   scalable with multi-cores CPU. It features an extremely fast decoder, with speed in
    51   multiple GB/s per core, typically reaching RAM speed limits on multi-core systems.
    52 
    53   The LZ4 compression library provides in-memory compression and decompression functions.
    54   Compression can be done in:
    55     - a single step (described as Simple Functions)
    56     - a single step, reusing a context (described in Advanced Functions)
    57     - unbounded multiple steps (described as Streaming compression)
    58 
    59   lz4.h provides block compression functions. It gives full buffer control to user.
    60   Decompressing an lz4-compressed block also requires metadata (such as compressed size).
    61   Each application is free to encode such metadata in whichever way it wants.
    62 
    63   An additional format, called LZ4 frame specification (doc/lz4_Frame_format.md),
    64   take care of encoding standard metadata alongside LZ4-compressed blocks.
    65   If your application requires interoperability, it's recommended to use it.
    66   A library is provided to take care of it, see lz4frame.h.
    67 */
    68 
    69 /*^***************************************************************
    70 *  Export parameters
    71 *****************************************************************/
    72 /*
    73 *  LZ4_DLL_EXPORT :
    74 *  Enable exporting of functions when building a Windows DLL
    75 *  LZ4LIB_VISIBILITY :
    76 *  Control library symbols visibility.
    77 */
    78 #ifndef LZ4LIB_VISIBILITY
    79 #  if defined(__GNUC__) && (__GNUC__ >= 4)
    80 #    define LZ4LIB_VISIBILITY __attribute__ ((visibility ("default")))
    81 #  else
    82 #    define LZ4LIB_VISIBILITY
    83 #  endif
    84 #endif
    85 #if defined(LZ4_DLL_EXPORT) && (LZ4_DLL_EXPORT==1)
    86 #  define LZ4LIB_API __declspec(dllexport) LZ4LIB_VISIBILITY
    87 #elif defined(LZ4_DLL_IMPORT) && (LZ4_DLL_IMPORT==1)
    88 #  define LZ4LIB_API __declspec(dllimport) LZ4LIB_VISIBILITY /* It isn't required but allows to generate better code, saving a function pointer load from the IAT and an indirect jump.*/
    89 #else
    90 #  define LZ4LIB_API LZ4LIB_VISIBILITY
    91 #endif
    92 
    93 /*------   Version   ------*/
    94 #define LZ4_VERSION_MAJOR    1    /* for breaking interface changes  */
    95 #define LZ4_VERSION_MINOR    8    /* for new (non-breaking) interface capabilities */
    96 #define LZ4_VERSION_RELEASE  2    /* for tweaks, bug-fixes, or development */
    97 
    98 #define LZ4_VERSION_NUMBER (LZ4_VERSION_MAJOR *100*100 + LZ4_VERSION_MINOR *100 + LZ4_VERSION_RELEASE)
    99 
   100 #define LZ4_LIB_VERSION LZ4_VERSION_MAJOR.LZ4_VERSION_MINOR.LZ4_VERSION_RELEASE
   101 #define LZ4_QUOTE(str) #str
   102 #define LZ4_EXPAND_AND_QUOTE(str) LZ4_QUOTE(str)
   103 #define LZ4_VERSION_STRING LZ4_EXPAND_AND_QUOTE(LZ4_LIB_VERSION)
   104 
   105 LZ4LIB_API int LZ4_versionNumber (void);  /**< library version number; useful to check dll version */
   106 LZ4LIB_API const char* LZ4_versionString (void);   /**< library version string; unseful to check dll version */
   107 
   108 
   109 /*-************************************
   110 *  Tuning parameter
   111 **************************************/
   112 /*!
   113  * LZ4_MEMORY_USAGE :
   114  * Memory usage formula : N->2^N Bytes (examples : 10 -> 1KB; 12 -> 4KB ; 16 -> 64KB; 20 -> 1MB; etc.)
   115  * Increasing memory usage improves compression ratio
   116  * Reduced memory usage may improve speed, thanks to cache effect
   117  * Default value is 14, for 16KB, which nicely fits into Intel x86 L1 cache
   118  */
   119 #ifndef LZ4_MEMORY_USAGE
   120 # define LZ4_MEMORY_USAGE 14
   121 #endif
   122 
   123 /*-************************************
   124 *  Simple Functions
   125 **************************************/
   126 /*! LZ4_compress_default() :
   127     Compresses 'srcSize' bytes from buffer 'src'
   128     into already allocated 'dst' buffer of size 'dstCapacity'.
   129     Compression is guaranteed to succeed if 'dstCapacity' >= LZ4_compressBound(srcSize).
   130     It also runs faster, so it's a recommended setting.
   131     If the function cannot compress 'src' into a more limited 'dst' budget,
   132     compression stops *immediately*, and the function result is zero.
   133     Note : as a consequence, 'dst' content is not valid.
   134     Note 2 : This function is protected against buffer overflow scenarios (never writes outside 'dst' buffer, nor read outside 'source' buffer).
   135         srcSize : max supported value is LZ4_MAX_INPUT_SIZE.
   136         dstCapacity : size of buffer 'dst' (which must be already allocated)
   137         return  : the number of bytes written into buffer 'dst' (necessarily <= dstCapacity)
   138                   or 0 if compression fails */
   139 LZ4LIB_API int LZ4_compress_default(const char* src, char* dst, int srcSize, int dstCapacity);
   140 
   141 /*! LZ4_decompress_safe() :
   142     compressedSize : is the exact complete size of the compressed block.
   143     dstCapacity : is the size of destination buffer, which must be already allocated.
   144     return : the number of bytes decompressed into destination buffer (necessarily <= dstCapacity)
   145              If destination buffer is not large enough, decoding will stop and output an error code (negative value).
   146              If the source stream is detected malformed, the function will stop decoding and return a negative result.
   147              This function is protected against malicious data packets.
   148 */
   149 LZ4LIB_API int LZ4_decompress_safe (const char* src, char* dst, int compressedSize, int dstCapacity);
   150 
   151 
   152 /*-************************************
   153 *  Advanced Functions
   154 **************************************/
   155 #define LZ4_MAX_INPUT_SIZE        0x7E000000   /* 2 113 929 216 bytes */
   156 #define LZ4_COMPRESSBOUND(isize)  ((unsigned)(isize) > (unsigned)LZ4_MAX_INPUT_SIZE ? 0 : (isize) + ((isize)/255) + 16)
   157 
   158 /*!
   159 LZ4_compressBound() :
   160     Provides the maximum size that LZ4 compression may output in a "worst case" scenario (input data not compressible)
   161     This function is primarily useful for memory allocation purposes (destination buffer size).
   162     Macro LZ4_COMPRESSBOUND() is also provided for compilation-time evaluation (stack memory allocation for example).
   163     Note that LZ4_compress_default() compresses faster when dstCapacity is >= LZ4_compressBound(srcSize)
   164         inputSize  : max supported value is LZ4_MAX_INPUT_SIZE
   165         return : maximum output size in a "worst case" scenario
   166               or 0, if input size is incorrect (too large or negative)
   167 */
   168 LZ4LIB_API int LZ4_compressBound(int inputSize);
   169 
   170 /*!
   171 LZ4_compress_fast() :
   172     Same as LZ4_compress_default(), but allows selection of "acceleration" factor.
   173     The larger the acceleration value, the faster the algorithm, but also the lesser the compression.
   174     It's a trade-off. It can be fine tuned, with each successive value providing roughly +~3% to speed.
   175     An acceleration value of "1" is the same as regular LZ4_compress_default()
   176     Values <= 0 will be replaced by ACCELERATION_DEFAULT (currently == 1, see lz4.c).
   177 */
   178 LZ4LIB_API int LZ4_compress_fast (const char* src, char* dst, int srcSize, int dstCapacity, int acceleration);
   179 
   180 
   181 /*!
   182 LZ4_compress_fast_extState() :
   183     Same compression function, just using an externally allocated memory space to store compression state.
   184     Use LZ4_sizeofState() to know how much memory must be allocated,
   185     and allocate it on 8-bytes boundaries (using malloc() typically).
   186     Then, provide it as 'void* state' to compression function.
   187 */
   188 LZ4LIB_API int LZ4_sizeofState(void);
   189 LZ4LIB_API int LZ4_compress_fast_extState (void* state, const char* src, char* dst, int srcSize, int dstCapacity, int acceleration);
   190 
   191 
   192 /*!
   193 LZ4_compress_destSize() :
   194     Reverse the logic : compresses as much data as possible from 'src' buffer
   195     into already allocated buffer 'dst' of size 'targetDestSize'.
   196     This function either compresses the entire 'src' content into 'dst' if it's large enough,
   197     or fill 'dst' buffer completely with as much data as possible from 'src'.
   198         *srcSizePtr : will be modified to indicate how many bytes where read from 'src' to fill 'dst'.
   199                       New value is necessarily <= old value.
   200         return : Nb bytes written into 'dst' (necessarily <= targetDestSize)
   201                  or 0 if compression fails
   202 */
   203 LZ4LIB_API int LZ4_compress_destSize (const char* src, char* dst, int* srcSizePtr, int targetDstSize);
   204 
   205 
   206 /*!
   207 LZ4_decompress_fast() : **unsafe!**
   208 This function is a bit faster than LZ4_decompress_safe(),
   209 but doesn't provide any security guarantee.
   210     originalSize : is the uncompressed size to regenerate
   211                    Destination buffer must be already allocated, and its size must be >= 'originalSize' bytes.
   212     return : number of bytes read from source buffer (== compressed size).
   213              If the source stream is detected malformed, the function stops decoding and return a negative result.
   214     note : This function respects memory boundaries for *properly formed* compressed data.
   215            However, it does not provide any protection against malicious input.
   216            It also doesn't know 'src' size, and implies it's >= compressed size.
   217            Use this function in trusted environment **only**.
   218 */
   219 LZ4LIB_API int LZ4_decompress_fast (const char* src, char* dst, int originalSize);
   220 
   221 /*!
   222 LZ4_decompress_safe_partial() :
   223     This function decompress a compressed block of size 'srcSize' at position 'src'
   224     into destination buffer 'dst' of size 'dstCapacity'.
   225     The function will decompress a minimum of 'targetOutputSize' bytes, and stop after that.
   226     However, it's not accurate, and may write more than 'targetOutputSize' (but always <= dstCapacity).
   227    @return : the number of bytes decoded in the destination buffer (necessarily <= dstCapacity)
   228         Note : this number can also be < targetOutputSize, if compressed block contains less data.
   229             Therefore, always control how many bytes were decoded.
   230             If source stream is detected malformed, function returns a negative result.
   231             This function is protected against malicious data packets.
   232 */
   233 LZ4LIB_API int LZ4_decompress_safe_partial (const char* src, char* dst, int srcSize, int targetOutputSize, int dstCapacity);
   234 
   235 
   236 /*-*********************************************
   237 *  Streaming Compression Functions
   238 ***********************************************/
   239 typedef union LZ4_stream_u LZ4_stream_t;  /* incomplete type (defined later) */
   240 
   241 /*! LZ4_createStream() and LZ4_freeStream() :
   242  *  LZ4_createStream() will allocate and initialize an `LZ4_stream_t` structure.
   243  *  LZ4_freeStream() releases its memory.
   244  */
   245 LZ4LIB_API LZ4_stream_t* LZ4_createStream(void);
   246 LZ4LIB_API int           LZ4_freeStream (LZ4_stream_t* streamPtr);
   247 
   248 /*! LZ4_resetStream() :
   249  *  An LZ4_stream_t structure can be allocated once and re-used multiple times.
   250  *  Use this function to start compressing a new stream.
   251  */
   252 LZ4LIB_API void LZ4_resetStream (LZ4_stream_t* streamPtr);
   253 
   254 /*! LZ4_loadDict() :
   255  *  Use this function to load a static dictionary into LZ4_stream_t.
   256  *  Any previous data will be forgotten, only 'dictionary' will remain in memory.
   257  *  Loading a size of 0 is allowed, and is the same as reset.
   258  * @return : dictionary size, in bytes (necessarily <= 64 KB)
   259  */
   260 LZ4LIB_API int LZ4_loadDict (LZ4_stream_t* streamPtr, const char* dictionary, int dictSize);
   261 
   262 /*! LZ4_compress_fast_continue() :
   263  *  Compress 'src' content using data from previously compressed blocks, for better compression ratio.
   264  *  'dst' buffer must be already allocated.
   265  *  If dstCapacity >= LZ4_compressBound(srcSize), compression is guaranteed to succeed, and runs faster.
   266  *
   267  *  Important : The previous 64KB of compressed data is assumed to remain present and unmodified in memory!
   268  *
   269  *  Special 1 : When input is a double-buffer, they can have any size, including < 64 KB.
   270  *              Make sure that buffers are separated by at least one byte.
   271  *              This way, each block only depends on previous block.
   272  *  Special 2 : If input buffer is a ring-buffer, it can have any size, including < 64 KB.
   273  *
   274  * @return : size of compressed block
   275  *           or 0 if there is an error (typically, cannot fit into 'dst').
   276  *  After an error, the stream status is invalid, it can only be reset or freed.
   277  */
   278 LZ4LIB_API int LZ4_compress_fast_continue (LZ4_stream_t* streamPtr, const char* src, char* dst, int srcSize, int dstCapacity, int acceleration);
   279 
   280 /*! LZ4_saveDict() :
   281  *  If last 64KB data cannot be guaranteed to remain available at its current memory location,
   282  *  save it into a safer place (char* safeBuffer).
   283  *  This is schematically equivalent to a memcpy() followed by LZ4_loadDict(),
   284  *  but is much faster, because LZ4_saveDict() doesn't need to rebuild tables.
   285  * @return : saved dictionary size in bytes (necessarily <= maxDictSize), or 0 if error.
   286  */
   287 LZ4LIB_API int LZ4_saveDict (LZ4_stream_t* streamPtr, char* safeBuffer, int maxDictSize);
   288 
   289 
   290 /*-**********************************************
   291 *  Streaming Decompression Functions
   292 *  Bufferless synchronous API
   293 ************************************************/
   294 typedef union LZ4_streamDecode_u LZ4_streamDecode_t;   /* incomplete type (defined later) */
   295 
   296 /*! LZ4_createStreamDecode() and LZ4_freeStreamDecode() :
   297  *  creation / destruction of streaming decompression tracking structure.
   298  *  A tracking structure can be re-used multiple times sequentially. */
   299 LZ4LIB_API LZ4_streamDecode_t* LZ4_createStreamDecode(void);
   300 LZ4LIB_API int                 LZ4_freeStreamDecode (LZ4_streamDecode_t* LZ4_stream);
   301 
   302 /*! LZ4_setStreamDecode() :
   303  *  An LZ4_streamDecode_t structure can be allocated once and re-used multiple times.
   304  *  Use this function to start decompression of a new stream of blocks.
   305  *  A dictionary can optionnally be set. Use NULL or size 0 for a reset order.
   306  * @return : 1 if OK, 0 if error
   307  */
   308 LZ4LIB_API int LZ4_setStreamDecode (LZ4_streamDecode_t* LZ4_streamDecode, const char* dictionary, int dictSize);
   309 
   310 /*! LZ4_decompress_*_continue() :
   311  *  These decoding functions allow decompression of consecutive blocks in "streaming" mode.
   312  *  A block is an unsplittable entity, it must be presented entirely to a decompression function.
   313  *  Decompression functions only accept one block at a time.
   314  *  The last 64KB of previously decoded data *must* remain available and unmodified at the memory position where they were decoded.
   315  *  If less than 64KB of data has been decoded all the data must be present.
   316  *
   317  *  Special : if application sets a ring buffer for decompression, it must respect one of the following conditions :
   318  *  - Exactly same size as encoding buffer, with same update rule (block boundaries at same positions)
   319  *    In which case, the decoding & encoding ring buffer can have any size, including very small ones ( < 64 KB).
   320  *  - Larger than encoding buffer, by a minimum of maxBlockSize more bytes.
   321  *    maxBlockSize is implementation dependent. It's the maximum size of any single block.
   322  *    In which case, encoding and decoding buffers do not need to be synchronized,
   323  *    and encoding ring buffer can have any size, including small ones ( < 64 KB).
   324  *  - _At least_ 64 KB + 8 bytes + maxBlockSize.
   325  *    In which case, encoding and decoding buffers do not need to be synchronized,
   326  *    and encoding ring buffer can have any size, including larger than decoding buffer.
   327  *  Whenever these conditions are not possible, save the last 64KB of decoded data into a safe buffer,
   328  *  and indicate where it is saved using LZ4_setStreamDecode() before decompressing next block.
   329 */
   330 LZ4LIB_API int LZ4_decompress_safe_continue (LZ4_streamDecode_t* LZ4_streamDecode, const char* src, char* dst, int srcSize, int dstCapacity);
   331 LZ4LIB_API int LZ4_decompress_fast_continue (LZ4_streamDecode_t* LZ4_streamDecode, const char* src, char* dst, int originalSize);
   332 
   333 
   334 /*! LZ4_decompress_*_usingDict() :
   335  *  These decoding functions work the same as
   336  *  a combination of LZ4_setStreamDecode() followed by LZ4_decompress_*_continue()
   337  *  They are stand-alone, and don't need an LZ4_streamDecode_t structure.
   338  */
   339 LZ4LIB_API int LZ4_decompress_safe_usingDict (const char* src, char* dst, int srcSize, int dstCapcity, const char* dictStart, int dictSize);
   340 LZ4LIB_API int LZ4_decompress_fast_usingDict (const char* src, char* dst, int originalSize, const char* dictStart, int dictSize);
   341 
   342 
   343 /*^**********************************************
   344  * !!!!!!   STATIC LINKING ONLY   !!!!!!
   345  ***********************************************/
   346 /*-************************************
   347  *  Private definitions
   348  **************************************
   349  * Do not use these definitions.
   350  * They are exposed to allow static allocation of `LZ4_stream_t` and `LZ4_streamDecode_t`.
   351  * Using these definitions will expose code to API and/or ABI break in future versions of the library.
   352  **************************************/
   353 #define LZ4_HASHLOG   (LZ4_MEMORY_USAGE-2)
   354 #define LZ4_HASHTABLESIZE (1 << LZ4_MEMORY_USAGE)
   355 #define LZ4_HASH_SIZE_U32 (1 << LZ4_HASHLOG)       /* required as macro for static allocation */
   356 
   357 #if defined(__cplusplus) || (defined (__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) /* C99 */)
   358 #include <stdint.h>
   359 
   360 typedef struct {
   361     uint32_t hashTable[LZ4_HASH_SIZE_U32];
   362     uint32_t currentOffset;
   363     uint32_t initCheck;
   364     const uint8_t* dictionary;
   365     uint8_t* bufferStart;   /* obsolete, used for slideInputBuffer */
   366     uint32_t dictSize;
   367 } LZ4_stream_t_internal;
   368 
   369 typedef struct {
   370     const uint8_t* externalDict;
   371     size_t extDictSize;
   372     const uint8_t* prefixEnd;
   373     size_t prefixSize;
   374 } LZ4_streamDecode_t_internal;
   375 
   376 #else
   377 
   378 typedef struct {
   379     unsigned int hashTable[LZ4_HASH_SIZE_U32];
   380     unsigned int currentOffset;
   381     unsigned int initCheck;
   382     const unsigned char* dictionary;
   383     unsigned char* bufferStart;   /* obsolete, used for slideInputBuffer */
   384     unsigned int dictSize;
   385 } LZ4_stream_t_internal;
   386 
   387 typedef struct {
   388     const unsigned char* externalDict;
   389     size_t extDictSize;
   390     const unsigned char* prefixEnd;
   391     size_t prefixSize;
   392 } LZ4_streamDecode_t_internal;
   393 
   394 #endif
   395 
   396 /*!
   397  * LZ4_stream_t :
   398  * information structure to track an LZ4 stream.
   399  * init this structure before first use.
   400  * note : only use in association with static linking !
   401  *        this definition is not API/ABI safe,
   402  *        it may change in a future version !
   403  */
   404 #define LZ4_STREAMSIZE_U64 ((1 << (LZ4_MEMORY_USAGE-3)) + 4)
   405 #define LZ4_STREAMSIZE     (LZ4_STREAMSIZE_U64 * sizeof(unsigned long long))
   406 union LZ4_stream_u {
   407     unsigned long long table[LZ4_STREAMSIZE_U64];
   408     LZ4_stream_t_internal internal_donotuse;
   409 } ;  /* previously typedef'd to LZ4_stream_t */
   410 
   411 
   412 /*!
   413  * LZ4_streamDecode_t :
   414  * information structure to track an LZ4 stream during decompression.
   415  * init this structure  using LZ4_setStreamDecode (or memset()) before first use
   416  * note : only use in association with static linking !
   417  *        this definition is not API/ABI safe,
   418  *        and may change in a future version !
   419  */
   420 #define LZ4_STREAMDECODESIZE_U64  4
   421 #define LZ4_STREAMDECODESIZE     (LZ4_STREAMDECODESIZE_U64 * sizeof(unsigned long long))
   422 union LZ4_streamDecode_u {
   423     unsigned long long table[LZ4_STREAMDECODESIZE_U64];
   424     LZ4_streamDecode_t_internal internal_donotuse;
   425 } ;   /* previously typedef'd to LZ4_streamDecode_t */
   426 
   427 
   428 /*-************************************
   429 *  Obsolete Functions
   430 **************************************/
   431 
   432 /*! Deprecation warnings
   433    Should deprecation warnings be a problem,
   434    it is generally possible to disable them,
   435    typically with -Wno-deprecated-declarations for gcc
   436    or _CRT_SECURE_NO_WARNINGS in Visual.
   437    Otherwise, it's also possible to define LZ4_DISABLE_DEPRECATE_WARNINGS */
   438 #ifdef LZ4_DISABLE_DEPRECATE_WARNINGS
   439 #  define LZ4_DEPRECATED(message)   /* disable deprecation warnings */
   440 #else
   441 #  define LZ4_GCC_VERSION (__GNUC__ * 100 + __GNUC_MINOR__)
   442 #  if defined (__cplusplus) && (__cplusplus >= 201402) /* C++14 or greater */
   443 #    define LZ4_DEPRECATED(message) [[deprecated(message)]]
   444 #  elif (LZ4_GCC_VERSION >= 405) || defined(__clang__)
   445 #    define LZ4_DEPRECATED(message) __attribute__((deprecated(message)))
   446 #  elif (LZ4_GCC_VERSION >= 301)
   447 #    define LZ4_DEPRECATED(message) __attribute__((deprecated))
   448 #  elif defined(_MSC_VER)
   449 #    define LZ4_DEPRECATED(message) __declspec(deprecated(message))
   450 #  else
   451 #    pragma message("WARNING: You need to implement LZ4_DEPRECATED for this compiler")
   452 #    define LZ4_DEPRECATED(message)
   453 #  endif
   454 #endif /* LZ4_DISABLE_DEPRECATE_WARNINGS */
   455 
   456 /* Obsolete compression functions */
   457 LZ4_DEPRECATED("use LZ4_compress_default() instead") LZ4LIB_API int LZ4_compress               (const char* source, char* dest, int sourceSize);
   458 LZ4_DEPRECATED("use LZ4_compress_default() instead") LZ4LIB_API int LZ4_compress_limitedOutput (const char* source, char* dest, int sourceSize, int maxOutputSize);
   459 LZ4_DEPRECATED("use LZ4_compress_fast_extState() instead") LZ4LIB_API int LZ4_compress_withState               (void* state, const char* source, char* dest, int inputSize);
   460 LZ4_DEPRECATED("use LZ4_compress_fast_extState() instead") LZ4LIB_API int LZ4_compress_limitedOutput_withState (void* state, const char* source, char* dest, int inputSize, int maxOutputSize);
   461 LZ4_DEPRECATED("use LZ4_compress_fast_continue() instead") LZ4LIB_API int LZ4_compress_continue                (LZ4_stream_t* LZ4_streamPtr, const char* source, char* dest, int inputSize);
   462 LZ4_DEPRECATED("use LZ4_compress_fast_continue() instead") LZ4LIB_API int LZ4_compress_limitedOutput_continue  (LZ4_stream_t* LZ4_streamPtr, const char* source, char* dest, int inputSize, int maxOutputSize);
   463 
   464 /* Obsolete decompression functions */
   465 LZ4_DEPRECATED("use LZ4_decompress_fast() instead") LZ4LIB_API int LZ4_uncompress (const char* source, char* dest, int outputSize);
   466 LZ4_DEPRECATED("use LZ4_decompress_safe() instead") LZ4LIB_API int LZ4_uncompress_unknownOutputSize (const char* source, char* dest, int isize, int maxOutputSize);
   467 
   468 /* Obsolete streaming functions; use new streaming interface whenever possible */
   469 LZ4_DEPRECATED("use LZ4_createStream() instead") LZ4LIB_API void* LZ4_create (char* inputBuffer);
   470 LZ4_DEPRECATED("use LZ4_createStream() instead") LZ4LIB_API int   LZ4_sizeofStreamState(void);
   471 LZ4_DEPRECATED("use LZ4_resetStream() instead") LZ4LIB_API  int   LZ4_resetStreamState(void* state, char* inputBuffer);
   472 LZ4_DEPRECATED("use LZ4_saveDict() instead") LZ4LIB_API     char* LZ4_slideInputBuffer (void* state);
   473 
   474 /* Obsolete streaming decoding functions */
   475 LZ4_DEPRECATED("use LZ4_decompress_safe_usingDict() instead") LZ4LIB_API int LZ4_decompress_safe_withPrefix64k (const char* src, char* dst, int compressedSize, int maxDstSize);
   476 LZ4_DEPRECATED("use LZ4_decompress_fast_usingDict() instead") LZ4LIB_API int LZ4_decompress_fast_withPrefix64k (const char* src, char* dst, int originalSize);
   477 
   478 #define isLz4CompiledWithCurrentLisheepyVersion true
   479 
   480 #endif /* LZ4_H_2983827168210 */
   481 
   482 
   483 #if defined (__cplusplus)
   484 }
   485 #endif