zstd_v01.h 3.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. /*
  2. * Copyright (c) 2016-present, Yann Collet, Facebook, Inc.
  3. * All rights reserved.
  4. *
  5. * This source code is licensed under both the BSD-style license (found in the
  6. * LICENSE file in the root directory of this source tree) and the GPLv2 (found
  7. * in the COPYING file in the root directory of this source tree).
  8. * You may select, at your option, one of the above-listed licenses.
  9. */
  10. #ifndef ZSTD_V01_H_28739879432
  11. #define ZSTD_V01_H_28739879432
  12. #if defined (__cplusplus)
  13. extern "C" {
  14. #endif
  15. /* *************************************
  16. * Includes
  17. ***************************************/
  18. #include <stddef.h> /* size_t */
  19. /* *************************************
  20. * Simple one-step function
  21. ***************************************/
  22. /**
  23. ZSTDv01_decompress() : decompress ZSTD frames compliant with v0.1.x format
  24. compressedSize : is the exact source size
  25. maxOriginalSize : is the size of the 'dst' buffer, which must be already allocated.
  26. It must be equal or larger than originalSize, otherwise decompression will fail.
  27. return : the number of bytes decompressed into destination buffer (originalSize)
  28. or an errorCode if it fails (which can be tested using ZSTDv01_isError())
  29. */
  30. size_t ZSTDv01_decompress( void* dst, size_t maxOriginalSize,
  31. const void* src, size_t compressedSize);
  32. /**
  33. ZSTDv01_getFrameSrcSize() : get the source length of a ZSTD frame compliant with v0.1.x format
  34. compressedSize : The size of the 'src' buffer, at least as large as the frame pointed to by 'src'
  35. return : the number of bytes that would be read to decompress this frame
  36. or an errorCode if it fails (which can be tested using ZSTDv01_isError())
  37. */
  38. size_t ZSTDv01_findFrameCompressedSize(const void* src, size_t compressedSize);
  39. /**
  40. ZSTDv01_isError() : tells if the result of ZSTDv01_decompress() is an error
  41. */
  42. unsigned ZSTDv01_isError(size_t code);
  43. /* *************************************
  44. * Advanced functions
  45. ***************************************/
  46. typedef struct ZSTDv01_Dctx_s ZSTDv01_Dctx;
  47. ZSTDv01_Dctx* ZSTDv01_createDCtx(void);
  48. size_t ZSTDv01_freeDCtx(ZSTDv01_Dctx* dctx);
  49. size_t ZSTDv01_decompressDCtx(void* ctx,
  50. void* dst, size_t maxOriginalSize,
  51. const void* src, size_t compressedSize);
  52. /* *************************************
  53. * Streaming functions
  54. ***************************************/
  55. size_t ZSTDv01_resetDCtx(ZSTDv01_Dctx* dctx);
  56. size_t ZSTDv01_nextSrcSizeToDecompress(ZSTDv01_Dctx* dctx);
  57. size_t ZSTDv01_decompressContinue(ZSTDv01_Dctx* dctx, void* dst, size_t maxDstSize, const void* src, size_t srcSize);
  58. /**
  59. Use above functions alternatively.
  60. ZSTD_nextSrcSizeToDecompress() tells how much bytes to provide as 'srcSize' to ZSTD_decompressContinue().
  61. ZSTD_decompressContinue() will use previous data blocks to improve compression if they are located prior to current block.
  62. Result is the number of bytes regenerated within 'dst'.
  63. It can be zero, which is not an error; it just means ZSTD_decompressContinue() has decoded some header.
  64. */
  65. /* *************************************
  66. * Prefix - version detection
  67. ***************************************/
  68. #define ZSTDv01_magicNumber 0xFD2FB51E /* Big Endian version */
  69. #define ZSTDv01_magicNumberLE 0x1EB52FFD /* Little Endian version */
  70. #if defined (__cplusplus)
  71. }
  72. #endif
  73. #endif /* ZSTD_V01_H_28739879432 */