Differences From Artifact [6ddaa1e48b]:
- File src/OFObject.h — part of check-in [d0ae3bfd6c] at 2020-10-25 23:33:09 on branch trunk — Add of_{malloc,calloc,realloc,free} (user: js, size: 42234) [annotate] [blame] [check-ins using]
To Artifact [9d5edd8a16]:
- File
src/OFObject.h
— part of check-in
[3d8286feee]
at
2020-11-04 23:18:25
on branch trunk
— Remove of_free()
While it makes sense to wrap malloc and calloc to replace the error
checking with exceptions, it does not make sense to wrap free. (user: js, size: 42197) [annotate] [blame] [check-ins using]
| ︙ | ︙ | |||
1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 |
#endif
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Allocates memory for the specified number of items.
*
* Throws @ref OFOutOfMemoryException if allocating failed and
* @ref OFOutOfRangeException if the requested size exceeds the address space.
*
* @param count The number of items to allocate
* @param size The size of each item to allocate
* @return A pointer to the allocated memory. May return NULL if the specified
* size or count is 0.
*/
extern void *_Nullable of_malloc(size_t count, size_t size)
OF_WARN_UNUSED_RESULT;
/**
* @brief Allocates memory for the specified number of items and initializes it
* with zeros.
*
* Throws @ref OFOutOfMemoryException if allocating failed and
* @ref OFOutOfRangeException if the requested size exceeds the address space.
*
* @param size The size of each item to allocate
* @param count The number of items to allocate
* @return A pointer to the allocated memory. May return NULL if the specified
* size or count is 0.
*/
extern void *_Nullable of_calloc(size_t count, size_t size)
OF_WARN_UNUSED_RESULT;
/**
* @brief Resizes memory to the specific number of items of the specified size.
*
* If the pointer is NULL, this is equivalent to allocating memory.
* If the size or number of items is 0, this is equivalent to freeing memory.
*
* Throws @ref OFOutOfMemoryException if allocating failed and
* @ref OFOutOfRangeException if the requested size exceeds the address space.
*
* @param pointer A pointer to the already allocated memory
* @param size The size of each item to resize to
* @param count The number of items to resize to
* @return A pointer to the resized memory chunk
*/
extern void *_Nullable of_realloc(void *_Nullable pointer, size_t count,
size_t size) OF_WARN_UNUSED_RESULT;
| > > > > > > < < < < < < < < < | 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 |
#endif
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Allocates memory for the specified number of items.
*
* To free the allocated memory, use `free()`.
*
* Throws @ref OFOutOfMemoryException if allocating failed and
* @ref OFOutOfRangeException if the requested size exceeds the address space.
*
* @param count The number of items to allocate
* @param size The size of each item to allocate
* @return A pointer to the allocated memory. May return NULL if the specified
* size or count is 0.
*/
extern void *_Nullable of_malloc(size_t count, size_t size)
OF_WARN_UNUSED_RESULT;
/**
* @brief Allocates memory for the specified number of items and initializes it
* with zeros.
*
* To free the allocated memory, use `free()`.
*
* Throws @ref OFOutOfMemoryException if allocating failed and
* @ref OFOutOfRangeException if the requested size exceeds the address space.
*
* @param size The size of each item to allocate
* @param count The number of items to allocate
* @return A pointer to the allocated memory. May return NULL if the specified
* size or count is 0.
*/
extern void *_Nullable of_calloc(size_t count, size_t size)
OF_WARN_UNUSED_RESULT;
/**
* @brief Resizes memory to the specific number of items of the specified size.
*
* To free the allocated memory, use `free()`.
*
* If the pointer is NULL, this is equivalent to allocating memory.
* If the size or number of items is 0, this is equivalent to freeing memory.
*
* Throws @ref OFOutOfMemoryException if allocating failed and
* @ref OFOutOfRangeException if the requested size exceeds the address space.
*
* @param pointer A pointer to the already allocated memory
* @param size The size of each item to resize to
* @param count The number of items to resize to
* @return A pointer to the resized memory chunk
*/
extern void *_Nullable of_realloc(void *_Nullable pointer, size_t count,
size_t size) OF_WARN_UNUSED_RESULT;
#ifdef OF_APPLE_RUNTIME
extern void *_Null_unspecified objc_autoreleasePoolPush(void);
extern void objc_autoreleasePoolPop(void *_Null_unspecified pool);
# ifndef __OBJC2__
extern id _Nullable objc_constructInstance(Class _Nullable class_,
void *_Nullable bytes);
extern void *_Nullable objc_destructInstance(id _Nullable object);
|
| ︙ | ︙ |