kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-10-22 20:56:39 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify which part of OBJ_MULTIPLE is not implemented, and under what case it

Browse Source 
is perfectly fine to use.  (Inspired by a question I received about my last
commit.)


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@155244 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Russell Bryant
2008-11-07 15:01:02 +00:00
parent 1a239454f1
commit d1da05b948
1 changed files with 6 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
include/asterisk/astobj2.h
View File

@@ -511,7 +511,7 @@ Operations on container include:
can be: can be:
OBJ_UNLINK - to remove the object, once found, from the container. OBJ_UNLINK - to remove the object, once found, from the container.
OBJ_NODATA - don't return the object if found (no ref count change) OBJ_NODATA - don't return the object if found (no ref count change)
OBJ_MULTIPLE - don't stop at first match (not implemented) OBJ_MULTIPLE - don't stop at first match (not fully implemented)
OBJ_POINTER - if set, 'arg' is an object pointer, and a hashtable OBJ_POINTER - if set, 'arg' is an object pointer, and a hashtable
search will be done. If not, a traversal is done. search will be done. If not, a traversal is done.
@@ -523,7 +523,7 @@ Operations on container include:
- flags can be - flags can be
OBJ_UNLINK - to remove the object, once found, from the container. OBJ_UNLINK - to remove the object, once found, from the container.
OBJ_NODATA - don't return the object if found (no ref count change) OBJ_NODATA - don't return the object if found (no ref count change)
OBJ_MULTIPLE - don't stop at first match (not implemented) OBJ_MULTIPLE - don't stop at first match (not fully implemented)
OBJ_POINTER - if set, 'arg' is an object pointer, and a hashtable OBJ_POINTER - if set, 'arg' is an object pointer, and a hashtable
search will be done. If not, a traversal is done through search will be done. If not, a traversal is done through
all the hashtable 'buckets'.. all the hashtable 'buckets'..
@@ -615,7 +615,10 @@ enum search_flags {
* its refcount. */ * its refcount. */
OBJ_NODATA = (1 << 1), OBJ_NODATA = (1 << 1),
/*! Don't stop at the first match in ao2_callback() /*! Don't stop at the first match in ao2_callback()
* \note This is not fully implemented. */ * \note This is not fully implemented. Using OBJ_MULTIME with OBJ_NODATA
* is perfectly fine. The part that is not implemented is the case where
* multiple objects should be returned by ao2_callback().
*/
OBJ_MULTIPLE = (1 << 2), OBJ_MULTIPLE = (1 << 2),
/*! obj is an object of the same type as the one being searched for, /*! obj is an object of the same type as the one being searched for,
* so use the object's hash function for optimized searching. * so use the object's hash function for optimized searching.