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

Merge "sorcery: Add ast_sorcery_retrieve_by_prefix()" into 13

Browse Source
This commit is contained in:
Joshua Colp
2017-11-16 10:59:23 -06:00
committed by Gerrit Code Review
parent 9fb2da7963 cf062303e3
commit 8d55b132b9
7 changed files with 247 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
include/asterisk/sorcery.h
View File

@@ -312,6 +312,14 @@ struct ast_sorcery_wizard {
/*! \brief Callback for closing a wizard */
void (*close)(void *data);
/*! \brief Optional callback for retrieving multiple objects by matching their id with a prefix */
void (*retrieve_prefix)(const struct ast_sorcery *sorcery,
void *data,
const char *type,
struct ao2_container *objects,
const char *prefix,
const size_t prefix_len);
};
/*! \brief Interface for a sorcery object type observer */
@@ -363,10 +371,21 @@ int ast_sorcery_init(void);
*/
int __ast_sorcery_wizard_register(const struct ast_sorcery_wizard *interface, struct ast_module *module);
/*!
* \brief Register a sorcery wizard
*
* \param interface Pointer to a wizard interface
* \param module Pointer to the module implementing the interface
*
* \retval 0 success
* \retval -1 failure
*/
int __ast_sorcery_wizard_register_with_prefix(const struct ast_sorcery_wizard *interface, struct ast_module *module);
/*!
* \brief See \ref __ast_sorcery_wizard_register()
*/
#define ast_sorcery_wizard_register(interface) __ast_sorcery_wizard_register(interface, ast_module_info ? ast_module_info->self : NULL)
#define ast_sorcery_wizard_register(interface) __ast_sorcery_wizard_register_with_prefix(interface, ast_module_info ? ast_module_info->self : NULL)
/*!
* \brief Unregister a sorcery wizard
@@ -1217,6 +1236,22 @@ void *ast_sorcery_retrieve_by_fields(const struct ast_sorcery *sorcery, const ch
*/
struct ao2_container *ast_sorcery_retrieve_by_regex(const struct ast_sorcery *sorcery, const char *type, const char *regex);
/*!
* \brief Retrieve multiple objects whose id begins with the specified prefix
* \since 13.19.0
*
* \param sorcery Pointer to a sorcery structure
* \param type Type of object to retrieve
* \param prefix Object id prefix
* \param prefix_len The length of prefix in bytes
*
* \retval non-NULL if error occurs
* \retval NULL success
*
* \note The prefix is matched in a case sensitive manner.
*/
struct ao2_container *ast_sorcery_retrieve_by_prefix(const struct ast_sorcery *sorcery, const char *type, const char *prefix, const size_t prefix_len);
/*!
* \brief Update an object
*