Differences From Artifact [e7d4a93a9e]:
- File src/OFObject.h — part of check-in [ae55197d6b] at 2022-09-19 19:37:00 on branch trunk — OFObject: Document exceptions (user: js, size: 40824) [annotate] [blame] [check-ins using]
To Artifact [698abcee0b]:
- File
src/OFObject.h
— part of check-in
[96e0a91a06]
at
2022-09-24 15:32:52
on branch trunk
— Do not document exceptions that are obvious
Otherwise every second method would need to have
OFInvalidArgumentException documented. (user: js, size: 40734) [annotate] [blame] [check-ins using] [more...]
| ︙ | ︙ | |||
746 747 748 749 750 751 752 | /** * @brief Replaces a class method with a class method from another class. * * @param selector The selector of the class method to replace * @param class_ The class from which the new class method should be taken * @return The old implementation | < < | 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 | /** * @brief Replaces a class method with a class method from another class. * * @param selector The selector of the class method to replace * @param class_ The class from which the new class method should be taken * @return The old implementation */ + (nullable IMP)replaceClassMethod: (SEL)selector withMethodFromClass: (Class)class_; /** * @brief Replaces an instance method with an instance method from another * class. * * @param selector The selector of the instance method to replace * @param class_ The class from which the new instance method should be taken * @return The old implementation */ + (nullable IMP)replaceInstanceMethod: (SEL)selector withMethodFromClass: (Class)class_; /** * @brief Adds all methods from the specified class to the class that is the * receiver. |
| ︙ | ︙ | |||
1298 1299 1300 1301 1302 1303 1304 | * To free the allocated memory, use @ref OFFreeMemory. * * @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. * @throw OFOutOfMemoryException The allocation failed due to not enough memory | | > | > | > | 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 |
* To free the allocated memory, use @ref OFFreeMemory.
*
* @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.
* @throw OFOutOfMemoryException The allocation failed due to not enough memory
* @throw OFOutOfRangeException The requested `count * size` exceeds the
* address space
*/
extern void *_Nullable OFAllocMemory(size_t count, size_t size)
OF_WARN_UNUSED_RESULT;
/**
* @brief Allocates memory for the specified number of items of the specified
* size and initializes it with zeros.
*
* To free the allocated memory, use @ref OFFreeMemory.
*
* @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.
* @throw OFOutOfMemoryException The allocation failed due to not enough memory
* @throw OFOutOfRangeException The requested `count * size` exceeds the
* address space
*/
extern void *_Nullable OFAllocZeroedMemory(size_t count, size_t size)
OF_WARN_UNUSED_RESULT;
/**
* @brief Resizes memory to the specified number of items of the specified size.
*
* To free the allocated memory, use @ref OFFreeMemory.
*
* 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.
*
* @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
* @throw OFOutOfMemoryException The reallocation failed due to not enough
* memory
* @throw OFOutOfRangeException The requested `count * size` exceeds the
* address space
*/
extern void *_Nullable OFResizeMemory(void *_Nullable pointer, size_t count,
size_t size) OF_WARN_UNUSED_RESULT;
/**
* @brief Frees memory allocated by @ref OFAllocMemory, @ref OFAllocZeroedMemory
* or @ref OFResizeMemory.
|
| ︙ | ︙ |