1*a28cd43dSSascha Wildner /*
2*a28cd43dSSascha Wildner * Copyright (c) 2016-2020, Yann Collet, Facebook, Inc.
3*a28cd43dSSascha Wildner * All rights reserved.
4*a28cd43dSSascha Wildner *
5*a28cd43dSSascha Wildner * This source code is licensed under both the BSD-style license (found in the
6*a28cd43dSSascha Wildner * LICENSE file in the root directory of this source tree) and the GPLv2 (found
7*a28cd43dSSascha Wildner * in the COPYING file in the root directory of this source tree).
8*a28cd43dSSascha Wildner * You may select, at your option, one of the above-listed licenses.
9*a28cd43dSSascha Wildner */
10*a28cd43dSSascha Wildner
11*a28cd43dSSascha Wildner
12*a28cd43dSSascha Wildner
13*a28cd43dSSascha Wildner /*-*************************************
14*a28cd43dSSascha Wildner * Dependencies
15*a28cd43dSSascha Wildner ***************************************/
16*a28cd43dSSascha Wildner #define ZSTD_DEPS_NEED_MALLOC
17*a28cd43dSSascha Wildner #include "zstd_deps.h" /* ZSTD_malloc, ZSTD_calloc, ZSTD_free, ZSTD_memset */
18*a28cd43dSSascha Wildner #include "error_private.h"
19*a28cd43dSSascha Wildner #include "zstd_internal.h"
20*a28cd43dSSascha Wildner
21*a28cd43dSSascha Wildner
22*a28cd43dSSascha Wildner /*-****************************************
23*a28cd43dSSascha Wildner * Version
24*a28cd43dSSascha Wildner ******************************************/
ZSTD_versionNumber(void)25*a28cd43dSSascha Wildner unsigned ZSTD_versionNumber(void) { return ZSTD_VERSION_NUMBER; }
26*a28cd43dSSascha Wildner
ZSTD_versionString(void)27*a28cd43dSSascha Wildner const char* ZSTD_versionString(void) { return ZSTD_VERSION_STRING; }
28*a28cd43dSSascha Wildner
29*a28cd43dSSascha Wildner
30*a28cd43dSSascha Wildner /*-****************************************
31*a28cd43dSSascha Wildner * ZSTD Error Management
32*a28cd43dSSascha Wildner ******************************************/
33*a28cd43dSSascha Wildner #undef ZSTD_isError /* defined within zstd_internal.h */
34*a28cd43dSSascha Wildner /*! ZSTD_isError() :
35*a28cd43dSSascha Wildner * tells if a return value is an error code
36*a28cd43dSSascha Wildner * symbol is required for external callers */
ZSTD_isError(size_t code)37*a28cd43dSSascha Wildner unsigned ZSTD_isError(size_t code) { return ERR_isError(code); }
38*a28cd43dSSascha Wildner
39*a28cd43dSSascha Wildner /*! ZSTD_getErrorName() :
40*a28cd43dSSascha Wildner * provides error code string from function result (useful for debugging) */
ZSTD_getErrorName(size_t code)41*a28cd43dSSascha Wildner const char* ZSTD_getErrorName(size_t code) { return ERR_getErrorName(code); }
42*a28cd43dSSascha Wildner
43*a28cd43dSSascha Wildner /*! ZSTD_getError() :
44*a28cd43dSSascha Wildner * convert a `size_t` function result into a proper ZSTD_errorCode enum */
ZSTD_getErrorCode(size_t code)45*a28cd43dSSascha Wildner ZSTD_ErrorCode ZSTD_getErrorCode(size_t code) { return ERR_getErrorCode(code); }
46*a28cd43dSSascha Wildner
47*a28cd43dSSascha Wildner /*! ZSTD_getErrorString() :
48*a28cd43dSSascha Wildner * provides error code string from enum */
ZSTD_getErrorString(ZSTD_ErrorCode code)49*a28cd43dSSascha Wildner const char* ZSTD_getErrorString(ZSTD_ErrorCode code) { return ERR_getErrorString(code); }
50*a28cd43dSSascha Wildner
51*a28cd43dSSascha Wildner
52*a28cd43dSSascha Wildner
53*a28cd43dSSascha Wildner /*=**************************************************************
54*a28cd43dSSascha Wildner * Custom allocator
55*a28cd43dSSascha Wildner ****************************************************************/
ZSTD_customMalloc(size_t size,ZSTD_customMem customMem)56*a28cd43dSSascha Wildner void* ZSTD_customMalloc(size_t size, ZSTD_customMem customMem)
57*a28cd43dSSascha Wildner {
58*a28cd43dSSascha Wildner if (customMem.customAlloc)
59*a28cd43dSSascha Wildner return customMem.customAlloc(customMem.opaque, size);
60*a28cd43dSSascha Wildner return ZSTD_malloc(size);
61*a28cd43dSSascha Wildner }
62*a28cd43dSSascha Wildner
ZSTD_customCalloc(size_t size,ZSTD_customMem customMem)63*a28cd43dSSascha Wildner void* ZSTD_customCalloc(size_t size, ZSTD_customMem customMem)
64*a28cd43dSSascha Wildner {
65*a28cd43dSSascha Wildner if (customMem.customAlloc) {
66*a28cd43dSSascha Wildner /* calloc implemented as malloc+memset;
67*a28cd43dSSascha Wildner * not as efficient as calloc, but next best guess for custom malloc */
68*a28cd43dSSascha Wildner void* const ptr = customMem.customAlloc(customMem.opaque, size);
69*a28cd43dSSascha Wildner ZSTD_memset(ptr, 0, size);
70*a28cd43dSSascha Wildner return ptr;
71*a28cd43dSSascha Wildner }
72*a28cd43dSSascha Wildner return ZSTD_calloc(1, size);
73*a28cd43dSSascha Wildner }
74*a28cd43dSSascha Wildner
ZSTD_customFree(void * ptr,ZSTD_customMem customMem)75*a28cd43dSSascha Wildner void ZSTD_customFree(void* ptr, ZSTD_customMem customMem)
76*a28cd43dSSascha Wildner {
77*a28cd43dSSascha Wildner if (ptr!=NULL) {
78*a28cd43dSSascha Wildner if (customMem.customFree)
79*a28cd43dSSascha Wildner customMem.customFree(customMem.opaque, ptr);
80*a28cd43dSSascha Wildner else
81*a28cd43dSSascha Wildner ZSTD_free(ptr);
82*a28cd43dSSascha Wildner }
83*a28cd43dSSascha Wildner }
84