kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-11-08 19:08:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merged revisions 90310 via svnmerge from

Browse Source 
https://origsvn.digium.com/svn/asterisk/branches/1.4

........
r90310 | russell | 2007-11-30 12:46:46 -0600 (Fri, 30 Nov 2007) | 2 lines

Add some notes on the behavior of ao2_unlink() after a discussion with Tilghman

........


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@90311 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Russell Bryant
2007-11-30 18:47:14 +00:00
parent 4a5b8ad6b3
commit 45f98e5419
1 changed files with 18 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
include/asterisk/astobj2.h
View File

@@ -364,7 +364,24 @@ int ao2_container_count(struct ao2_container *c);
* \note Remember to set the key before calling this function. * \note Remember to set the key before calling this function.
*/ */
void *ao2_link(struct ao2_container *c, void *newobj); void *ao2_link(struct ao2_container *c, void *newobj);
void *ao2_unlink(struct ao2_container *c, void *newobj); /*!
* \brief Remove an object from the container
*
* \arg c the container
* \arg obj the object to unlink
*
* \retval NULL, always
*
* \note The object requested to be unlinked must be valid. However, if it turns
* out that it is not in the container, this function is still safe to
* be called.
*
* \note If the object gets unlinked from the container, the container's
* reference to the object will be automatically released. This is
* slightly different than ao2_link(), which inherits a reference instead
* of automatically increasing the reference count.
*/
void *ao2_unlink(struct ao2_container *c, void *obj);
/*! \brief Used as return value if the flag OBJ_MULTIPLE is set */ /*! \brief Used as return value if the flag OBJ_MULTIPLE is set */
struct ao2_list { struct ao2_list {