[asterisk-commits] tilghman: trunk r154915 - in /trunk: ./ funcs/ include/asterisk/ main/
SVN commits to the Asterisk project
asterisk-commits at lists.digium.com
Wed Nov 5 15:58:48 CST 2008
Author: tilghman
Date: Wed Nov 5 15:58:48 2008
New Revision: 154915
URL: http://svn.digium.com/view/asterisk?view=rev&rev=154915
Log:
Add LISTFILTER dialplan function, along with supporting documentation. See
documentation for more information on how to use it.
Modified:
trunk/CHANGES
trunk/funcs/func_strings.c
trunk/include/asterisk/app.h
trunk/main/app.c
Modified: trunk/CHANGES
URL: http://svn.digium.com/view/asterisk/trunk/CHANGES?view=diff&rev=154915&r1=154914&r2=154915
==============================================================================
--- trunk/CHANGES (original)
+++ trunk/CHANGES Wed Nov 5 15:58:48 2008
@@ -32,6 +32,9 @@
* Added debugging CLI functions to func_odbc, 'odbc read' and 'odbc write'.
* func_odbc now may specify an insert query to execute, when the write query
affects 0 rows (usually indicating that no such row exists).
+ * Added a new dialplan function, LISTFILTER, which permits removing elements
+ from a set list, by name. Uses the same general syntax as the existing CUT
+ and FIELDQTY dialplan functions, which also manage lists.
Applications
------------
Modified: trunk/funcs/func_strings.c
URL: http://svn.digium.com/view/asterisk/trunk/funcs/func_strings.c?view=diff&rev=154915&r1=154914&r2=154915
==============================================================================
--- trunk/funcs/func_strings.c (original)
+++ trunk/funcs/func_strings.c Wed Nov 5 15:58:48 2008
@@ -39,6 +39,8 @@
#include "asterisk/app.h"
#include "asterisk/localtime.h"
+AST_THREADSTORAGE(result_buf);
+
/*** DOCUMENTATION
<function name="FIELDQTY" language="en_US">
<synopsis>
@@ -50,6 +52,19 @@
</syntax>
<description>
<para>Example: ${FIELDQTY(ex-amp-le,-)} returns 3</para>
+ </description>
+ </function>
+ <function name="LISTFILTER" language="en_US">
+ <synopsis>Remove an item from a list, by name.</synopsis>
+ <syntax>
+ <parameter name="varname" required="true" />
+ <parameter name="delim" required="true" default="," />
+ <parameter name="value" required="true" />
+ </syntax>
+ <description>
+ <para>Remove <replaceable>value</replaceable> from the list contained in the <replaceable>varname</replaceable>
+ variable, where the list delimiter is specified by the <replaceable>delim</replaceable> parameter. This is
+ very useful for removing a single channel name from a list of channels, for example.</para>
</description>
</function>
<function name="FILTER" language="en_US">
@@ -320,6 +335,105 @@
static struct ast_custom_function fieldqty_function = {
.name = "FIELDQTY",
.read = function_fieldqty,
+};
+
+static int listfilter(struct ast_channel *chan, const char *cmd, char *parse, char *buf, size_t len)
+{
+ AST_DECLARE_APP_ARGS(args,
+ AST_APP_ARG(listname);
+ AST_APP_ARG(delimiter);
+ AST_APP_ARG(fieldvalue);
+ );
+ const char *orig_list, *ptr;
+ const char *begin, *cur, *next;
+ int dlen, flen;
+ struct ast_str *result = ast_str_thread_get(&result_buf, 16);
+ char *delim;
+
+ AST_STANDARD_APP_ARGS(args, parse);
+
+ if (args.argc < 3) {
+ ast_log(LOG_ERROR, "Usage: LISTFILTER(<listname>,<delimiter>,<fieldvalue>)\n");
+ return -1;
+ }
+
+ /* If we don't lock the channel, the variable could disappear out from underneath us. */
+ if (chan) {
+ ast_channel_lock(chan);
+ }
+ if (!(orig_list = pbx_builtin_getvar_helper(chan, args.listname))) {
+ ast_log(LOG_ERROR, "List variable '%s' not found\n", args.listname);
+ if (chan) {
+ ast_channel_unlock(chan);
+ }
+ return -1;
+ }
+
+ /* If the string isn't there, just copy out the string and be done with it. */
+ if (!(ptr = strstr(orig_list, args.fieldvalue))) {
+ ast_copy_string(buf, orig_list, len);
+ if (chan) {
+ ast_channel_unlock(chan);
+ }
+ return 0;
+ }
+
+ dlen = strlen(args.delimiter);
+ delim = alloca(dlen + 1);
+ ast_get_encoded_str(args.delimiter, delim, dlen + 1);
+
+ if ((dlen = strlen(delim)) == 0) {
+ delim = ",";
+ dlen = 1;
+ }
+
+ flen = strlen(args.fieldvalue);
+
+ ast_str_reset(result);
+ /* Enough space for any result */
+ ast_str_make_space(&result, strlen(orig_list) + 1);
+
+ begin = orig_list;
+ next = strstr(begin, delim);
+
+ do {
+ /* Find next boundary */
+ if (next) {
+ cur = next;
+ next = strstr(cur + dlen, delim);
+ } else {
+ cur = strchr(begin + dlen, '\0');
+ }
+
+ if (flen == cur - begin && !strncmp(begin, args.fieldvalue, flen)) {
+ /* Skip field */
+ begin += flen + dlen;
+ } else {
+ /* Copy field to output */
+ if (result->used) {
+ ast_str_append(&result, 0, "%s", delim);
+ }
+
+ /* Have to do it this way, since we're not null-terminated. */
+ strncpy(result->str + result->used, begin, cur - begin);
+ result->used += cur - begin;
+ result->str[result->used] = '\0';
+
+ begin = cur + dlen;
+ }
+ } while (*cur != '\0');
+ if (chan) {
+ ast_channel_unlock(chan);
+ }
+
+ ast_copy_string(buf, result->str, len);
+
+ return 0;
+}
+
+static struct ast_custom_function listfilter_function = {
+ .name = "LISTFILTER",
+ .read = listfilter,
};
static int filter(struct ast_channel *chan, const char *cmd, char *parse, char *buf,
@@ -997,6 +1111,7 @@
res |= ast_custom_function_unregister(&fieldqty_function);
res |= ast_custom_function_unregister(&filter_function);
+ res |= ast_custom_function_unregister(&listfilter_function);
res |= ast_custom_function_unregister(®ex_function);
res |= ast_custom_function_unregister(&array_function);
res |= ast_custom_function_unregister("e_function);
@@ -1021,6 +1136,7 @@
res |= ast_custom_function_register(&fieldqty_function);
res |= ast_custom_function_register(&filter_function);
+ res |= ast_custom_function_register(&listfilter_function);
res |= ast_custom_function_register(®ex_function);
res |= ast_custom_function_register(&array_function);
res |= ast_custom_function_register("e_function);
Modified: trunk/include/asterisk/app.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/app.h?view=diff&rev=154915&r1=154914&r2=154915
==============================================================================
--- trunk/include/asterisk/app.h (original)
+++ trunk/include/asterisk/app.h Wed Nov 5 15:58:48 2008
@@ -488,6 +488,9 @@
/*! \brief Decode an encoded control or extended ASCII character */
int ast_get_encoded_char(const char *stream, char *result, size_t *consumed);
+/*! \brief Decode a stream of encoded control or extended ASCII characters */
+int ast_get_encoded_str(const char *stream, char *result, size_t result_len);
+
/*! \brief Common routine for child processes, to close all fds prior to exec(2) */
void ast_close_fds_above_n(int n);
Modified: trunk/main/app.c
URL: http://svn.digium.com/view/asterisk/trunk/main/app.c?view=diff&rev=154915&r1=154914&r2=154915
==============================================================================
--- trunk/main/app.c (original)
+++ trunk/main/app.c Wed Nov 5 15:58:48 2008
@@ -1815,6 +1815,19 @@
return 0;
}
+int ast_get_encoded_str(const char *stream, char *result, size_t result_size)
+{
+ char *cur = result;
+ size_t consumed;
+
+ while (cur < result + result_size - 1 && !ast_get_encoded_char(stream, cur, &consumed)) {
+ cur++;
+ stream += consumed;
+ }
+ *cur = '\0';
+ return 0;
+}
+
void ast_close_fds_above_n(int n)
{
int x, null;
More information about the asterisk-commits
mailing list