Libav
mem.h
Go to the documentation of this file.
1 /*
2  * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at>
3  *
4  * This file is part of Libav.
5  *
6  * Libav is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * Libav is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with Libav; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
26 #ifndef AVUTIL_MEM_H
27 #define AVUTIL_MEM_H
28 
29 #include <limits.h>
30 #include <stdint.h>
31 
32 #include "attributes.h"
33 #include "avutil.h"
34 
41 #if defined(__ICC) && __ICC < 1200 || defined(__SUNPRO_C)
42  #define DECLARE_ALIGNED(n,t,v) t __attribute__ ((aligned (n))) v
43  #define DECLARE_ASM_CONST(n,t,v) const t __attribute__ ((aligned (n))) v
44 #elif defined(__TI_COMPILER_VERSION__)
45  #define DECLARE_ALIGNED(n,t,v) \
46  AV_PRAGMA(DATA_ALIGN(v,n)) \
47  t __attribute__((aligned(n))) v
48  #define DECLARE_ASM_CONST(n,t,v) \
49  AV_PRAGMA(DATA_ALIGN(v,n)) \
50  static const t __attribute__((aligned(n))) v
51 #elif defined(__GNUC__)
52  #define DECLARE_ALIGNED(n,t,v) t __attribute__ ((aligned (n))) v
53  #define DECLARE_ASM_CONST(n,t,v) static const t av_used __attribute__ ((aligned (n))) v
54 #elif defined(_MSC_VER)
55  #define DECLARE_ALIGNED(n,t,v) __declspec(align(n)) t v
56  #define DECLARE_ASM_CONST(n,t,v) __declspec(align(n)) static const t v
57 #else
58  #define DECLARE_ALIGNED(n,t,v) t v
59  #define DECLARE_ASM_CONST(n,t,v) static const t v
60 #endif
61 
62 #if AV_GCC_VERSION_AT_LEAST(3,1)
63  #define av_malloc_attrib __attribute__((__malloc__))
64 #else
65  #define av_malloc_attrib
66 #endif
67 
68 #if AV_GCC_VERSION_AT_LEAST(4,3)
69  #define av_alloc_size(...) __attribute__((alloc_size(__VA_ARGS__)))
70 #else
71  #define av_alloc_size(...)
72 #endif
73 
83 
92 av_alloc_size(1, 2) static inline void *av_malloc_array(size_t nmemb, size_t size)
93 {
94  if (!size || nmemb >= INT_MAX / size)
95  return NULL;
96  return av_malloc(nmemb * size);
97 }
98 
117 void *av_realloc(void *ptr, size_t size) av_alloc_size(2);
118 
136 int av_reallocp(void *ptr, size_t size);
137 
155 av_alloc_size(2, 3) void *av_realloc_array(void *ptr, size_t nmemb, size_t size);
156 
174 av_alloc_size(2, 3) int av_reallocp_array(void *ptr, size_t nmemb, size_t size);
175 
184 void av_free(void *ptr);
185 
194 void *av_mallocz(size_t size) av_malloc_attrib av_alloc_size(1);
195 
205 av_alloc_size(1, 2) static inline void *av_mallocz_array(size_t nmemb, size_t size)
206 {
207  if (!size || nmemb >= INT_MAX / size)
208  return NULL;
209  return av_mallocz(nmemb * size);
210 }
211 
218 char *av_strdup(const char *s) av_malloc_attrib;
219 
228 char *av_strndup(const char *s, size_t len) av_malloc_attrib;
229 
237 void av_freep(void *ptr);
238 
248 void av_memcpy_backptr(uint8_t *dst, int back, int cnt);
249 
255 void *av_fast_realloc(void *ptr, unsigned int *size, size_t min_size);
256 
269 void av_fast_malloc(void *ptr, unsigned int *size, size_t min_size);
270 
275 #endif /* AVUTIL_MEM_H */
char * av_strndup(const char *s, size_t len) av_malloc_attrib
Duplicate a substring of the string s.
Definition: mem.c:225
int size
char * av_strdup(const char *s) av_malloc_attrib
Duplicate the string s.
Definition: mem.c:213
void av_freep(void *ptr)
Free a memory block which has been allocated with av_malloc(z)() or av_realloc() and set the pointer ...
Definition: mem.c:198
uint8_t
static void * av_malloc_array(size_t nmemb, size_t size)
Definition: mem.h:92
int av_reallocp(void *ptr, size_t size)
Allocate or reallocate a block of memory.
Definition: mem.c:140
#define av_alloc_size(...)
Definition: mem.h:71
int av_reallocp_array(void *ptr, size_t nmemb, size_t size)
Definition: mem.c:167
void av_free(void *ptr)
Free a memory block which has been allocated with av_malloc(z)() or av_realloc(). ...
Definition: mem.c:186
#define av_malloc_attrib
Definition: mem.h:65
void * av_realloc(void *ptr, size_t size) 1(2)
Allocate or reallocate a block of memory.
Definition: mem.c:117
void * av_malloc(size_t size) av_malloc_attrib 1(1)
Allocate a block of size bytes with alignment suitable for all memory accesses (including vectors if ...
Definition: mem.c:62
static void * av_mallocz_array(size_t nmemb, size_t size)
Definition: mem.h:205
void * av_realloc_array(void *ptr, size_t nmemb, size_t size)
Definition: mem.c:160
NULL
Definition: eval.c:55
external API header
static void(WINAPI *cond_broadcast)(pthread_cond_t *cond)
Macro definitions for various function/variable attributes.
void av_fast_malloc(void *ptr, unsigned int *size, size_t min_size)
Allocate a buffer, reusing the given one if large enough.
Definition: mem.c:388
int len
void * av_fast_realloc(void *ptr, unsigned int *size, size_t min_size)
Reallocate the given block if it is not large enough, otherwise do nothing.
Definition: mem.c:369
void av_memcpy_backptr(uint8_t *dst, int back, int cnt)
deliberately overlapping memcpy implementation
Definition: mem.c:319
void * av_mallocz(size_t size) av_malloc_attrib 1(1)
Allocate a block of size bytes with alignment suitable for all memory accesses (including vectors if ...
Definition: mem.c:205