Renamed celt_word* to opus_val*
[opus.git] / libcelt / os_support.h
1 /* Copyright (C) 2007 Jean-Marc Valin
2       
3    File: os_support.h
4    This is the (tiny) OS abstraction layer. Aside from math.h, this is the
5    only place where system headers are allowed.
6
7    Redistribution and use in source and binary forms, with or without
8    modification, are permitted provided that the following conditions are
9    met:
10
11    1. Redistributions of source code must retain the above copyright notice,
12    this list of conditions and the following disclaimer.
13
14    2. Redistributions in binary form must reproduce the above copyright
15    notice, this list of conditions and the following disclaimer in the
16    documentation and/or other materials provided with the distribution.
17
18    THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19    IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20    OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21    DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
22    INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
23    (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25    HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
26    STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
27    ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28    POSSIBILITY OF SUCH DAMAGE.
29 */
30
31 #ifndef OS_SUPPORT_H
32 #define OS_SUPPORT_H
33
34 #ifdef CUSTOM_SUPPORT
35 #  include "custom_support.h"
36 #endif
37
38 #include <string.h>
39 #include <stdio.h>
40 #include <stdlib.h>
41
42 /** CELT wrapper for calloc(). To do your own dynamic allocation, all you need to do is replace this function, celt_realloc and celt_free 
43     NOTE: celt_alloc needs to CLEAR THE MEMORY */
44 #ifndef OVERRIDE_CELT_ALLOC
45 static inline void *celt_alloc (int size)
46 {
47    /* WARNING: this is not equivalent to malloc(). If you want to use malloc() 
48       or your own allocator, YOU NEED TO CLEAR THE MEMORY ALLOCATED. Otherwise
49       you will experience strange bugs */
50    return calloc(size,1);
51 }
52 #endif
53
54 /** Same as celt_alloc(), except that the area is only needed inside a CELT call (might cause problem with wideband though) */
55 #ifndef OVERRIDE_CELT_ALLOC_SCRATCH
56 static inline void *celt_alloc_scratch (int size)
57 {
58    /* Scratch space doesn't need to be cleared */
59    return calloc(size,1);
60 }
61 #endif
62
63 /** CELT wrapper for free(). To do your own dynamic allocation, all you need to do is replace this function, celt_realloc and celt_alloc */
64 #ifndef OVERRIDE_CELT_FREE
65 static inline void celt_free (void *ptr)
66 {
67    free(ptr);
68 }
69 #endif
70
71 /** Same as celt_free(), except that the area is only needed inside a CELT call (might cause problem with wideband though) */
72 #ifndef OVERRIDE_CELT_FREE_SCRATCH
73 static inline void celt_free_scratch (void *ptr)
74 {
75    free(ptr);
76 }
77 #endif
78
79 /** Copy n bytes of memory from src to dst. The 0* term provides compile-time type checking  */
80 #ifndef OVERRIDE_CELT_COPY
81 #define CELT_COPY(dst, src, n) (memcpy((dst), (src), (n)*sizeof(*(dst)) + 0*((dst)-(src)) ))
82 #endif
83
84 /** Copy n bytes of memory from src to dst, allowing overlapping regions. The 0* term 
85     provides compile-time type checking */
86 #ifndef OVERRIDE_CELT_MOVE
87 #define CELT_MOVE(dst, src, n) (memmove((dst), (src), (n)*sizeof(*(dst)) + 0*((dst)-(src)) ))
88 #endif
89
90 /** Set n bytes of memory to value of c, starting at address s */
91 #ifndef OVERRIDE_CELT_MEMSET
92 #define CELT_MEMSET(dst, c, n) (memset((dst), (c), (n)*sizeof(*(dst))))
93 #endif
94
95 /*#ifdef __GNUC__
96 #pragma GCC poison printf sprintf
97 #pragma GCC poison malloc free realloc calloc
98 #endif*/
99
100 #endif /* OS_SUPPORT_H */
101