2014-07-10 16:56:26 +04:00
/*
2017-09-12 16:00:37 +03:00
* LZ4 - Fast LZ compression algorithm
* Header File
* Copyright ( C ) 2011 - 2017 , Yann Collet .
2014-07-10 16:56:26 +04:00
BSD 2 - Clause License ( http : //www.opensource.org/licenses/bsd-license.php)
Redistribution and use in source and binary forms , with or without
modification , are permitted provided that the following conditions are
met :
* Redistributions of source code must retain the above copyright
notice , this list of conditions and the following disclaimer .
* Redistributions in binary form must reproduce the above
copyright notice , this list of conditions and the following disclaimer
in the documentation and / or other materials provided with the
distribution .
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
" AS IS " AND ANY EXPRESS OR IMPLIED WARRANTIES , INCLUDING , BUT NOT
LIMITED TO , THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED . IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT , INDIRECT , INCIDENTAL ,
SPECIAL , EXEMPLARY , OR CONSEQUENTIAL DAMAGES ( INCLUDING , BUT NOT
LIMITED TO , PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES ; LOSS OF USE ,
DATA , OR PROFITS ; OR BUSINESS INTERRUPTION ) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY , WHETHER IN CONTRACT , STRICT LIABILITY , OR TORT
( INCLUDING NEGLIGENCE OR OTHERWISE ) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE , EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE .
You can contact the author at :
2017-09-12 16:00:37 +03:00
- LZ4 homepage : http : //www.lz4.org
- LZ4 source repository : https : //github.com/lz4/lz4
2014-07-10 16:56:26 +04:00
*/
# if defined (__cplusplus)
extern " C " {
# endif
2017-09-12 16:00:37 +03:00
# ifndef LZ4_H_2983827168210
# define LZ4_H_2983827168210
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/* --- Dependency --- */
# include <stddef.h> /* size_t */
/**
Introduction
LZ4 is lossless compression algorithm , providing compression speed at 400 MB / s per core ,
scalable with multi - cores CPU . It features an extremely fast decoder , with speed in
multiple GB / s per core , typically reaching RAM speed limits on multi - core systems .
The LZ4 compression library provides in - memory compression and decompression functions .
Compression can be done in :
- a single step ( described as Simple Functions )
- a single step , reusing a context ( described in Advanced Functions )
- unbounded multiple steps ( described as Streaming compression )
lz4 . h provides block compression functions . It gives full buffer control to user .
Decompressing an lz4 - compressed block also requires metadata ( such as compressed size ) .
Each application is free to encode such metadata in whichever way it wants .
An additional format , called LZ4 frame specification ( doc / lz4_Frame_format . md ) ,
take care of encoding standard metadata alongside LZ4 - compressed blocks .
If your application requires interoperability , it ' s recommended to use it .
A library is provided to take care of it , see lz4frame . h .
*/
/*^***************************************************************
* Export parameters
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
* LZ4_DLL_EXPORT :
* Enable exporting of functions when building a Windows DLL
2017-11-15 06:51:01 +03:00
* LZ4LIB_VISIBILITY :
2017-09-12 16:00:37 +03:00
* Control library symbols visibility .
*/
2017-11-15 06:51:01 +03:00
# ifndef LZ4LIB_VISIBILITY
# if defined(__GNUC__) && (__GNUC__ >= 4)
# define LZ4LIB_VISIBILITY __attribute__ ((visibility ("default")))
# else
# define LZ4LIB_VISIBILITY
# endif
# endif
2017-09-12 16:00:37 +03:00
# if defined(LZ4_DLL_EXPORT) && (LZ4_DLL_EXPORT==1)
2017-11-15 06:51:01 +03:00
# define LZ4LIB_API __declspec(dllexport) LZ4LIB_VISIBILITY
2017-09-12 16:00:37 +03:00
# elif defined(LZ4_DLL_IMPORT) && (LZ4_DLL_IMPORT==1)
2017-11-15 06:51:01 +03:00
# 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.*/
2017-09-12 16:00:37 +03:00
# else
2017-11-15 06:51:01 +03:00
# define LZ4LIB_API LZ4LIB_VISIBILITY
2017-09-12 16:00:37 +03:00
# endif
/*------ Version ------*/
# define LZ4_VERSION_MAJOR 1 /* for breaking interface changes */
# define LZ4_VERSION_MINOR 8 /* for new (non-breaking) interface capabilities */
2018-01-22 16:48:44 +03:00
# define LZ4_VERSION_RELEASE 1 /* for tweaks, bug-fixes, or development */
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
# define LZ4_VERSION_NUMBER (LZ4_VERSION_MAJOR *100*100 + LZ4_VERSION_MINOR *100 + LZ4_VERSION_RELEASE)
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
# define LZ4_LIB_VERSION LZ4_VERSION_MAJOR.LZ4_VERSION_MINOR.LZ4_VERSION_RELEASE
# define LZ4_QUOTE(str) #str
# define LZ4_EXPAND_AND_QUOTE(str) LZ4_QUOTE(str)
# define LZ4_VERSION_STRING LZ4_EXPAND_AND_QUOTE(LZ4_LIB_VERSION)
LZ4LIB_API int LZ4_versionNumber ( void ) ; /**< library version number; to be used when checking dll version */
LZ4LIB_API const char * LZ4_versionString ( void ) ; /**< library version string; to be used when checking dll version */
/*-************************************
* Tuning parameter
2014-07-10 16:56:26 +04:00
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
2017-09-12 16:00:37 +03:00
/*!
2014-07-10 16:56:26 +04:00
* LZ4_MEMORY_USAGE :
* Memory usage formula : N - > 2 ^ N Bytes ( examples : 10 - > 1 KB ; 12 - > 4 KB ; 16 - > 64 KB ; 20 - > 1 MB ; etc . )
* Increasing memory usage improves compression ratio
* Reduced memory usage can improve speed , due to cache effect
* Default value is 14 , for 16 KB , which nicely fits into Intel x86 L1 cache
*/
2017-09-12 16:00:37 +03:00
# ifndef LZ4_MEMORY_USAGE
# define LZ4_MEMORY_USAGE 14
# endif
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*-************************************
* Simple Functions
2014-07-10 16:56:26 +04:00
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
2017-09-12 16:00:37 +03:00
/*! LZ4_compress_default() :
2018-01-22 16:48:44 +03:00
Compresses ' srcSize ' bytes from buffer ' src '
into already allocated ' dst ' buffer of size ' dstCapacity ' .
Compression is guaranteed to succeed if ' dstCapacity ' > = LZ4_compressBound ( srcSize ) .
2017-09-12 16:00:37 +03:00
It also runs faster , so it ' s a recommended setting .
2018-01-22 16:48:44 +03:00
If the function cannot compress ' src ' into a limited ' dst ' budget ,
2017-09-12 16:00:37 +03:00
compression stops * immediately * , and the function result is zero .
2018-01-22 16:48:44 +03:00
As a consequence , ' dst ' content is not valid .
This function never writes outside ' dst ' buffer , nor read outside ' source ' buffer .
srcSize : supported max value is LZ4_MAX_INPUT_VALUE
dstCapacity : full or partial size of buffer ' dst ' ( which must be already allocated )
return : the number of bytes written into buffer ' dst ' ( necessarily < = dstCapacity )
or 0 if compression fails */
LZ4LIB_API int LZ4_compress_default ( const char * src , char * dst , int srcSize , int dstCapacity ) ;
2017-09-12 16:00:37 +03:00
/*! LZ4_decompress_safe() :
2018-01-22 16:48:44 +03:00
compressedSize : is the exact complete size of the compressed block .
dstCapacity : is the size of destination buffer , which must be already allocated .
return : the number of bytes decompressed into destination buffer ( necessarily < = dstCapacity )
If destination buffer is not large enough , decoding will stop and output an error code ( negative value ) .
2014-07-10 16:56:26 +04:00
If the source stream is detected malformed , the function will stop decoding and return a negative result .
2017-09-12 16:00:37 +03:00
This function is protected against buffer overflow exploits , including malicious data packets .
It never writes outside output buffer , nor reads outside input buffer .
2014-07-10 16:56:26 +04:00
*/
2018-01-22 16:48:44 +03:00
LZ4LIB_API int LZ4_decompress_safe ( const char * src , char * dst , int compressedSize , int dstCapacity ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*-************************************
* Advanced Functions
2014-07-10 16:56:26 +04:00
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
# define LZ4_MAX_INPUT_SIZE 0x7E000000 /* 2 113 929 216 bytes */
2017-09-12 16:00:37 +03:00
# define LZ4_COMPRESSBOUND(isize) ((unsigned)(isize) > (unsigned)LZ4_MAX_INPUT_SIZE ? 0 : (isize) + ((isize) / 255) + 16)
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*!
2014-07-10 16:56:26 +04:00
LZ4_compressBound ( ) :
2017-09-12 16:00:37 +03:00
Provides the maximum size that LZ4 compression may output in a " worst case " scenario ( input data not compressible )
This function is primarily useful for memory allocation purposes ( destination buffer size ) .
Macro LZ4_COMPRESSBOUND ( ) is also provided for compilation - time evaluation ( stack memory allocation for example ) .
Note that LZ4_compress_default ( ) compress faster when dest buffer size is > = LZ4_compressBound ( srcSize )
inputSize : max supported value is LZ4_MAX_INPUT_SIZE
return : maximum output size in a " worst case " scenario
or 0 , if input size is too large ( > LZ4_MAX_INPUT_SIZE )
*/
LZ4LIB_API int LZ4_compressBound ( int inputSize ) ;
/*!
LZ4_compress_fast ( ) :
Same as LZ4_compress_default ( ) , but allows to select an " acceleration " factor .
The larger the acceleration value , the faster the algorithm , but also the lesser the compression .
It ' s a trade - off . It can be fine tuned , with each successive value providing roughly + ~ 3 % to speed .
An acceleration value of " 1 " is the same as regular LZ4_compress_default ( )
Values < = 0 will be replaced by ACCELERATION_DEFAULT ( see lz4 . c ) , which is 1.
2014-07-10 16:56:26 +04:00
*/
2018-01-22 16:48:44 +03:00
LZ4LIB_API int LZ4_compress_fast ( const char * src , char * dst , int srcSize , int dstCapacity , int acceleration ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*!
LZ4_compress_fast_extState ( ) :
Same compression function , just using an externally allocated memory space to store compression state .
Use LZ4_sizeofState ( ) to know how much memory must be allocated ,
and allocate it on 8 - bytes boundaries ( using malloc ( ) typically ) .
Then , provide it as ' void * state ' to compression function .
*/
LZ4LIB_API int LZ4_sizeofState ( void ) ;
2018-01-22 16:48:44 +03:00
LZ4LIB_API int LZ4_compress_fast_extState ( void * state , const char * src , char * dst , int srcSize , int dstCapacity , int acceleration ) ;
2017-09-12 16:00:37 +03:00
/*!
LZ4_compress_destSize ( ) :
2018-01-22 16:48:44 +03:00
Reverse the logic : compresses as much data as possible from ' src ' buffer
into already allocated buffer ' dst ' of size ' targetDestSize ' .
This function either compresses the entire ' src ' content into ' dst ' if it ' s large enough ,
or fill ' dst ' buffer completely with as much data as possible from ' src ' .
* srcSizePtr : will be modified to indicate how many bytes where read from ' src ' to fill ' dst ' .
New value is necessarily < = old value .
return : Nb bytes written into ' dst ' ( necessarily < = targetDestSize )
or 0 if compression fails
2014-07-10 16:56:26 +04:00
*/
2018-01-22 16:48:44 +03:00
LZ4LIB_API int LZ4_compress_destSize ( const char * src , char * dst , int * srcSizePtr , int targetDstSize ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*!
2018-01-22 16:48:44 +03:00
LZ4_decompress_fast ( ) : ( unsafe ! ! )
originalSize : is the original uncompressed size
2014-07-10 16:56:26 +04:00
return : the number of bytes read from the source buffer ( in other words , the compressed size )
2017-09-12 16:00:37 +03:00
If the source stream is detected malformed , the function will stop decoding and return a negative result .
2018-01-22 16:48:44 +03:00
Destination buffer must be already allocated . Its size must be > = ' originalSize ' bytes .
note : This function respects memory boundaries for * properly formed * compressed data .
2017-09-12 16:00:37 +03:00
It is a bit faster than LZ4_decompress_safe ( ) .
However , it does not provide any protection against intentionally modified data stream ( malicious input ) .
Use this function in trusted environment only ( data to decode comes from a trusted source ) .
2014-07-10 16:56:26 +04:00
*/
2018-01-22 16:48:44 +03:00
LZ4LIB_API int LZ4_decompress_fast ( const char * src , char * dst , int originalSize ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*!
2014-07-10 16:56:26 +04:00
LZ4_decompress_safe_partial ( ) :
2018-01-22 16:48:44 +03:00
This function decompress a compressed block of size ' srcSize ' at position ' src '
into destination buffer ' dst ' of size ' dstCapacity ' .
The function will decompress a minimum of ' targetOutputSize ' bytes , and stop after that .
However , it ' s not accurate , and may write more than ' targetOutputSize ' ( but < = dstCapacity ) .
@ return : the number of bytes decoded in the destination buffer ( necessarily < = dstCapacity )
Note : this number can be < ' targetOutputSize ' should the compressed block contain less data .
2014-07-10 16:56:26 +04:00
Always control how many bytes were decoded .
If the source stream is detected malformed , the function will stop decoding and return a negative result .
2018-01-22 16:48:44 +03:00
This function never writes outside of output buffer , and never reads outside of input buffer . It is therefore protected against malicious data packets .
2014-07-10 16:56:26 +04:00
*/
2018-01-22 16:48:44 +03:00
LZ4LIB_API int LZ4_decompress_safe_partial ( const char * src , char * dst , int srcSize , int targetOutputSize , int dstCapacity ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*-*********************************************
* Streaming Compression Functions
2014-07-10 16:56:26 +04:00
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
2017-09-12 16:00:37 +03:00
typedef union LZ4_stream_u LZ4_stream_t ; /* incomplete type (defined later) */
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*! LZ4_createStream() and LZ4_freeStream() :
* LZ4_createStream ( ) will allocate and initialize an ` LZ4_stream_t ` structure .
* LZ4_freeStream ( ) releases its memory .
2014-07-10 16:56:26 +04:00
*/
2017-09-12 16:00:37 +03:00
LZ4LIB_API LZ4_stream_t * LZ4_createStream ( void ) ;
LZ4LIB_API int LZ4_freeStream ( LZ4_stream_t * streamPtr ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*! LZ4_resetStream() :
* An LZ4_stream_t structure can be allocated once and re - used multiple times .
2018-01-22 16:48:44 +03:00
* Use this function to start compressing a new stream .
2014-07-10 16:56:26 +04:00
*/
2017-09-12 16:00:37 +03:00
LZ4LIB_API void LZ4_resetStream ( LZ4_stream_t * streamPtr ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*! LZ4_loadDict() :
2018-01-22 16:48:44 +03:00
* Use this function to load a static dictionary into LZ4_stream_t .
2017-09-12 16:00:37 +03:00
* Any previous data will be forgotten , only ' dictionary ' will remain in memory .
2018-01-22 16:48:44 +03:00
* Loading a size of 0 is allowed , and is the same as reset .
* @ return : dictionary size , in bytes ( necessarily < = 64 KB )
2014-07-10 16:56:26 +04:00
*/
2017-09-12 16:00:37 +03:00
LZ4LIB_API int LZ4_loadDict ( LZ4_stream_t * streamPtr , const char * dictionary , int dictSize ) ;
/*! LZ4_compress_fast_continue() :
2018-01-22 16:48:44 +03:00
* Compress content into ' src ' using data from previously compressed blocks , improving compression ratio .
2017-09-12 16:00:37 +03:00
* ' dst ' buffer must be already allocated .
* If dstCapacity > = LZ4_compressBound ( srcSize ) , compression is guaranteed to succeed , and runs faster .
2018-01-22 16:48:44 +03:00
*
* Important : Up to 64 KB of previously compressed data is assumed to remain present and unmodified in memory !
* Special 1 : If input buffer is a double - buffer , it can have any size , including < 64 KB .
* Special 2 : If input buffer is a ring - buffer , it can have any size , including < 64 KB .
*
* @ return : size of compressed block
* or 0 if there is an error ( typically , compressed data cannot fit into ' dst ' )
2017-09-12 16:00:37 +03:00
* After an error , the stream status is invalid , it can only be reset or freed .
2014-07-10 16:56:26 +04:00
*/
2017-09-12 16:00:37 +03:00
LZ4LIB_API int LZ4_compress_fast_continue ( LZ4_stream_t * streamPtr , const char * src , char * dst , int srcSize , int dstCapacity , int acceleration ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*! LZ4_saveDict() :
* If previously compressed data block is not guaranteed to remain available at its current memory location ,
* save it into a safer place ( char * safeBuffer ) .
* Note : it ' s not necessary to call LZ4_loadDict ( ) after LZ4_saveDict ( ) , dictionary is immediately usable .
* @ return : saved dictionary size in bytes ( necessarily < = dictSize ) , or 0 if error .
2014-07-10 16:56:26 +04:00
*/
2017-09-12 16:00:37 +03:00
LZ4LIB_API int LZ4_saveDict ( LZ4_stream_t * streamPtr , char * safeBuffer , int dictSize ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*-**********************************************
* Streaming Decompression Functions
* Bufferless synchronous API
2014-07-10 16:56:26 +04:00
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
2017-09-12 16:00:37 +03:00
typedef union LZ4_streamDecode_u LZ4_streamDecode_t ; /* incomplete type (defined later) */
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*! LZ4_createStreamDecode() and LZ4_freeStreamDecode() :
2018-01-22 16:48:44 +03:00
* creation / destruction of streaming decompression tracking structure .
* A tracking structure can be re - used multiple times sequentially . */
2017-09-12 16:00:37 +03:00
LZ4LIB_API LZ4_streamDecode_t * LZ4_createStreamDecode ( void ) ;
LZ4LIB_API int LZ4_freeStreamDecode ( LZ4_streamDecode_t * LZ4_stream ) ;
/*! LZ4_setStreamDecode() :
2018-01-22 16:48:44 +03:00
* An LZ4_streamDecode_t structure can be allocated once and re - used multiple times .
* Use this function to start decompression of a new stream of blocks .
* A dictionary can optionnally be set . Use NULL or size 0 for a simple reset order .
* @ return : 1 if OK , 0 if error
2014-07-10 16:56:26 +04:00
*/
2017-09-12 16:00:37 +03:00
LZ4LIB_API int LZ4_setStreamDecode ( LZ4_streamDecode_t * LZ4_streamDecode , const char * dictionary , int dictSize ) ;
/*! LZ4_decompress_*_continue() :
2018-01-22 16:48:44 +03:00
* These decoding functions allow decompression of consecutive blocks in " streaming " mode .
* A block is an unsplittable entity , it must be presented entirely to a decompression function .
* Decompression functions only accept one block at a time .
* Previously decoded blocks * must * remain available at the memory position where they were decoded ( up to 64 KB ) .
*
* Special : if application sets a ring buffer for decompression , it must respect one of the following conditions :
2017-09-12 16:00:37 +03:00
* - Exactly same size as encoding buffer , with same update rule ( block boundaries at same positions )
* In which case , the decoding & encoding ring buffer can have any size , including very small ones ( < 64 KB ) .
* - Larger than encoding buffer , by a minimum of maxBlockSize more bytes .
2018-01-22 16:48:44 +03:00
* maxBlockSize is implementation dependent . It ' s the maximum size of any single block .
2017-09-12 16:00:37 +03:00
* In which case , encoding and decoding buffers do not need to be synchronized ,
* and encoding ring buffer can have any size , including small ones ( < 64 KB ) .
* - _At least_ 64 KB + 8 bytes + maxBlockSize .
* In which case , encoding and decoding buffers do not need to be synchronized ,
* and encoding ring buffer can have any size , including larger than decoding buffer .
* Whenever these conditions are not possible , save the last 64 KB of decoded data into a safe buffer ,
2018-01-22 16:48:44 +03:00
* and indicate where it is saved using LZ4_setStreamDecode ( ) before decompressing next block .
2017-09-12 16:00:37 +03:00
*/
2018-01-22 16:48:44 +03:00
LZ4LIB_API int LZ4_decompress_safe_continue ( LZ4_streamDecode_t * LZ4_streamDecode , const char * src , char * dst , int srcSize , int dstCapacity ) ;
LZ4LIB_API int LZ4_decompress_fast_continue ( LZ4_streamDecode_t * LZ4_streamDecode , const char * src , char * dst , int originalSize ) ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*! LZ4_decompress_*_usingDict() :
* These decoding functions work the same as
* a combination of LZ4_setStreamDecode ( ) followed by LZ4_decompress_ * _continue ( )
* They are stand - alone , and don ' t need an LZ4_streamDecode_t structure .
2014-07-10 16:56:26 +04:00
*/
2018-01-22 16:48:44 +03:00
LZ4LIB_API int LZ4_decompress_safe_usingDict ( const char * src , char * dst , int srcSize , int dstCapcity , const char * dictStart , int dictSize ) ;
LZ4LIB_API int LZ4_decompress_fast_usingDict ( const char * src , char * dst , int originalSize , const char * dictStart , int dictSize ) ;
2017-09-12 16:00:37 +03:00
/*^**********************************************
* ! ! ! ! ! ! STATIC LINKING ONLY ! ! ! ! ! !
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*-************************************
* Private definitions
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* Do not use these definitions .
* They are exposed to allow static allocation of ` LZ4_stream_t ` and ` LZ4_streamDecode_t ` .
* Using these definitions will expose code to API and / or ABI break in future versions of the library .
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
# define LZ4_HASHLOG (LZ4_MEMORY_USAGE-2)
# define LZ4_HASHTABLESIZE (1 << LZ4_MEMORY_USAGE)
# define LZ4_HASH_SIZE_U32 (1 << LZ4_HASHLOG) /* required as macro for static allocation */
# if defined(__cplusplus) || (defined (__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) /* C99 */ )
# include <stdint.h>
typedef struct {
uint32_t hashTable [ LZ4_HASH_SIZE_U32 ] ;
uint32_t currentOffset ;
uint32_t initCheck ;
const uint8_t * dictionary ;
uint8_t * bufferStart ; /* obsolete, used for slideInputBuffer */
uint32_t dictSize ;
} LZ4_stream_t_internal ;
typedef struct {
const uint8_t * externalDict ;
size_t extDictSize ;
const uint8_t * prefixEnd ;
size_t prefixSize ;
} LZ4_streamDecode_t_internal ;
# else
typedef struct {
unsigned int hashTable [ LZ4_HASH_SIZE_U32 ] ;
unsigned int currentOffset ;
unsigned int initCheck ;
const unsigned char * dictionary ;
unsigned char * bufferStart ; /* obsolete, used for slideInputBuffer */
unsigned int dictSize ;
} LZ4_stream_t_internal ;
typedef struct {
const unsigned char * externalDict ;
size_t extDictSize ;
const unsigned char * prefixEnd ;
size_t prefixSize ;
} LZ4_streamDecode_t_internal ;
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
# endif
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*!
* LZ4_stream_t :
* information structure to track an LZ4 stream .
* init this structure before first use .
* note : only use in association with static linking !
* this definition is not API / ABI safe ,
* it may change in a future version !
2014-07-10 16:56:26 +04:00
*/
2017-09-12 16:00:37 +03:00
# define LZ4_STREAMSIZE_U64 ((1 << (LZ4_MEMORY_USAGE-3)) + 4)
# define LZ4_STREAMSIZE (LZ4_STREAMSIZE_U64 * sizeof(unsigned long long))
union LZ4_stream_u {
unsigned long long table [ LZ4_STREAMSIZE_U64 ] ;
LZ4_stream_t_internal internal_donotuse ;
} ; /* previously typedef'd to LZ4_stream_t */
/*!
* LZ4_streamDecode_t :
* information structure to track an LZ4 stream during decompression .
* init this structure using LZ4_setStreamDecode ( or memset ( ) ) before first use
* note : only use in association with static linking !
* this definition is not API / ABI safe ,
* and may change in a future version !
*/
# define LZ4_STREAMDECODESIZE_U64 4
# define LZ4_STREAMDECODESIZE (LZ4_STREAMDECODESIZE_U64 * sizeof(unsigned long long))
union LZ4_streamDecode_u {
unsigned long long table [ LZ4_STREAMDECODESIZE_U64 ] ;
LZ4_streamDecode_t_internal internal_donotuse ;
} ; /* previously typedef'd to LZ4_streamDecode_t */
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*-************************************
* Obsolete Functions
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
2014-07-10 16:56:26 +04:00
2017-09-12 16:00:37 +03:00
/*! Deprecation warnings
Should deprecation warnings be a problem ,
it is generally possible to disable them ,
typically with - Wno - deprecated - declarations for gcc
or _CRT_SECURE_NO_WARNINGS in Visual .
Otherwise , it ' s also possible to define LZ4_DISABLE_DEPRECATE_WARNINGS */
# ifdef LZ4_DISABLE_DEPRECATE_WARNINGS
# define LZ4_DEPRECATED(message) /* disable deprecation warnings */
# else
# define LZ4_GCC_VERSION (__GNUC__ * 100 + __GNUC_MINOR__)
2017-10-30 17:12:38 +03:00
# if defined(__clang__) /* clang doesn't handle mixed C++11 and CNU attributes */
# define LZ4_DEPRECATED(message) __attribute__((deprecated(message)))
# elif defined (__cplusplus) && (__cplusplus >= 201402) /* C++14 or greater */
2017-09-12 16:00:37 +03:00
# define LZ4_DEPRECATED(message) [[deprecated(message)]]
2017-10-30 17:12:38 +03:00
# elif (LZ4_GCC_VERSION >= 405)
2017-09-12 16:00:37 +03:00
# define LZ4_DEPRECATED(message) __attribute__((deprecated(message)))
# elif (LZ4_GCC_VERSION >= 301)
# define LZ4_DEPRECATED(message) __attribute__((deprecated))
# elif defined(_MSC_VER)
# define LZ4_DEPRECATED(message) __declspec(deprecated(message))
# else
# pragma message("WARNING: You need to implement LZ4_DEPRECATED for this compiler")
# define LZ4_DEPRECATED(message)
# endif
# endif /* LZ4_DISABLE_DEPRECATE_WARNINGS */
/* Obsolete compression functions */
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_compress_default() instead " ) int LZ4_compress (const char* source, char* dest, int sourceSize) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_compress_default() instead " ) int LZ4_compress_limitedOutput (const char* source, char* dest, int sourceSize, int maxOutputSize) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_compress_fast_extState() instead " ) int LZ4_compress_withState (void* state, const char* source, char* dest, int inputSize) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_compress_fast_extState() instead " ) int LZ4_compress_limitedOutput_withState (void* state, const char* source, char* dest, int inputSize, int maxOutputSize) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_compress_fast_continue() instead " ) int LZ4_compress_continue (LZ4_stream_t* LZ4_streamPtr, const char* source, char* dest, int inputSize) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_compress_fast_continue() instead " ) int LZ4_compress_limitedOutput_continue (LZ4_stream_t* LZ4_streamPtr, const char* source, char* dest, int inputSize, int maxOutputSize) ;
/* Obsolete decompression functions */
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_decompress_fast() instead " ) int LZ4_uncompress (const char* source, char* dest, int outputSize) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_decompress_safe() instead " ) int LZ4_uncompress_unknownOutputSize (const char* source, char* dest, int isize, int maxOutputSize) ;
/* Obsolete streaming functions; use new streaming interface whenever possible */
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_createStream() instead " ) void* LZ4_create (char* inputBuffer) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_createStream() instead " ) int LZ4_sizeofStreamState(void) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_resetStream() instead " ) int LZ4_resetStreamState(void* state, char* inputBuffer) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_saveDict() instead " ) char* LZ4_slideInputBuffer (void* state) ;
/* Obsolete streaming decoding functions */
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_decompress_safe_usingDict() instead " ) int LZ4_decompress_safe_withPrefix64k (const char* src, char* dst, int compressedSize, int maxDstSize) ;
LZ4LIB_API LZ4_DEPRECATED ( " use LZ4_decompress_fast_usingDict() instead " ) int LZ4_decompress_fast_withPrefix64k (const char* src, char* dst, int originalSize) ;
# endif /* LZ4_H_2983827168210 */
2014-07-10 16:56:26 +04:00
# if defined (__cplusplus)
}
# endif