1 /*
2 * Copyright (c) 2016-2020, 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
11
12
13 /*-*************************************
14 * Dependencies
15 ***************************************/
16 #include <stdlib.h> /* malloc, calloc, free */
17 #include <string.h> /* memset */
18 #include "error_private.h"
19 #include "zstd_internal.h"
20
21
22 /*-****************************************
23 * Version
24 ******************************************/
ZSTD_versionNumber(void)25 unsigned ZSTD_versionNumber(void) { return ZSTD_VERSION_NUMBER; }
26
ZSTD_versionString(void)27 const char* ZSTD_versionString(void) { return ZSTD_VERSION_STRING; }
28
29
30 /*-****************************************
31 * ZSTD Error Management
32 ******************************************/
33 #undef ZSTD_isError /* defined within zstd_internal.h */
34 /*! ZSTD_isError() :
35 * tells if a return value is an error code
36 * symbol is required for external callers */
ZSTD_isError(size_t code)37 unsigned ZSTD_isError(size_t code) { return ERR_isError(code); }
38
39 /*! ZSTD_getErrorName() :
40 * provides error code string from function result (useful for debugging) */
ZSTD_getErrorName(size_t code)41 const char* ZSTD_getErrorName(size_t code) { return ERR_getErrorName(code); }
42
43 /*! ZSTD_getError() :
44 * convert a `size_t` function result into a proper ZSTD_errorCode enum */
ZSTD_getErrorCode(size_t code)45 ZSTD_ErrorCode ZSTD_getErrorCode(size_t code) { return ERR_getErrorCode(code); }
46
47 /*! ZSTD_getErrorString() :
48 * provides error code string from enum */
ZSTD_getErrorString(ZSTD_ErrorCode code)49 const char* ZSTD_getErrorString(ZSTD_ErrorCode code) { return ERR_getErrorString(code); }
50
51
52
53 /*=**************************************************************
54 * Custom allocator
55 ****************************************************************/
ZSTD_malloc(size_t size,ZSTD_customMem customMem)56 void* ZSTD_malloc(size_t size, ZSTD_customMem customMem)
57 {
58 return customMem.customAlloc(customMem.opaque, size);
59 }
60
ZSTD_calloc(size_t size,ZSTD_customMem customMem)61 void* ZSTD_calloc(size_t size, ZSTD_customMem customMem)
62 {
63 /* calloc implemented as malloc+memset;
64 * not as efficient as calloc, but next best guess for custom malloc */
65 void* const ptr = customMem.customAlloc(customMem.opaque, size);
66 memset(ptr, 0, size);
67 return ptr;
68 }
69
ZSTD_free(void * ptr,ZSTD_customMem customMem)70 void ZSTD_free(void* ptr, ZSTD_customMem customMem)
71 {
72 if (ptr!=NULL)
73 customMem.customFree(customMem.opaque, ptr);
74 }
75