kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-09-03 11:25:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

pbx: Add variable substitution API for extensions

Browse Source 
Currently, variable substitution involving dialplan
extensions is quite clunky since it entails obtaining
the current dialplan location, backing it up, storing
the desired variables for substitution on the channel,
performing substitution, then restoring the original
location.

In addition to being clunky, things could also go wrong
if an async goto were to occur and change the dialplan
location during a substitution.

Fundamentally, there's no reason it needs to be done this
way, so new API is added to allow for directly passing in
the dialplan location for the purposes of variable
substitution so we don't need to mess with the channel
information anymore. Existing API is not changed.

ASTERISK-29745 #close

Change-Id: I23273bf27fa0efb64a606eebf9aa8e2f41a065e4
This commit is contained in:
Naveen Albert
2021-11-15 21:08:11 +00:00
committed by George Joseph
parent a507049eb5
commit 828eb997b1
3 changed files with 57 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
include/asterisk/pbx.h
View File

@@ -1272,6 +1272,22 @@ const char *ast_get_extension_cidmatch(struct ast_exten *e);
const char *ast_get_extension_app(struct ast_exten *e);
const char *ast_get_extension_label(struct ast_exten *e);
void *ast_get_extension_app_data(struct ast_exten *e);
/*!
* \brief Fill a string buffer with the data at a dialplan extension
*
* \param buf String buffer
* \param bufsize Size of buf
* \param c Channel
* \param context Dialplan context
* \param exten Dialplan extension
* \param priority Dialplan priority
*
* \retval -1 Failed to obtain extension data
* \retval 0 Successfully obtained extension data
*/
int ast_get_extension_data(char *buf, int bufsize, struct ast_channel *c,
const char *context, const char *exten, int priority);
/*! @} */
/*! @name Registrar info functions ... */
@@ -1395,6 +1411,11 @@ int pbx_builtin_raise_exception(struct ast_channel *chan, const char *data);
void pbx_substitute_variables_helper(struct ast_channel *c, const char *cp1, char *cp2, int count);
void pbx_substitute_variables_varshead(struct varshead *headp, const char *cp1, char *cp2, int count);
void pbx_substitute_variables_helper_full(struct ast_channel *c, struct varshead *headp, const char *cp1, char *cp2, int cp2_size, size_t *used);
/*!
* \brief Substitutes variables, similar to pbx_substitute_variables_helper_full, but allows passing the context, extension, and priority in.
*/
void pbx_substitute_variables_helper_full_location(struct ast_channel *c, struct varshead *headp, const char *cp1, char *cp2, int cp2_size, size_t *used, char *context, char *exten, int pri);
/*! @} */
/*! @name Substitution routines, using dynamic string buffers