func_strings.c File Reference

String manipulation dialplan functions. More...

#include "asterisk.h"
#include <regex.h>
#include <ctype.h>
#include "asterisk/module.h"
#include "asterisk/channel.h"
#include "asterisk/pbx.h"
#include "asterisk/utils.h"
#include "asterisk/app.h"
#include "asterisk/localtime.h"
#include "asterisk/test.h"

Include dependency graph for func_strings.c:

Go to the source code of this file.

Macros
#define	beginning   (cmd[0] == 'S') /* SHIFT */
#define	beginning   (cmd[0] == 'U') /* UNSHIFT */
#define	HASH_FORMAT   HASH_PREFIX "%s~"
#define	HASH_PREFIX   "~HASH~%s~"
#define	ltrim(s)   while (isspace(*s)) s++;
#define	rtrim(s)

Functions
static void	__reg_module (void)
static void	__unreg_module (void)
static int	acf_strftime (struct ast_channel *chan, const char *cmd, char *parse, char *buf, size_t buflen)
static int	acf_strptime (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
static int	array (struct ast_channel *chan, const char *cmd, char *var, const char *value)
struct ast_module *	AST_MODULE_SELF_SYM (void)
	AST_THREADSTORAGE_CUSTOM_SCOPE (result_buf, NULL, ast_free_ptr, static)
	AST_THREADSTORAGE_CUSTOM_SCOPE (tmp_buf, NULL, ast_free_ptr, static)
static void	clearvar_prefix (struct ast_channel *chan, const char *prefix)
static int	csv_quote (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	exec_clearhash (struct ast_channel *chan, const char *data)
static int	filter (struct ast_channel *chan, const char *cmd, char *parse, char *buf, size_t len)
static int	function_eval (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
static int	function_eval2 (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t buflen)
static int	function_fieldnum (struct ast_channel *chan, const char *cmd, char *parse, char *buf, size_t len)
static int	function_fieldnum_helper (struct ast_channel *chan, const char *cmd, char *parse, char *buf, struct ast_str **sbuf, ssize_t len)
static int	function_fieldnum_str (struct ast_channel *chan, const char *cmd, char *parse, struct ast_str **buf, ssize_t len)
static int	function_fieldqty (struct ast_channel *chan, const char *cmd, char *parse, char *buf, size_t len)
static int	function_fieldqty_helper (struct ast_channel *chan, const char *cmd, char *parse, char *buf, struct ast_str **sbuf, ssize_t len)
static int	function_fieldqty_str (struct ast_channel *chan, const char *cmd, char *parse, struct ast_str **buf, ssize_t len)
static int	function_ltrim (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	function_rtrim (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	function_trim (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static const char *	get_key (const struct ast_str *prefix, const struct ast_var_t *var)
static int	hash_read (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	hash_write (struct ast_channel *chan, const char *cmd, char *var, const char *value)
static int	hashkeys_read (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	hashkeys_read2 (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t len)
static int	keypadhash (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
static int	len (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
static int	listfilter (struct ast_channel *chan, const char *cmd, char *parse, char *buf, struct ast_str **bufstr, ssize_t len)
static int	listfilter_read (struct ast_channel *chan, const char *cmd, char *parse, char *buf, size_t len)
static int	listfilter_read2 (struct ast_channel *chan, const char *cmd, char *parse, struct ast_str **buf, ssize_t len)
static int	load_module (void)
static int	passthru (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t len)
static int	quote (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	regex (struct ast_channel *chan, const char *cmd, char *parse, char *buf, size_t len)
static int	replace (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t len)
static int	shift_pop (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t len)
static int	strbetween (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t len)
static int	string_tolower (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
static int	string_tolower2 (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t buflen)
static int	string_toupper (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
static int	string_toupper2 (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t buflen)
static int	strreplace (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t len)
static int	unload_module (void)
static int	unshift_push (struct ast_channel *chan, const char *cmd, char *data, const char *new_value)

Variables
static struct ast_module_info	__mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "String handling dialplan functions" , .key = ASTERISK_GPL_KEY , .buildopt_sum = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_DEFAULT, .support_level = AST_MODULE_SUPPORT_CORE, }
static char *	app_clearhash = "ClearHash"
static struct ast_custom_function	array_function
static const struct ast_module_info *	ast_module_info = &__mod_info
static struct ast_custom_function	csv_quote_function
static struct ast_custom_function	eval_function
static struct ast_custom_function	fieldnum_function
static struct ast_custom_function	fieldqty_function
static struct ast_custom_function	filter_function
static struct ast_custom_function	hash_function
static struct ast_custom_function	hashkeys_function
static struct ast_custom_function	keypadhash_function
static struct ast_custom_function	len_function
static struct ast_custom_function	listfilter_function
static struct ast_custom_function	ltrim_function
static struct ast_custom_function	passthru_function
static struct ast_custom_function	pop_function
static struct ast_custom_function	push_function
static struct ast_custom_function	quote_function
static struct ast_custom_function	regex_function
static struct ast_custom_function	replace_function
static struct ast_custom_function	rtrim_function
static struct ast_custom_function	shift_function
static struct ast_custom_function	strbetween_function
static struct ast_custom_function	strftime_function
static struct ast_custom_function	strptime_function
static struct ast_custom_function	strreplace_function
static struct ast_custom_function	tolower_function
static struct ast_custom_function	toupper_function
static struct ast_custom_function	trim_function
static struct ast_custom_function	unshift_function

Detailed Description

String manipulation dialplan functions.

Author

Tilghman Lesher

Anthony Minessale II

Naveen Albert

Definition in file func_strings.c.

Macro Definition Documentation

beginning [1/2]

#define beginning   (cmd[0] == 'S') /* SHIFT */

beginning [2/2]

#define beginning   (cmd[0] == 'U') /* UNSHIFT */

HASH_FORMAT

#define HASH_FORMAT   HASH_PREFIX "%s~"

Definition at line 1306 of file func_strings.c.

HASH_PREFIX

#define HASH_PREFIX   "~HASH~%s~"

Definition at line 1305 of file func_strings.c.

ltrim

#define ltrim

(

s

)

while (isspace(*s)) s++;

Definition at line 1185 of file func_strings.c.

rtrim

#define rtrim

(

s

)

Definition at line 1186 of file func_strings.c.

                 { \
    if (s) { \
        char *back = s + strlen(s); \
        while (back != s && isspace(*--back)); \
        if (*s) { \
            *(back + 1) = '\0'; \
        } \
    } \
}

Function Documentation

__reg_module()

static void __reg_module ( void  )

static

Definition at line 2495 of file func_strings.c.

__unreg_module()

static void __unreg_module ( void  )

static

Definition at line 2495 of file func_strings.c.

acf_strftime()

static int acf_strftime ( struct ast_channel *  chan, const char *  cmd, char *  parse, char *  buf, size_t  buflen  )

static

Definition at line 1687 of file func_strings.c.

{
    AST_DECLARE_APP_ARGS(args,
                 AST_APP_ARG(epoch);
                 AST_APP_ARG(timezone);
                 AST_APP_ARG(format);
    );
    struct timeval when;
    struct ast_tm tm;
 
    buf[0] = '\0';
 
    AST_STANDARD_APP_ARGS(args, parse);
 
    ast_get_timeval(args.epoch, &when, ast_tvnow(), NULL);
    ast_localtime(&when, &tm, args.timezone);
 
    if (!args.format)
        args.format = "%c";
 
    if (ast_strftime(buf, buflen, args.format, &tm) <= 0)
        ast_log(LOG_WARNING, "C function strftime() output nothing?!!\n");
 
    buf[buflen - 1] = '\0';
 
    return 0;
}

References args, AST_APP_ARG, AST_DECLARE_APP_ARGS, ast_get_timeval(), ast_localtime(), ast_log, AST_STANDARD_APP_ARGS, ast_strftime(), ast_tvnow(), buf, LOG_WARNING, and NULL.

acf_strptime()

static int acf_strptime ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  buflen  )

static

Definition at line 1721 of file func_strings.c.

{
    AST_DECLARE_APP_ARGS(args,
                 AST_APP_ARG(timestring);
                 AST_APP_ARG(timezone);
                 AST_APP_ARG(format);
    );
    struct ast_tm tm;
 
    buf[0] = '\0';
 
    if (!data) {
        ast_log(LOG_ERROR,
                "Asterisk function STRPTIME() requires an argument.\n");
        return -1;
    }
 
    AST_STANDARD_APP_ARGS(args, data);
 
    if (ast_strlen_zero(args.format)) {
        ast_log(LOG_ERROR,
                "No format supplied to STRPTIME(<timestring>,<timezone>,<format>)");
        return -1;
    }
 
    if (!ast_strptime(args.timestring, args.format, &tm)) {
        ast_log(LOG_WARNING, "STRPTIME() found no time specified within the string\n");
    } else {
        struct timeval when;
        when = ast_mktime(&tm, args.timezone);
        snprintf(buf, buflen, "%d", (int) when.tv_sec);
    }
 
    return 0;
}

References args, AST_APP_ARG, AST_DECLARE_APP_ARGS, ast_log, ast_mktime(), AST_STANDARD_APP_ARGS, ast_strlen_zero(), ast_strptime(), buf, LOG_ERROR, and LOG_WARNING.

array()

static int array ( struct ast_channel *  chan, const char *  cmd, char *  var, const char *  value  )

static

Definition at line 1332 of file func_strings.c.

{
    AST_DECLARE_APP_ARGS(arg1,
                 AST_APP_ARG(var)[100];
    );
    AST_DECLARE_APP_ARGS(arg2,
                 AST_APP_ARG(val)[100];
    );
    char *origvar = "", *value2, varname[256];
    int i, ishash = 0;
 
    if (!var) {
        return -1;
    }
    value2 = ast_strdupa(value);
 
    if (!strcmp(cmd, "HASH")) {
        const char *var2 = pbx_builtin_getvar_helper(chan, "~ODBCFIELDS~");
        origvar = var;
        if (var2)
            var = ast_strdupa(var2);
        else {
            if (chan)
                ast_autoservice_stop(chan);
            return -1;
        }
        ishash = 1;
    }
 
    /* The functions this will generally be used with are SORT and ODBC_*, which
     * both return comma-delimited lists.  However, if somebody uses literal lists,
     * their commas will be translated to vertical bars by the load, and I don't
     * want them to be surprised by the result.  Hence, we prefer commas as the
     * delimiter, but we'll fall back to vertical bars if commas aren't found.
     */
    ast_debug(1, "array (%s=%s)\n", var, S_OR(value2, ""));
    AST_STANDARD_APP_ARGS(arg1, var);
 
    AST_STANDARD_APP_ARGS(arg2, value2);
 
    for (i = 0; i < arg1.argc; i++) {
        ast_debug(1, "array set value (%s=%s)\n", arg1.var[i],
                S_OR(arg2.val[i], ""));
        if (i < arg2.argc) {
            if (ishash) {
                if (origvar[0] == '_') {
                    if (origvar[1] == '_') {
                        snprintf(varname, sizeof(varname), "__" HASH_FORMAT, origvar + 2, arg1.var[i]);
                    } else {
                        snprintf(varname, sizeof(varname), "_" HASH_FORMAT, origvar + 1, arg1.var[i]);
                    }
                } else {
                    snprintf(varname, sizeof(varname), HASH_FORMAT, origvar, arg1.var[i]);
                }
 
                pbx_builtin_setvar_helper(chan, varname, arg2.val[i]);
            } else {
                pbx_builtin_setvar_helper(chan, arg1.var[i], arg2.val[i]);
            }
        } else {
            /* We could unset the variable, by passing a NULL, but due to
             * pushvar semantics, that could create some undesired behavior. */
            if (ishash) {
                snprintf(varname, sizeof(varname), HASH_FORMAT, origvar, arg1.var[i]);
                pbx_builtin_setvar_helper(chan, varname, "");
            } else {
                pbx_builtin_setvar_helper(chan, arg1.var[i], "");
            }
        }
    }
 
    return 0;
}

References AST_APP_ARG, ast_autoservice_stop(), ast_debug, AST_DECLARE_APP_ARGS, AST_STANDARD_APP_ARGS, ast_strdupa, HASH_FORMAT, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), S_OR, value, and var.

Referenced by __ast_app_separate_args(), app_event_filter_matched(), app_to_json(), append_json(), ast_app_separate_args(), ast_json_array_append(), ast_json_array_clear(), ast_json_array_extend(), ast_json_array_get(), ast_json_array_insert(), ast_json_array_remove(), ast_json_array_set(), ast_json_array_size(), device_to_json_cb(), devices_to_json(), hash_write(), json_array_from_list(), NearestNeighbor(), stasis_app_device_states_to_json(), and stasis_app_mailboxes_to_json().

AST_MODULE_SELF_SYM()

struct ast_module * AST_MODULE_SELF_SYM

(

void

)

Definition at line 2495 of file func_strings.c.

AST_THREADSTORAGE_CUSTOM_SCOPE() [1/2]

AST_THREADSTORAGE_CUSTOM_SCOPE	(	result_buf	,
		NULL	,
		ast_free_ptr	,
		static
	)

AST_THREADSTORAGE_CUSTOM_SCOPE() [2/2]

AST_THREADSTORAGE_CUSTOM_SCOPE	(	tmp_buf	,
		NULL	,
		ast_free_ptr	,
		static
	)

clearvar_prefix()

static void clearvar_prefix ( struct ast_channel *  chan, const char *  prefix  )

static

Definition at line 1311 of file func_strings.c.

{
    struct ast_var_t *var;
    int len = strlen(prefix);
    AST_LIST_TRAVERSE_SAFE_BEGIN(ast_channel_varshead(chan), var, entries) {
        if (strncmp(prefix, ast_var_name(var), len) == 0) {
            AST_LIST_REMOVE_CURRENT(entries);
            ast_free(var);
        }
    }
    AST_LIST_TRAVERSE_SAFE_END
}

References ast_channel_varshead(), ast_free, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_var_name(), ast_var_t::entries, len(), prefix, and var.

Referenced by exec_clearhash().

csv_quote()

static int csv_quote ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1634 of file func_strings.c.

{
    char *bufptr = buf, *dataptr = data;
 
    if (len < 3) { /* at least two for quotes and one for binary zero */
        ast_log(LOG_ERROR, "Not enough buffer\n");
        return -1;
    }
 
    if (ast_strlen_zero(data)) {
        ast_copy_string(buf, "\"\"", len);
        return 0;
    }
 
    *bufptr++ = '"';
    for (; bufptr < buf + len - 3; dataptr++){
        if (*dataptr == '"') {
            *bufptr++ = '"';
            *bufptr++ = '"';
        } else if (*dataptr == '\0') {
            break;
        } else {
            *bufptr++ = *dataptr;
        }
    }
    *bufptr++ = '"';
    *bufptr='\0';
    return 0;
}

References ast_copy_string(), ast_log, ast_strlen_zero(), buf, len(), and LOG_ERROR.

exec_clearhash()

static int exec_clearhash ( struct ast_channel *  chan, const char *  data  )

static

Definition at line 1324 of file func_strings.c.

{
    char prefix[80];
    snprintf(prefix, sizeof(prefix), HASH_PREFIX, data ? (char *)data : "null");
    clearvar_prefix(chan, prefix);
    return 0;
}

References clearvar_prefix(), HASH_PREFIX, and prefix.

Referenced by load_module().

filter()

static int filter ( struct ast_channel *  chan, const char *  cmd, char *  parse, char *  buf, size_t  len  )

static

Note

Looks a little strange, until you realize that we can overflow the size of a char.

Definition at line 899 of file func_strings.c.

{
    AST_DECLARE_APP_ARGS(args,
                 AST_APP_ARG(allowed);
                 AST_APP_ARG(string);
    );
    char *outbuf = buf;
    unsigned char ac;
    char allowed[256] = "";
    size_t allowedlen = 0;
    int32_t bitfield[8] = { 0, }; /* 256 bits */
 
    AST_STANDARD_RAW_ARGS(args, parse);
 
    if (!args.string) {
        ast_log(LOG_ERROR, "Usage: FILTER(<allowed-chars>,<string>)\n");
        return -1;
    }
 
    if (args.allowed[0] == '"' && !ast_opt_dont_warn) {
        ast_log(LOG_WARNING, "FILTER allowed characters includes the quote (\") character.  This may not be what you want.\n");
    }
 
    /* Expand ranges */
    for (; *(args.allowed);) {
        char c1 = 0, c2 = 0;
        size_t consumed = 0;
 
        if (ast_get_encoded_char(args.allowed, &c1, &consumed))
            return -1;
        args.allowed += consumed;
 
        if (*(args.allowed) == '-') {
            if (ast_get_encoded_char(args.allowed + 1, &c2, &consumed))
                c2 = c1;
            args.allowed += consumed + 1;
 
            if ((unsigned char) c2 < (unsigned char) c1 && !ast_opt_dont_warn) {
                ast_log(LOG_WARNING, "Range wrapping in FILTER(%s,%s).  This may not be what you want.\n", parse, args.string);
            }
 
            /*!\note
             * Looks a little strange, until you realize that we can overflow
             * the size of a char.
             */
            for (ac = (unsigned char) c1; ac != (unsigned char) c2; ac++) {
                bitfield[ac / 32] |= 1 << (ac % 32);
            }
            bitfield[ac / 32] |= 1 << (ac % 32);
 
            ast_debug(4, "c1=%d, c2=%d\n", c1, c2);
        } else {
            ac = (unsigned char) c1;
            ast_debug(4, "c1=%d, consumed=%d, args.allowed=%s\n", c1, (int) consumed, args.allowed - consumed);
            bitfield[ac / 32] |= 1 << (ac % 32);
        }
    }
 
    for (ac = 1; ac != 0; ac++) {
        if (bitfield[ac / 32] & (1 << (ac % 32))) {
            allowed[allowedlen++] = ac;
        }
    }
 
    ast_debug(1, "Allowed: %s\n", allowed);
 
    for (; *(args.string) && (buf + len - 1 > outbuf); (args.string)++) {
        if (strchr(allowed, *(args.string)))
            *outbuf++ = *(args.string);
    }
    *outbuf = '\0';
 
    return 0;
}

References args, AST_APP_ARG, ast_debug, AST_DECLARE_APP_ARGS, ast_get_encoded_char(), ast_log, ast_opt_dont_warn, AST_STANDARD_RAW_ARGS, buf, len(), LOG_ERROR, and LOG_WARNING.

Referenced by action_filter(), action_getconfig(), action_getconfigjson(), app_event_filter_set(), app_events_allowed_set(), app_events_disallowed_set(), append_var_and_value_to_filter(), ast_category_browse_filtered(), ast_category_exist(), ast_category_get(), ast_variable_retrieve_filtered(), category_get_sep(), create_lookup_filter(), iax_firmware_traverse(), kqueue_timer_ack(), next_available_category(), process_text_line(), realtime_ldap_base_ap(), stasis_app_event_filter_set(), stasis_caching_set_filter(), stasis_cp_single_set_filter(), stasis_subscription_set_filter(), and update2_ldap().

function_eval()

static int function_eval ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  buflen  )

static

Definition at line 1763 of file func_strings.c.

{
    if (ast_strlen_zero(data)) {
        ast_log(LOG_WARNING, "EVAL requires an argument: EVAL(<string>)\n");
        return -1;
    }
 
    pbx_substitute_variables_helper(chan, data, buf, buflen - 1);
 
    return 0;
}

References ast_log, ast_strlen_zero(), buf, LOG_WARNING, and pbx_substitute_variables_helper().

function_eval2()

static int function_eval2 ( struct ast_channel *  chan, const char *  cmd, char *  data, struct ast_str **  buf, ssize_t  buflen  )

static

Definition at line 1776 of file func_strings.c.

{
    if (ast_strlen_zero(data)) {
        ast_log(LOG_WARNING, "EVAL requires an argument: EVAL(<string>)\n");
        return -1;
    }
 
    ast_str_substitute_variables(buf, buflen, chan, data);
 
    return 0;
}

References ast_log, ast_str_substitute_variables(), ast_strlen_zero(), buf, and LOG_WARNING.

function_fieldnum()

static int function_fieldnum ( struct ast_channel *  chan, const char *  cmd, char *  parse, char *  buf, size_t  len  )

static

Definition at line 754 of file func_strings.c.

{
    return function_fieldnum_helper(chan, cmd, parse, buf, NULL, len);
}

References buf, function_fieldnum_helper(), len(), and NULL.

function_fieldnum_helper()

static int function_fieldnum_helper ( struct ast_channel *  chan, const char *  cmd, char *  parse, char *  buf, struct ast_str **  sbuf, ssize_t  len  )

static

Definition at line 693 of file func_strings.c.

{
    char *varsubst, *field;
    struct ast_str *str = ast_str_thread_get(&result_buf, 16);
    int fieldindex = 0, res = 0;
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(varname);
        AST_APP_ARG(delim);
        AST_APP_ARG(field);
    );
    char delim[2] = "";
    size_t delim_used;
 
    if (!str) {
        return -1;
    }
 
    AST_STANDARD_APP_ARGS(args, parse);
 
    if (args.argc < 3) {
        ast_log(LOG_ERROR, "Usage: FIELDNUM(<listname>,<delimiter>,<fieldvalue>)\n");
        res = -1;
    } else {
        varsubst = ast_alloca(strlen(args.varname) + 4);
        sprintf(varsubst, "${%s}", args.varname);
 
        ast_str_substitute_variables(&str, 0, chan, varsubst);
 
        if (ast_str_strlen(str) == 0 || ast_strlen_zero(args.delim)) {
            fieldindex = 0;
        } else if (ast_get_encoded_char(args.delim, delim, &delim_used) == -1) {
            res = -1;
        } else {
            char *varval = ast_str_buffer(str);
 
            while ((field = strsep(&varval, delim)) != NULL) {
                fieldindex++;
 
                if (!strcasecmp(field, args.field)) {
                    break;
                }
            }
 
            if (!field) {
                fieldindex = 0;
            }
 
            res = 0;
        }
    }
 
    if (sbuf) {
        ast_str_set(sbuf, len, "%d", fieldindex);
    } else {
        snprintf(buf, len, "%d", fieldindex);
    }
 
    return res;
}

References args, ast_alloca, AST_APP_ARG, AST_DECLARE_APP_ARGS, ast_get_encoded_char(), ast_log, AST_STANDARD_APP_ARGS, ast_str_buffer(), ast_str_set(), ast_str_strlen(), ast_str_substitute_variables(), ast_str_thread_get(), ast_strlen_zero(), buf, len(), LOG_ERROR, NULL, str, and strsep().

Referenced by function_fieldnum(), and function_fieldnum_str().

function_fieldnum_str()

static int function_fieldnum_str ( struct ast_channel *  chan, const char *  cmd, char *  parse, struct ast_str **  buf, ssize_t  len  )

static

Definition at line 760 of file func_strings.c.

{
    return function_fieldnum_helper(chan, cmd, parse, NULL, buf, len);
}

References buf, function_fieldnum_helper(), len(), and NULL.

function_fieldqty()

static int function_fieldqty ( struct ast_channel *  chan, const char *  cmd, char *  parse, char *  buf, size_t  len  )

static

Definition at line 675 of file func_strings.c.

{
    return function_fieldqty_helper(chan, cmd, parse, buf, NULL, len);
}

References buf, function_fieldqty_helper(), len(), and NULL.

function_fieldqty_helper()

static int function_fieldqty_helper ( struct ast_channel *  chan, const char *  cmd, char *  parse, char *  buf, struct ast_str **  sbuf, ssize_t  len  )

static

Definition at line 630 of file func_strings.c.

{
    char *varsubst;
    struct ast_str *str = ast_str_thread_get(&result_buf, 16);
    int fieldcount = 0;
    AST_DECLARE_APP_ARGS(args,
                 AST_APP_ARG(varname);
                 AST_APP_ARG(delim);
        );
    char delim[2] = "";
    size_t delim_used;
 
    if (!str) {
        return -1;
    }
 
    AST_STANDARD_APP_ARGS(args, parse);
    if (args.delim) {
        ast_get_encoded_char(args.delim, delim, &delim_used);
 
        varsubst = ast_alloca(strlen(args.varname) + 4);
 
        sprintf(varsubst, "${%s}", args.varname);
        ast_str_substitute_variables(&str, 0, chan, varsubst);
        if (ast_str_strlen(str) == 0) {
            fieldcount = 0;
        } else {
            char *varval = ast_str_buffer(str);
            while (strsep(&varval, delim)) {
                fieldcount++;
            }
        }
    } else {
        fieldcount = 1;
    }
    if (sbuf) {
        ast_str_set(sbuf, len, "%d", fieldcount);
    } else {
        snprintf(buf, len, "%d", fieldcount);
    }
 
    return 0;
}

References args, ast_alloca, AST_APP_ARG, AST_DECLARE_APP_ARGS, ast_get_encoded_char(), AST_STANDARD_APP_ARGS, ast_str_buffer(), ast_str_set(), ast_str_strlen(), ast_str_substitute_variables(), ast_str_thread_get(), buf, len(), str, and strsep().

Referenced by function_fieldqty(), and function_fieldqty_str().

function_fieldqty_str()

static int function_fieldqty_str ( struct ast_channel *  chan, const char *  cmd, char *  parse, struct ast_str **  buf, ssize_t  len  )

static

Definition at line 681 of file func_strings.c.

{
    return function_fieldqty_helper(chan, cmd, parse, NULL, buf, len);
}

References buf, function_fieldqty_helper(), len(), and NULL.

function_ltrim()

static int function_ltrim ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1213 of file func_strings.c.

{
    char *c;
 
    if (ast_strlen_zero(data)) {
        return -1;
    }
 
    c = data;
    ltrim(c);
 
    ast_copy_string(buf, c, len);
 
    return 0;
}

References ast_copy_string(), ast_strlen_zero(), buf, c, len(), and ltrim.

function_rtrim()

static int function_rtrim ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1229 of file func_strings.c.

{
    char *c;
 
    if (ast_strlen_zero(data)) {
        return -1;
    }
 
    c = ast_strdupa(data);
    rtrim(c);
 
    ast_copy_string(buf, c, len);
 
    return 0;
}

References ast_copy_string(), ast_strdupa, ast_strlen_zero(), buf, c, len(), and rtrim.

function_trim()

static int function_trim ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1196 of file func_strings.c.

{
    char *c;
 
    if (ast_strlen_zero(data)) {
        return -1;
    }
 
    c = ast_strdupa(data);
    ltrim(c);
    rtrim(c);
 
    ast_copy_string(buf, c, len);
 
    return 0;
}

References ast_copy_string(), ast_strdupa, ast_strlen_zero(), buf, c, len(), ltrim, and rtrim.

get_key()

static const char * get_key ( const struct ast_str *  prefix, const struct ast_var_t *  var  )

static

Definition at line 1407 of file func_strings.c.

{
    const char *prefix_name = ast_str_buffer(prefix);
    const char *var_name = ast_var_name(var);
    int prefix_len;
    int var_len;
 
    if (ast_strlen_zero(var_name)) {
        return NULL;
    }
 
    prefix_len = ast_str_strlen(prefix);
    var_len = strlen(var_name);
 
    /*
     * Make sure we only match on non-empty, hash function created keys. If valid
     * then return a pointer to the variable that's just after the prefix.
     */
    return var_len > (prefix_len + 1) && var_name[var_len - 1] == '~' &&
        strncmp(prefix_name, var_name, prefix_len) == 0 ? var_name + prefix_len : NULL;
}

References ast_str_buffer(), ast_str_strlen(), ast_strlen_zero(), ast_var_name(), NULL, prefix, and var.

Referenced by hashkeys_read(), and hashkeys_read2().

hash_read()

static int hash_read ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1517 of file func_strings.c.

{
    char varname[256];
    const char *varvalue;
    AST_DECLARE_APP_ARGS(arg,
        AST_APP_ARG(hashname);
        AST_APP_ARG(hashkey);
    );
 
    AST_STANDARD_APP_ARGS(arg, data);
    if (arg.argc == 2) {
        snprintf(varname, sizeof(varname), HASH_FORMAT, arg.hashname, arg.hashkey);
        varvalue = pbx_builtin_getvar_helper(chan, varname);
        if (varvalue)
            ast_copy_string(buf, varvalue, len);
        else
            *buf = '\0';
    } else if (arg.argc == 1) {
        char colnames[4096];
        int i;
        AST_DECLARE_APP_ARGS(arg2,
            AST_APP_ARG(col)[100];
        );
 
        if (!chan) {
            ast_log(LOG_WARNING, "No channel and only 1 parameter was provided to %s function.\n", cmd);
            return -1;
        }
 
        /* Get column names, in no particular order */
        hashkeys_read(chan, "HASHKEYS", arg.hashname, colnames, sizeof(colnames));
        pbx_builtin_setvar_helper(chan, "~ODBCFIELDS~", colnames);
 
        AST_STANDARD_APP_ARGS(arg2, colnames);
        *buf = '\0';
 
        /* Now get the corresponding column values, in exactly the same order */
        for (i = 0; i < arg2.argc; i++) {
            snprintf(varname, sizeof(varname), HASH_FORMAT, arg.hashname, arg2.col[i]);
            varvalue = pbx_builtin_getvar_helper(chan, varname);
            /*
             * If the value is NULL, there was probably a malformation in the
             * column name (unbalanced quote, etc.)  This makes everything
             * suspect so we should return nothing at all.
             */
            if (!varvalue) {
                ast_log(LOG_WARNING, "No value found for '%s'\n", varname);
                *buf = '\0';
                return -1;
            }
            strncat(buf, varvalue, len - strlen(buf) - 1);
            strncat(buf, ",", len - strlen(buf) - 1);
        }
 
        /* Strip trailing comma */
        buf[strlen(buf) - 1] = '\0';
    }
 
    return 0;
}

References AST_APP_ARG, ast_copy_string(), AST_DECLARE_APP_ARGS, ast_log, AST_STANDARD_APP_ARGS, buf, HASH_FORMAT, hashkeys_read(), len(), LOG_WARNING, pbx_builtin_getvar_helper(), and pbx_builtin_setvar_helper().

hash_write()

static int hash_write ( struct ast_channel *  chan, const char *  cmd, char *  var, const char *  value  )

static

Definition at line 1489 of file func_strings.c.

{
    char varname[256];
    AST_DECLARE_APP_ARGS(arg,
        AST_APP_ARG(hashname);
        AST_APP_ARG(hashkey);
    );
 
    if (!strchr(var, ',')) {
        /* Single argument version */
        return array(chan, "HASH", var, value);
    }
 
    AST_STANDARD_APP_ARGS(arg, var);
    if (arg.hashname[0] == '_') {
        if (arg.hashname[1] == '_') {
            snprintf(varname, sizeof(varname), "__" HASH_FORMAT, arg.hashname + 2, arg.hashkey);
        } else {
            snprintf(varname, sizeof(varname), "_" HASH_FORMAT, arg.hashname + 1, arg.hashkey);
        }
    } else {
        snprintf(varname, sizeof(varname), HASH_FORMAT, arg.hashname, arg.hashkey);
    }
    pbx_builtin_setvar_helper(chan, varname, value);
 
    return 0;
}

References array(), AST_APP_ARG, AST_DECLARE_APP_ARGS, AST_STANDARD_APP_ARGS, HASH_FORMAT, pbx_builtin_setvar_helper(), value, and var.

hashkeys_read()

static int hashkeys_read ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1429 of file func_strings.c.

{
    struct ast_var_t *newvar;
    struct ast_str *prefix = ast_str_alloca(80);
    size_t buf_len;
 
    if (!chan) {
        ast_log(LOG_WARNING, "No channel was provided to %s function.\n", cmd);
        return -1;
    }
 
    ast_str_set(&prefix, -1, HASH_PREFIX, data);
    memset(buf, 0, len);
 
    AST_LIST_TRAVERSE(ast_channel_varshead(chan), newvar, entries) {
        const char *key = get_key(prefix, newvar);
 
        if (key) {
            strncat(buf, key, len - strlen(buf) - 1);
            /* Replace the trailing ~ */
            buf[strlen(buf) - 1] = ',';
        }
    }
    /* Trim the trailing comma */
    buf_len = strlen(buf);
    if (buf_len) {
        buf[buf_len - 1] = '\0';
    }
    return 0;
}

References ast_channel_varshead(), AST_LIST_TRAVERSE, ast_log, ast_str_alloca, ast_str_set(), buf, get_key(), HASH_PREFIX, len(), LOG_WARNING, and prefix.

Referenced by hash_read().

hashkeys_read2()

static int hashkeys_read2 ( struct ast_channel *  chan, const char *  cmd, char *  data, struct ast_str **  buf, ssize_t  len  )

static

Definition at line 1460 of file func_strings.c.

{
    struct ast_var_t *newvar;
    struct ast_str *prefix = ast_str_alloca(80);
 
    if (!chan) {
        ast_log(LOG_WARNING, "No channel was provided to %s function.\n", cmd);
        return -1;
    }
 
    ast_str_set(&prefix, -1, HASH_PREFIX, data);
 
    AST_LIST_TRAVERSE(ast_channel_varshead(chan), newvar, entries) {
        const char *key = get_key(prefix, newvar);
 
        if (key) {
            char *tmp;
 
            ast_str_append(buf, len, "%s", key);
            /* Replace the trailing ~ */
            tmp = ast_str_buffer(*buf);
            tmp[ast_str_strlen(*buf) - 1] = ',';
        }
    }
 
    ast_str_truncate(*buf, -1);
    return 0;
}

References ast_channel_varshead(), AST_LIST_TRAVERSE, ast_log, ast_str_alloca, ast_str_append(), ast_str_buffer(), ast_str_set(), ast_str_strlen(), ast_str_truncate(), buf, get_key(), HASH_PREFIX, len(), LOG_WARNING, and prefix.

keypadhash()

static int keypadhash ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  buflen  )

static

Definition at line 1795 of file func_strings.c.

{
    char *bufptr, *dataptr;
 
    for (bufptr = buf, dataptr = data; bufptr < buf + buflen - 1; dataptr++) {
        if (*dataptr == '\0') {
            *bufptr++ = '\0';
            break;
        } else if (*dataptr == '1') {
            *bufptr++ = '1';
        } else if (strchr("AaBbCc2", *dataptr)) {
            *bufptr++ = '2';
        } else if (strchr("DdEeFf3", *dataptr)) {
            *bufptr++ = '3';
        } else if (strchr("GgHhIi4", *dataptr)) {
            *bufptr++ = '4';
        } else if (strchr("JjKkLl5", *dataptr)) {
            *bufptr++ = '5';
        } else if (strchr("MmNnOo6", *dataptr)) {
            *bufptr++ = '6';
        } else if (strchr("PpQqRrSs7", *dataptr)) {
            *bufptr++ = '7';
        } else if (strchr("TtUuVv8", *dataptr)) {
            *bufptr++ = '8';
        } else if (strchr("WwXxYyZz9", *dataptr)) {
            *bufptr++ = '9';
        } else if (*dataptr == '0') {
            *bufptr++ = '0';
        }
    }
    buf[buflen - 1] = '\0';
 
    return 0;
}

References buf.

len()

static int len ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  buflen  )

static

Definition at line 1669 of file func_strings.c.

{
    int length = 0;
 
    if (data)
        length = strlen(data);
 
    snprintf(buf, buflen, "%d", length);
 
    return 0;
}

References buf.

Referenced by __analog_ss_thread(), __ast_cli_register(), __ast_cli_register_multiple(), __ast_dsp_call_progress(), __ast_dsp_silence_noise(), __ast_frdup(), OrderedDict::__eq__(), OrderedDict::__init__(), __rtp_recvfrom(), __rtp_sendto(), MultiOrderedDict::__setitem__(), FaxPcap::_make_packet(), AbsQuantW(), acf_curl_exec(), acf_curlopt_helper(), acf_curlopt_read(), acf_curlopt_read2(), acf_cut_exec(), acf_cut_exec2(), acf_escape(), acf_escape_backslashes(), acf_escape_ticks(), acf_faxopt_read(), acf_fetch(), acf_iaxvar_read(), acf_if(), acf_meetme_info(), acf_odbc_read(), acf_sort_exec(), acf_sprintf(), acf_transaction_read(), acf_vm_info(), acf_vmcount_exec(), action_command(), adsi_careful_send(), ael_token_subst(), aes_helper(), agent_function_read(), amdf_pitch(), anaFilter(), analog_ss_thread(), anti_injection(), anti_injection(), aoc_parse_ie(), append_attr_address(), append_attr_string(), append_var_and_value_to_filter(), apply_outgoing(), ast_agi_register_multiple(), ast_agi_unregister_multiple(), ast_app_group_set_channel(), ast_app_options2str64(), ast_beep_start(), ast_bucket_alloc(), ast_bucket_file_alloc(), ast_callerid_vmwi_generate(), ast_carefulwrite(), ast_channel_get_cc_agent_type(), ast_channel_get_device_name(), ast_check_command_in_path(), ast_cli_complete(), ast_cli_unregister_multiple(), ast_dsp_process(), ast_dsp_silence_noise_with_energy(), ast_format_str_reduce(), ast_frame_type2str(), ast_func_read(), ast_gen_cas(), ast_get_builtin_feature(), ast_get_feature(), ast_get_namedgroups(), ast_http_prefix(), ast_http_send(), ast_http_uri_link(), ast_iostream_gets(), ast_iostream_printf(), ast_join_delim(), ast_json_nvp_array_to_ast_variables(), ast_json_utf8_check_len(), ast_media_cache_retrieve(), ast_media_cache_retrieve_metadata(), ast_mkdir(), ast_msg_data_alloc(), ast_read_image(), ast_readstring(), ast_readstring_full(), ast_recvfrom(), ast_rtcp_generate_report(), ast_rtcp_generate_sdes(), ast_rtcp_interpret(), ast_rtp_interpret(), ast_say_number_full_ka(), ast_sendto(), ast_sip_sanitize_xml(), ast_smoother_read(), ast_sockaddr_copy_sockaddr(), ast_speech_get_setting(), ast_speech_write(), ast_srtp_get_random(), ast_srtp_protect(), ast_srtp_unprotect(), ast_statsd_log_string(), ast_stir_shaken_vs_verify(), ast_str_buffer(), ast_str_substitute_variables_full2(), ast_strftime(), ast_strftime_locale(), ast_stun_handle_packet(), ast_tdd_gen_ecdisa(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), ast_translate(), ast_udptl_write(), ast_websocket_write_string(), ast_xml_escape(), ast_xmldoc_printable(), auth_exec(), authenticate(), base64_buf_helper(), base64_helper(), base64_str_helper(), blacklist_read(), blacklist_read2(), bridge_p2p_rtp_write(), bucket_copy(), bucket_file_wizard_retrieve(), bucket_wizard_retrieve(), buf_hash(), buf_hash_add(), build_device(), build_ha(), build_rand_pad(), build_regex(), build_regex(), build_regex(), builtin_feature_get_exten(), calc_energy(), calendar_event_read(), calendar_join_attendees(), calendar_query_exec(), calendar_query_result_exec(), callerid_feed(), callerid_feed_jp(), callerid_full_tz_generate(), callerid_read(), canonicalize_tn(), careful_write(), category_set_sublevels(), CB_ADD_LEN(), CB_ADD_LEN(), cdata(), cdr_read(), channel_do_masquerade(), chararray_handler_fn(), check_dirpath(), chunked_atoh(), cleaned_basedn(), clearvar_prefix(), cli_complete(), cli_console_sendtext(), sip_to_pjsql::cli_options(), complete_confno(), complete_dialplan_add_extension(), complete_dialplan_add_ignorepat(), complete_dialplan_add_include(), complete_dialplan_remove_context(), complete_dialplan_remove_extension(), complete_dialplan_remove_ignorepat(), complete_dialplan_remove_include(), complete_meetmecmd_list(), complete_meetmecmd_mute_kick(), complete_peer_helper(), complete_userno(), conf_get_pin(), conf_play(), config_function_read(), connectedline_read(), copy(), copy(), copy_string(), create_dirpath(), create_dirpath(), create_video_frame(), crement_function_read(), crypto_get_cert_subject(), csv_quote(), custom_level_still_exists(), dahdi_func_read(), dahdi_sendtext(), dahdi_setoption(), dahdichan_read_property(), dbl_list_expect_reverse(), dcbias_(), decode_length(), decode_open_type(), decrypt_memcpy(), DEFINE_SQL_STATEMENT(), devstate_read(), devstate_write(), dialgroup_read(), dialgroup_refreshdb(), dictate_exec(), dns_parse_answer(), dtmf_store_framehook(), dump_addr(), dump_answer(), dump_byte(), dump_byte(), dump_cause(), dump_datetime(), dump_eid(), dump_encrypted(), dump_hint(), dump_ies(), dump_ies(), dump_int(), dump_int(), dump_ipaddr(), dump_prefs(), dump_prov(), dump_prov_flags(), dump_prov_ies(), dump_raw(), dump_samprate(), dump_short(), dump_short(), dump_string(), dump_string(), dump_string_hex(), dump_versioned_codec(), dundi_encrypt(), dundi_parse_ies(), dundi_query_read(), dundi_result_read(), dundi_send(), dundifunc_read(), ebl_callback(), encode_length(), encode_open_type(), encrypt_memcpy(), energy_(), enum_callback(), enum_query_read(), enum_result_read(), env_read(), eval_exten_read(), eval_sub_read(), expand_gosub_args(), expr2_token_subst(), ext_cmp_exten_strlen(), ext_strncpy(), extract_oli(), extstate_read(), fbuf_append(), feature_read(), featuremap_get(), featuremap_read(), fetch_callerid_num(), fetch_response_reader(), fetch_response_reader(), fetch_response_reader(), ffmpeg_decode(), file2display(), file_basename(), file_count_line(), file_dirname(), file_format(), file_read(), filename_parse(), filter(), frame_set_var(), fsk_serial(), func_channel_read(), func_confbridge_channels(), func_confbridge_info(), func_get_parkingslot_channel(), func_mchan_read(), func_mixmonitor_read(), func_read(), func_read_header(), func_read_headers(), func_read_param(), func_response_read_header(), func_response_read_headers(), function_amiclient(), function_db_delete(), function_db_exists(), function_db_keycount(), function_db_read(), function_enum(), function_fieldnum(), function_fieldnum_helper(), function_fieldnum_str(), function_fieldqty(), function_fieldqty_helper(), function_fieldqty_str(), function_iaxpeer(), function_ltrim(), function_ooh323_read(), function_realtime_read(), function_realtime_readdestroy(), function_rtrim(), function_trim(), function_txtcidname(), g722_decode(), g722_encode(), gen_tone(), gen_tones(), general_get(), geoloc_profile_read(), PathSegment::get_child(), get_date(), get_date(), get_date(), get_date(), get_name_from_resource(), global_read(), group_count_function_read(), group_function_read(), group_list_function_read(), group_match_count_function_read(), gsm_write(), gsmtolin_framein(), h261_decap(), h261_encap(), h263_decap(), h263_encap(), h263_read(), h263_write(), h263p_decap(), h263p_encap(), h264_decap(), h264_read(), h264_write(), handle_cli_devstate_change(), handle_cli_mobile_search(), handle_cli_moh_unregister_class(), handle_cli_presencestate_change(), handle_commandmatchesarray(), handle_output(), handle_show_sysinfo(), hangupcause_keys_read(), hangupcause_read(), Model::has_properties(), Model::has_subtypes(), hash_read(), hashkeys_read(), hashkeys_read2(), header_identify_match_check(), help1(), hepv3_create_capture_info(), hint_read(), hook_read(), hpInput(), hpOutput(), http_request_headers_get(), httpd_process_request(), iax2_getpeername(), iax_frame_subclass2str(), iax_parse_ies(), iax_str2flags(), iconv_read(), ifmodule_read(), iftime(), import_helper(), import_read(), import_read2(), inner_product_single(), internal_feature_read(), internal_featuremap_read(), interpolate_product_single(), ip_identify_apply(), isodate(), ivfilt_(), json_decode_read(), json_utf8_check_full(), linear_generator(), listener(), listfilter(), listfilter_read(), listfilter_read2(), load_file(), local_read(), lock_read(), lpc10_decode(), lpc10tolin_framein(), lpfilt_(), refcounter::main(), main(), spandspflow2pcap::main(), make_dir(), make_dir(), make_file(), make_filename(), manager_login(), math(), MD5Update(), media_offer_read_av(), memcpy_decrypt(), memcpy_encrypt(), message_template_parse_emailbody(), milliwatt_generate(), minivm_account_func_read(), minivm_counter_func_read(), moh_generate(), monmp3thread(), mpeg4_decap(), mpeg4_encap(), msg_data_func_read(), msg_func_read(), msg_to_endpoint(), my_dahdi_write(), newpvt(), PathSegment::num_children(), parse_bookmark(), parse_cdata(), parse_ie(), refcounter::parse_line(), get_documentation::parse_manager_event_instance(), parse_naptr(), parse_node(), parse_srv(), partial_match(), party_id_read(), party_name_read(), party_number_read(), party_subaddress_read(), passthru(), pbx_substitute_variables_helper_full(), pbx_substitute_variables_helper_full_location(), peek_read(), phoneprov_callback(), pickup_get(), pjsip_acf_channel_read(), pjsip_acf_dial_contacts_read(), pjsip_acf_dtmf_mode_read(), pjsip_acf_media_offer_read(), pjsip_acf_moh_passthrough_read(), pjsip_aor_function_read(), pjsip_contact_function_read(), pjsip_endpoint_function_read(), playtone(), playtones_generator(), plc_fillin(), plc_rx(), pp_each_extension_helper(), pp_each_extension_read(), pp_each_extension_read2(), pp_each_user_helper(), pp_each_user_read(), pp_each_user_read2(), presence_read(), presence_write(), print_body(), print_subchannel(), process_cn_rfc3389(), process_dtmf_cisco(), process_dtmf_rfc2833(), reflocks::process_file(), refstats::process_file(), queue_frame_from_buffer(), queue_function_exists(), queue_function_mem_read(), queue_function_memberpenalty_read(), queue_function_queuegetchannel(), queue_function_queuememberlist(), queue_function_queuewaitingcount(), queue_function_var(), quote(), read_credentials(), read_header(), read_headers(), realtimefield_read(), recording_info_read(), red_t140_to_red(), redirecting_read(), refer_blind_callback(), regex(), remove_header(), replace(), request_identify_match_check(), res_sdp_srtp_get_attr(), reschedule_precache(), resource_name_baselen(), rtp_instance_parse_extmap_extensions(), run_agi(), save_history(), sayfile_exec(), scan_thread(), schedule_delivery(), sco_accept(), sco_write(), send_signal(), send_string(), set(), set2(), set_bridge_peer_vars_multiparty(), sha1(), shared_read(), shared_write(), shell_helper(), shift_pop(), skip_name(), smdi_msg_read(), smdi_msg_retrieve_read(), sms_generate(), sms_messagetx(), socket_process_meta(), sorcery_function_read(), speech_aeap_engine_get_setting(), speech_aeap_engine_write(), speech_engine_read(), speech_grammar(), speech_read(), speech_score(), speech_text(), speex_get_wb_sz_at(), speex_read(), speex_samples(), sprint_list_entry(), srv_callback(), srv_query_read(), srv_result_read(), stackpeek_read(), start_automixmonitor(), stat_read(), StateConstructW(), StateSearchW(), static_callback(), strbetween(), strreplace(), syntFilter(), sysinfo_helper(), t38_tx_packet_handler(), tdd_feed(), term_filter_escapes(), timeout_read(), tonepair_generator(), transfer_exec(), try_firmware(), trylock_read(), txt_callback(), udptl_build_packet(), udptl_rx_packet(), unistim_sp(), unlock_read(), unquote(), OrderedDict::update(), uri_parse_and_default(), uridecode(), uriencode(), varlist_to_str(), vm_check_password_shell(), wav_write(), websocket_client_handshake_get_response(), ws_safe_read(), ws_send_msg(), xfer_get(), xmldoc_get_syntax_fun(), xmldoc_reverse_helper(), xmldoc_setpostbr(), xmpp_client_authenticate_sasl(), xmpp_client_receive(), xmpp_client_send_raw_message(), and xmpp_io_recv().

listfilter()

static int listfilter ( struct ast_channel *  chan, const char *  cmd, char *  parse, char *  buf, struct ast_str **  bufstr, ssize_t  len  )

static

Definition at line 772 of file func_strings.c.

{
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(listname);
        AST_APP_ARG(delimiter);
        AST_APP_ARG(fieldvalue);
    );
    struct ast_str *orig_list = ast_str_thread_get(&tmp_buf, 16);
    const char *begin, *cur, *next;
    int dlen, flen, first = 1;
    struct ast_str *result, **result_ptr = &result;
    char *delim, *varsubst;
 
    AST_STANDARD_APP_ARGS(args, parse);
 
    if (buf) {
        if (!(result = ast_str_thread_get(&result_buf, 16))) {
            return -1;
        }
    } else {
        /* Place the result directly into the output buffer */
        result_ptr = bufstr;
    }
 
    if (args.argc < 3) {
        ast_log(LOG_ERROR, "Usage: LISTFILTER(<listname>,<delimiter>,<fieldvalue>)\n");
        return -1;
    }
 
    varsubst = ast_alloca(strlen(args.listname) + 4);
    sprintf(varsubst, "${%s}", args.listname);
 
    /* If we don't lock the channel, the variable could disappear out from underneath us. */
    if (chan) {
        ast_channel_lock(chan);
    }
    ast_str_substitute_variables(&orig_list, 0, chan, varsubst);
    if (!ast_str_strlen(orig_list)) {
        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 (!strstr(ast_str_buffer(orig_list), args.fieldvalue)) {
        if (buf) {
            ast_copy_string(buf, ast_str_buffer(orig_list), len);
        } else {
            ast_str_set(result_ptr, len, "%s", ast_str_buffer(orig_list));
        }
        if (chan) {
            ast_channel_unlock(chan);
        }
        return 0;
    }
 
    dlen = strlen(args.delimiter);
    delim = ast_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_ptr);
    /* Enough space for any result */
    if (len > -1) {
        ast_str_make_space(result_ptr, len ? len : ast_str_strlen(orig_list) + 1);
    }
 
    begin = ast_str_buffer(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 (!first) {
                ast_str_append(result_ptr, len, "%s", delim);
            }
 
            ast_str_append_substr(result_ptr, len, begin, cur - begin);
            first = 0;
            begin = cur + dlen;
        }
    } while (*cur != '\0');
    if (chan) {
        ast_channel_unlock(chan);
    }
 
    if (buf) {
        ast_copy_string(buf, ast_str_buffer(result), len);
    }
 
    return 0;
}

References args, ast_alloca, AST_APP_ARG, ast_channel_lock, ast_channel_unlock, ast_copy_string(), AST_DECLARE_APP_ARGS, ast_get_encoded_str(), ast_log, AST_STANDARD_APP_ARGS, ast_str_append(), ast_str_append_substr(), ast_str_buffer(), ast_str_make_space, ast_str_reset(), ast_str_set(), ast_str_strlen(), ast_str_substitute_variables(), ast_str_thread_get(), buf, first, len(), LOG_ERROR, and result.

Referenced by listfilter_read(), and listfilter_read2().

listfilter_read()

static int listfilter_read ( struct ast_channel *  chan, const char *  cmd, char *  parse, char *  buf, size_t  len  )

static

Definition at line 883 of file func_strings.c.

{
    return listfilter(chan, cmd, parse, buf, NULL, len);
}

References buf, len(), listfilter(), and NULL.

listfilter_read2()

static int listfilter_read2 ( struct ast_channel *  chan, const char *  cmd, char *  parse, struct ast_str **  buf, ssize_t  len  )

static

Definition at line 888 of file func_strings.c.

{
    return listfilter(chan, cmd, parse, NULL, buf, len);
}

References buf, len(), listfilter(), and NULL.

load_module()

static int load_module ( void  )

static

Definition at line 2452 of file func_strings.c.

{
    int res = 0;
 
    AST_TEST_REGISTER(test_FIELDNUM);
    AST_TEST_REGISTER(test_REPLACE);
    AST_TEST_REGISTER(test_FILTER);
    AST_TEST_REGISTER(test_STRREPLACE);
    AST_TEST_REGISTER(test_STRBETWEEN);
    AST_TEST_REGISTER(test_TRIM);
    res |= ast_custom_function_register(&fieldqty_function);
    res |= ast_custom_function_register(&fieldnum_function);
    res |= ast_custom_function_register(&filter_function);
    res |= ast_custom_function_register(&replace_function);
    res |= ast_custom_function_register(&strreplace_function);
    res |= ast_custom_function_register(&strbetween_function);
    res |= ast_custom_function_register(&listfilter_function);
    res |= ast_custom_function_register(&regex_function);
    res |= ast_custom_function_register(&array_function);
    res |= ast_custom_function_register(&quote_function);
    res |= ast_custom_function_register(&csv_quote_function);
    res |= ast_custom_function_register(&len_function);
    res |= ast_custom_function_register(&strftime_function);
    res |= ast_custom_function_register(&strptime_function);
    res |= ast_custom_function_register(&eval_function);
    res |= ast_custom_function_register(&keypadhash_function);
    res |= ast_custom_function_register(&hashkeys_function);
    res |= ast_custom_function_register(&hash_function);
    res |= ast_register_application_xml(app_clearhash, exec_clearhash);
    res |= ast_custom_function_register(&toupper_function);
    res |= ast_custom_function_register(&tolower_function);
    res |= ast_custom_function_register(&shift_function);
    res |= ast_custom_function_register(&pop_function);
    res |= ast_custom_function_register(&push_function);
    res |= ast_custom_function_register(&unshift_function);
    res |= ast_custom_function_register(&passthru_function);
    res |= ast_custom_function_register(&trim_function);
    res |= ast_custom_function_register(&ltrim_function);
    res |= ast_custom_function_register(&rtrim_function);
 
    return res;
}

References app_clearhash, array_function, ast_custom_function_register, ast_register_application_xml, AST_TEST_REGISTER, csv_quote_function, eval_function, exec_clearhash(), fieldnum_function, fieldqty_function, filter_function, hash_function, hashkeys_function, keypadhash_function, len_function, listfilter_function, ltrim_function, passthru_function, pop_function, push_function, quote_function, regex_function, replace_function, rtrim_function, shift_function, strbetween_function, strftime_function, strptime_function, strreplace_function, tolower_function, toupper_function, trim_function, and unshift_function.

passthru()

static int passthru ( struct ast_channel *  chan, const char *  cmd, char *  data, struct ast_str **  buf, ssize_t  len  )

static

Definition at line 2017 of file func_strings.c.

{
    ast_str_set(buf, len, "%s", data);
    return 0;
}

References ast_str_set(), buf, and len().

quote()

static int quote ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1595 of file func_strings.c.

{
    char *bufptr = buf, *dataptr = data;
 
    if (len < 3){ /* at least two for quotes and one for binary zero */
        ast_log(LOG_ERROR, "Not enough buffer\n");
        return -1;
    }
 
    if (ast_strlen_zero(data)) {
        ast_log(LOG_WARNING, "No argument specified!\n");
        ast_copy_string(buf, "\"\"", len);
        return 0;
    }
 
    *bufptr++ = '"';
    for (; bufptr < buf + len - 3; dataptr++) {
        if (*dataptr == '\\') {
            *bufptr++ = '\\';
            *bufptr++ = '\\';
        } else if (*dataptr == '"') {
            *bufptr++ = '\\';
            *bufptr++ = '"';
        } else if (*dataptr == '\0') {
            break;
        } else {
            *bufptr++ = *dataptr;
        }
    }
    *bufptr++ = '"';
    *bufptr = '\0';
    return 0;
}

References ast_copy_string(), ast_log, ast_strlen_zero(), buf, len(), LOG_ERROR, and LOG_WARNING.

Referenced by __ast_app_separate_args(), ast_app_separate_args(), ast_strsep_quoted(), ast_variable_list_from_quoted_string(), and parse_options().

regex()

static int regex ( struct ast_channel *  chan, const char *  cmd, char *  parse, char *  buf, size_t  len  )

static

Definition at line 1263 of file func_strings.c.

{
    AST_DECLARE_APP_ARGS(args,
                 AST_APP_ARG(null);
                 AST_APP_ARG(reg);
                 AST_APP_ARG(str);
    );
    int errcode;
    regex_t regexbuf;
 
    buf[0] = '\0';
 
    AST_NONSTANDARD_APP_ARGS(args, parse, '"');
 
    if (args.argc != 3) {
        ast_log(LOG_ERROR, "Unexpected arguments: should have been in the form '\"<regex>\" <string>'\n");
        return -1;
    }
    if ((*args.str == ' ') || (*args.str == '\t'))
        args.str++;
 
    ast_debug(1, "FUNCTION REGEX (%s)(%s)\n", args.reg, args.str);
 
    if ((errcode = regcomp(&regexbuf, args.reg, REG_EXTENDED | REG_NOSUB))) {
        regerror(errcode, &regexbuf, buf, len);
        ast_log(LOG_WARNING, "Malformed input %s(%s): %s\n", cmd, parse, buf);
        return -1;
    }
 
    strcpy(buf, regexec(&regexbuf, args.str, 0, NULL, 0) ? "0" : "1");
 
    regfree(&regexbuf);
 
    return 0;
}

References args, AST_APP_ARG, ast_debug, AST_DECLARE_APP_ARGS, ast_log, AST_NONSTANDARD_APP_ARGS, buf, len(), LOG_ERROR, LOG_WARNING, NULL, and str.

Referenced by ast_mwi_mailbox_delete_by_regex(), ast_mwi_mailbox_get_by_regex(), ast_sip_cli_traverse_objects(), ast_sorcery_object_fields_register(), ast_sorcery_retrieve_by_regex(), ast_strings_match(), build_regex(), build_regex(), build_regex(), cli_aor_get_container(), cli_channel_get_container(), cli_channelstats_get_container(), cli_contact_get_container(), cli_endpoint_get_container(), cli_get_container(), cli_get_container(), cli_get_container(), cli_get_container(), cli_list_subscriptions_inout(), cli_show_monitors(), cli_show_subscriptions_inout(), cli_show_tasks(), get_container(), make_astdb_prefix_pattern(), sorcery_astdb_retrieve_regex(), sorcery_config_retrieve_regex(), sorcery_memory_cache_retrieve_regex(), sorcery_memory_retrieve_regex(), sorcery_realtime_retrieve_regex(), xmldoc_get_syntax_config_option(), and xmldoc_update_config_option().

replace()

static int replace ( struct ast_channel *  chan, const char *  cmd, char *  data, struct ast_str **  buf, ssize_t  len  )

static

Definition at line 980 of file func_strings.c.

{
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(varname);
        AST_APP_ARG(find);
        AST_APP_ARG(replace);
    );
    char *strptr, *varsubst;
    RAII_VAR(struct ast_str *, str, ast_str_create(16), ast_free);
    char find[256]; /* Only 256 characters possible */
    char replace[2] = "";
    size_t unused;
 
    AST_STANDARD_APP_ARGS(args, data);
 
    if (!str) {
        return -1;
    }
 
    if (args.argc < 2) {
        ast_log(LOG_ERROR, "Usage: %s(<varname>,<search-chars>[,<replace-char>])\n", cmd);
        return -1;
    }
 
    /* Decode escapes */
    ast_get_encoded_str(args.find, find, sizeof(find));
    ast_get_encoded_char(args.replace, replace, &unused);
 
    if (ast_strlen_zero(find) || ast_strlen_zero(args.varname)) {
        ast_log(LOG_ERROR, "The characters to search for and the variable name must not be empty.\n");
        return -1;
    }
 
    varsubst = ast_alloca(strlen(args.varname) + 4);
    sprintf(varsubst, "${%s}", args.varname);
    ast_str_substitute_variables(&str, 0, chan, varsubst);
 
    if (!ast_str_strlen(str)) {
        /* Blank, nothing to replace */
        return -1;
    }
 
    ast_debug(3, "String to search: (%s)\n", ast_str_buffer(str));
    ast_debug(3, "Characters to find: (%s)\n", find);
    ast_debug(3, "Character to replace with: (%s)\n", replace);
 
    for (strptr = ast_str_buffer(str); *strptr; strptr++) {
        /* buf is already a mutable buffer, so we construct the result
         * directly there */
        if (strchr(find, *strptr)) {
            if (ast_strlen_zero(replace)) {
                memmove(strptr, strptr + 1, strlen(strptr + 1) + 1);
                strptr--;
            } else {
                /* Replace character */
                *strptr = *replace;
            }
        }
    }
 
    ast_str_set(buf, len, "%s", ast_str_buffer(str));
    return 0;
}

References args, ast_alloca, AST_APP_ARG, ast_debug, AST_DECLARE_APP_ARGS, ast_free, ast_get_encoded_char(), ast_get_encoded_str(), ast_log, AST_STANDARD_APP_ARGS, ast_str_buffer(), ast_str_create, ast_str_set(), ast_str_strlen(), ast_str_substitute_variables(), ast_strlen_zero(), buf, len(), LOG_ERROR, RAII_VAR, replace(), and str.

Referenced by FaxPcap::add(), add_header(), add_pri(), add_priority(), app_get_replace_channel_app(), app_set_replace_channel_app(), app_set_replace_channel_snapshot(), ast_add_extension(), ast_add_extension2(), ast_add_extension2(), ast_add_extension2(), ast_add_extension2_lockopt(), ast_add_extension2_nolock(), ast_add_extension_nolock(), ast_sip_add_global_request_header(), ast_sip_add_global_response_header(), ast_translator_best_choice(), bridge_features_ds_set_full(), channel_feature_hooks_set_full(), get_replace_channel_snapshot(), ApiDeclaration::load_file(), localized_add_extension2(), manager_dialplan_extension_add(), spandspflow2pcap::n2b(), parking_add_extension(), get_documentation::parse_manager_event_instance(), process_text_line(), replace(), replace_channel_destroy(), rtp_codecs_payload_set_rx(), and astconfigparser::try_section().

shift_pop()

static int shift_pop ( struct ast_channel *  chan, const char *  cmd, char *  data, struct ast_str **  buf, ssize_t  len  )

static

Definition at line 1893 of file func_strings.c.

{
#define beginning   (cmd[0] == 'S') /* SHIFT */
    char *after, delimiter[2] = ",", *varsubst;
    size_t unused;
    struct ast_str *before = ast_str_thread_get(&result_buf, 16);
    char *(*search_func)(const char *s, int c) = (beginning ? strchr : strrchr);
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(var);
        AST_APP_ARG(delimiter);
    );
 
    if (!before) {
        return -1;
    }
 
    AST_STANDARD_APP_ARGS(args, data);
 
    if (ast_strlen_zero(args.var)) {
        ast_log(LOG_WARNING, "%s requires a variable name\n", cmd);
        return -1;
    }
 
    varsubst = ast_alloca(strlen(args.var) + 4);
    sprintf(varsubst, "${%s}", args.var);
    ast_str_substitute_variables(&before, 0, chan, varsubst);
 
    if (args.argc > 1 && !ast_strlen_zero(args.delimiter)) {
        ast_get_encoded_char(args.delimiter, delimiter, &unused);
    }
 
    if (!ast_str_strlen(before)) {
        /* Nothing to pop */
        return -1;
    }
 
    if (!(after = search_func(ast_str_buffer(before), delimiter[0]))) {
        /* Only one entry in array */
        ast_str_set(buf, len, "%s", ast_str_buffer(before));
        pbx_builtin_setvar_helper(chan, args.var, "");
    } else {
        *after++ = '\0';
        ast_str_set(buf, len, "%s", beginning ? ast_str_buffer(before) : after);
        pbx_builtin_setvar_helper(chan, args.var, beginning ? after : ast_str_buffer(before));
    }
 
    return 0;
#undef beginning
}

References args, ast_alloca, AST_APP_ARG, AST_DECLARE_APP_ARGS, ast_get_encoded_char(), ast_log, AST_STANDARD_APP_ARGS, ast_str_buffer(), ast_str_set(), ast_str_strlen(), ast_str_substitute_variables(), ast_str_thread_get(), ast_strlen_zero(), beginning, buf, c, len(), LOG_WARNING, pbx_builtin_setvar_helper(), and var.

strbetween()

static int strbetween ( struct ast_channel *  chan, const char *  cmd, char *  data, struct ast_str **  buf, ssize_t  len  )

static

Definition at line 1138 of file func_strings.c.

{
    int c, origsize;
    char *varsubstr, *origstr;
    struct ast_str *str = ast_str_thread_get(&result_buf, 16); /* Holds the data obtained from varname */
 
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(varname);
        AST_APP_ARG(insert_string);
        AST_APP_ARG(other); /* Any remining unused arguments */
    );
 
    ast_str_reset(*buf);
 
    if (!str) {
        ast_log(LOG_ERROR, "Couldn't obtain string\n");
        return -1;
    }
 
    AST_STANDARD_APP_ARGS(args, data);
 
    if (args.argc != 2 || ast_strlen_zero(args.varname)) {
        ast_log(LOG_ERROR, "Usage: %s(<varname>,<insert-string>)\n", cmd);
        return -1;
    }
 
    varsubstr = ast_alloca(strlen(args.varname) + 4);
    sprintf(varsubstr, "${%s}", args.varname);
    ast_str_substitute_variables(&str, 0, chan, varsubstr);
    origstr = ast_str_buffer(str);
    origsize = strlen(origstr);
    for (c = 0; c < origsize; c++) {
        ast_str_append(buf, len, "%c", origstr[c]);
        /* no insert after the last character */
        if (c < (origsize - 1)) {
            ast_str_append(buf, len, "%s", args.insert_string);
        }
    }
 
    return 0;
}

References args, ast_alloca, AST_APP_ARG, AST_DECLARE_APP_ARGS, ast_log, AST_STANDARD_APP_ARGS, ast_str_append(), ast_str_buffer(), ast_str_reset(), ast_str_substitute_variables(), ast_str_thread_get(), ast_strlen_zero(), buf, c, len(), LOG_ERROR, and str.

string_tolower()

static int string_tolower ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  buflen  )

static

Definition at line 1864 of file func_strings.c.

{
    char *bufptr = buf, *dataptr = data;
 
    while ((bufptr < buf + buflen - 1) && (*bufptr++ = tolower(*dataptr++)));
 
    return 0;
}

References buf.

string_tolower2()

static int string_tolower2 ( struct ast_channel *  chan, const char *  cmd, char *  data, struct ast_str **  buf, ssize_t  buflen  )

static

Definition at line 1873 of file func_strings.c.

{
    char *bufptr, *dataptr = data;
 
    if (buflen > -1) {
        ast_str_make_space(buf, buflen > 0 ? buflen : strlen(data) + 1);
    }
    bufptr = ast_str_buffer(*buf);
    while ((bufptr < ast_str_buffer(*buf) + ast_str_size(*buf) - 1) && (*bufptr++ = tolower(*dataptr++)));
    ast_str_update(*buf);
 
    return 0;
}

References ast_str_buffer(), ast_str_make_space, ast_str_size(), ast_str_update(), and buf.

string_toupper()

static int string_toupper ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  buflen  )

static

Definition at line 1835 of file func_strings.c.

{
    char *bufptr = buf, *dataptr = data;
 
    while ((bufptr < buf + buflen - 1) && (*bufptr++ = toupper(*dataptr++)));
 
    return 0;
}

References buf.

string_toupper2()

static int string_toupper2 ( struct ast_channel *  chan, const char *  cmd, char *  data, struct ast_str **  buf, ssize_t  buflen  )

static

Definition at line 1844 of file func_strings.c.

{
    char *bufptr, *dataptr = data;
 
    if (buflen > -1) {
        ast_str_make_space(buf, buflen > 0 ? buflen : strlen(data) + 1);
    }
    bufptr = ast_str_buffer(*buf);
    while ((bufptr < ast_str_buffer(*buf) + ast_str_size(*buf) - 1) && (*bufptr++ = toupper(*dataptr++)));
    ast_str_update(*buf);
 
    return 0;
}

References ast_str_buffer(), ast_str_make_space, ast_str_size(), ast_str_update(), and buf.

strreplace()

static int strreplace ( struct ast_channel *  chan, const char *  cmd, char *  data, struct ast_str **  buf, ssize_t  len  )

static

Definition at line 1049 of file func_strings.c.

{
    char *varsubstr; /* substring for input var */
    char *start; /* Starting pos of substring search. */
    char *end; /* Ending pos of substring search. */
    int find_size; /* length of given find-string */
    unsigned max_matches; /* number of matches we find before terminating search */
    unsigned count; /* loop counter */
    struct ast_str *str = ast_str_thread_get(&result_buf, 16); /* Holds the data obtained from varname */
 
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(varname);
        AST_APP_ARG(find_string);
        AST_APP_ARG(replace_string);
        AST_APP_ARG(max_replacements);
        AST_APP_ARG(other); /* Any remining unused arguments */
    );
 
    /* Guarantee output string is empty to start with. */
    ast_str_reset(*buf);
 
    if (!str) {
        /* We failed to allocate str, forget it.  We failed. */
        return -1;
    }
 
    /* Parse the arguments. */
    AST_STANDARD_APP_ARGS(args, data);
 
    if (args.argc < 2) {
        /* Didn't receive enough arguments to do anything */
        ast_log(LOG_ERROR,
            "Usage: %s(<varname>,<find-string>[,<replace-string>,[<max-replacements>]])\n",
            cmd);
        return -1;
    }
 
    /* No var name specified. Return failure, string is already empty. */
    if (ast_strlen_zero(args.varname)) {
        return -1;
    }
 
    /* Zero length find strings are a no-no. Kill the function if we run into one. */
    if (ast_strlen_zero(args.find_string)) {
        ast_log(LOG_ERROR, "No <find-string> specified\n");
        return -1;
    }
    find_size = strlen(args.find_string);
 
    /* set varsubstr to the matching variable */
    varsubstr = ast_alloca(strlen(args.varname) + 4);
    sprintf(varsubstr, "${%s}", args.varname);
    ast_str_substitute_variables(&str, 0, chan, varsubstr);
 
    /* Determine how many replacements are allowed. */
    if (!args.max_replacements
        || (max_matches = atoi(args.max_replacements)) <= 0) {
        /* Unlimited replacements are allowed. */
        max_matches = -1;
    }
 
    /* Generate the search and replaced string. */
    start = ast_str_buffer(str);
    for (count = 0; count < max_matches; ++count) {
        end = strstr(start, args.find_string);
        if (!end) {
            /* Did not find a matching substring in the remainder. */
            break;
        }
 
        /* Replace the found substring. */
        *end = '\0';
        ast_str_append(buf, len, "%s", start);
        if (args.replace_string) {
            /* Append the replacement string */
            ast_str_append(buf, len, "%s", args.replace_string);
        }
        start = end + find_size;
    }
    ast_str_append(buf, len, "%s", start);
 
    return 0;
}

References args, ast_alloca, AST_APP_ARG, AST_DECLARE_APP_ARGS, ast_log, AST_STANDARD_APP_ARGS, ast_str_append(), ast_str_buffer(), ast_str_reset(), ast_str_substitute_variables(), ast_str_thread_get(), ast_strlen_zero(), buf, end, len(), LOG_ERROR, and str.

unload_module()

static int unload_module ( void  )

static

Definition at line 2409 of file func_strings.c.

{
    int res = 0;
 
    AST_TEST_UNREGISTER(test_FIELDNUM);
    AST_TEST_UNREGISTER(test_REPLACE);
    AST_TEST_UNREGISTER(test_FILTER);
    AST_TEST_UNREGISTER(test_STRREPLACE);
    AST_TEST_UNREGISTER(test_STRBETWEEN);
    AST_TEST_UNREGISTER(test_TRIM);
    res |= ast_custom_function_unregister(&fieldqty_function);
    res |= ast_custom_function_unregister(&fieldnum_function);
    res |= ast_custom_function_unregister(&filter_function);
    res |= ast_custom_function_unregister(&replace_function);
    res |= ast_custom_function_unregister(&strreplace_function);
    res |= ast_custom_function_unregister(&strbetween_function);
    res |= ast_custom_function_unregister(&listfilter_function);
    res |= ast_custom_function_unregister(&regex_function);
    res |= ast_custom_function_unregister(&array_function);
    res |= ast_custom_function_unregister(&quote_function);
    res |= ast_custom_function_unregister(&csv_quote_function);
    res |= ast_custom_function_unregister(&len_function);
    res |= ast_custom_function_unregister(&strftime_function);
    res |= ast_custom_function_unregister(&strptime_function);
    res |= ast_custom_function_unregister(&eval_function);
    res |= ast_custom_function_unregister(&keypadhash_function);
    res |= ast_custom_function_unregister(&hashkeys_function);
    res |= ast_custom_function_unregister(&hash_function);
    res |= ast_unregister_application(app_clearhash);
    res |= ast_custom_function_unregister(&toupper_function);
    res |= ast_custom_function_unregister(&tolower_function);
    res |= ast_custom_function_unregister(&shift_function);
    res |= ast_custom_function_unregister(&pop_function);
    res |= ast_custom_function_unregister(&push_function);
    res |= ast_custom_function_unregister(&unshift_function);
    res |= ast_custom_function_unregister(&passthru_function);
    res |= ast_custom_function_unregister(&trim_function);
    res |= ast_custom_function_unregister(&ltrim_function);
    res |= ast_custom_function_unregister(&rtrim_function);
 
    return res;
}

References app_clearhash, array_function, ast_custom_function_unregister(), AST_TEST_UNREGISTER, ast_unregister_application(), csv_quote_function, eval_function, fieldnum_function, fieldqty_function, filter_function, hash_function, hashkeys_function, keypadhash_function, len_function, listfilter_function, ltrim_function, passthru_function, pop_function, push_function, quote_function, regex_function, replace_function, rtrim_function, shift_function, strbetween_function, strftime_function, strptime_function, strreplace_function, tolower_function, toupper_function, trim_function, and unshift_function.

unshift_push()

static int unshift_push ( struct ast_channel *  chan, const char *  cmd, char *  data, const char *  new_value  )

static

Definition at line 1953 of file func_strings.c.

{
#define beginning   (cmd[0] == 'U') /* UNSHIFT */
    char delimiter[2] = ",", *varsubst;
    size_t unused;
    struct ast_str *buf, *previous_value;
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(var);
        AST_APP_ARG(delimiter);
    );
    const char *stripped_var;
 
    if (!(buf = ast_str_thread_get(&result_buf, 16)) ||
        !(previous_value = ast_str_thread_get(&tmp_buf, 16))) {
        return -1;
    }
 
    AST_STANDARD_APP_ARGS(args, data);
 
    if (ast_strlen_zero(args.var)) {
        ast_log(LOG_WARNING, "%s requires a variable name\n", cmd);
        return -1;
    }
 
    if (args.argc > 1 && !ast_strlen_zero(args.delimiter)) {
        ast_get_encoded_char(args.delimiter, delimiter, &unused);
    }
 
    /* UNSHIFT and PUSH act as ways of setting a variable, so we need to be
     * sure to skip leading underscores if they appear. However, we only want
     * to skip up to two since that is the maximum number that can be used to
     * indicate variable inheritance. Any further underscores are part of the
     * variable name.
     */
    stripped_var = args.var + MIN(strspn(args.var, "_"), 2);
    varsubst = ast_alloca(strlen(stripped_var) + 4);
    sprintf(varsubst, "${%s}", stripped_var);
    ast_str_substitute_variables(&previous_value, 0, chan, varsubst);
 
    if (!ast_str_strlen(previous_value)) {
        ast_str_set(&buf, 0, "%s", new_value);
    } else {
        ast_str_set(&buf, 0, "%s%c%s",
            beginning ? new_value : ast_str_buffer(previous_value),
            delimiter[0],
            beginning ? ast_str_buffer(previous_value) : new_value);
    }
 
    pbx_builtin_setvar_helper(chan, args.var, ast_str_buffer(buf));
 
    return 0;
#undef beginning
}

References args, ast_alloca, AST_APP_ARG, AST_DECLARE_APP_ARGS, ast_get_encoded_char(), ast_log, AST_STANDARD_APP_ARGS, ast_str_buffer(), ast_str_set(), ast_str_strlen(), ast_str_substitute_variables(), ast_str_thread_get(), ast_strlen_zero(), beginning, buf, LOG_WARNING, MIN, pbx_builtin_setvar_helper(), and var.

Variable Documentation

__mod_info

struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "String handling dialplan functions" , .key = ASTERISK_GPL_KEY , .buildopt_sum = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_DEFAULT, .support_level = AST_MODULE_SUPPORT_CORE, }

static

Definition at line 2495 of file func_strings.c.

app_clearhash

char* app_clearhash = "ClearHash"

static

Definition at line 1308 of file func_strings.c.

Referenced by load_module(), and unload_module().

array_function

struct ast_custom_function array_function

static

Initial value:

= {
    .name = "ARRAY",
    .write = array,
}

Definition at line 1590 of file func_strings.c.

                                                   {
    .name = "ARRAY",
    .write = array,
};

Referenced by load_module(), and unload_module().

ast_module_info

const struct ast_module_info* ast_module_info = &__mod_info

static

Definition at line 2495 of file func_strings.c.

csv_quote_function

struct ast_custom_function csv_quote_function

static

Initial value:

= {
    .name = "CSV_QUOTE",
    .read = csv_quote,
}

Definition at line 1664 of file func_strings.c.

                                                       {
    .name = "CSV_QUOTE",
    .read = csv_quote,
};

Referenced by load_module(), and unload_module().

eval_function

struct ast_custom_function eval_function

static

Initial value:

= {
    .name = "EVAL",
    .read = function_eval,
    .read2 = function_eval2,
}

Definition at line 1789 of file func_strings.c.

                                                  {
    .name = "EVAL",
    .read = function_eval,
    .read2 = function_eval2,
};

Referenced by load_module(), and unload_module().

fieldnum_function

struct ast_custom_function fieldnum_function

static

Initial value:

= {
    .name = "FIELDNUM",
    .read = function_fieldnum,
    .read2 = function_fieldnum_str,
}

Definition at line 766 of file func_strings.c.

                                                      {
    .name = "FIELDNUM",
    .read = function_fieldnum,
    .read2 = function_fieldnum_str,
};

Referenced by load_module(), and unload_module().

fieldqty_function

struct ast_custom_function fieldqty_function

static

Initial value:

= {
    .name = "FIELDQTY",
    .read = function_fieldqty,
    .read2 = function_fieldqty_str,
}

Definition at line 687 of file func_strings.c.

                                                      {
    .name = "FIELDQTY",
    .read = function_fieldqty,
    .read2 = function_fieldqty_str,
};

Referenced by load_module(), and unload_module().

filter_function

struct ast_custom_function filter_function

static

Initial value:

= {
    .name = "FILTER",
    .read = filter,
}

Definition at line 975 of file func_strings.c.

                                                    {
    .name = "FILTER",
    .read = filter,
};

Referenced by load_module(), and unload_module().

hash_function

struct ast_custom_function hash_function

static

Initial value:

= {
    .name = "HASH",
    .write = hash_write,
    .read = hash_read,
}

Definition at line 1578 of file func_strings.c.

                                                  {
    .name = "HASH",
    .write = hash_write,
    .read = hash_read,
};

Referenced by load_module(), and unload_module().

hashkeys_function

struct ast_custom_function hashkeys_function

static

Initial value:

= {
    .name = "HASHKEYS",
    .read = hashkeys_read,
    .read2 = hashkeys_read2,
}

Definition at line 1584 of file func_strings.c.

                                                      {
    .name = "HASHKEYS",
    .read = hashkeys_read,
    .read2 = hashkeys_read2,
};

Referenced by load_module(), and unload_module().

keypadhash_function

struct ast_custom_function keypadhash_function

static

Initial value:

= {
    .name = "KEYPADHASH",
    .read = keypadhash,
}

Definition at line 1830 of file func_strings.c.

                                                        {
    .name = "KEYPADHASH",
    .read = keypadhash,
};

Referenced by load_module(), and unload_module().

len_function

struct ast_custom_function len_function

static

Initial value:

= {
    .name = "LEN",
    .read = len,
    .read_max = 12,
}

Definition at line 1681 of file func_strings.c.

                                                 {
    .name = "LEN",
    .read = len,
    .read_max = 12,
};

Referenced by load_module(), and unload_module().

listfilter_function

struct ast_custom_function listfilter_function

static

Initial value:

= {
    .name = "LISTFILTER",
    .read = listfilter_read,
    .read2 = listfilter_read2,
}

Definition at line 893 of file func_strings.c.

                                                        {
    .name = "LISTFILTER",
    .read = listfilter_read,
    .read2 = listfilter_read2,
};

Referenced by load_module(), and unload_module().

ltrim_function

struct ast_custom_function ltrim_function

static

Initial value:

= {
    .name = "LTRIM",
    .read = function_ltrim,
}

Definition at line 1253 of file func_strings.c.

                                                   {
    .name = "LTRIM",
    .read = function_ltrim,
};

Referenced by load_module(), and unload_module().

passthru_function

struct ast_custom_function passthru_function

static

Initial value:

= {
    .name = "PASSTHRU",
    .read2 = passthru,
}

Definition at line 2023 of file func_strings.c.

                                                      {
    .name = "PASSTHRU",
    .read2 = passthru,
};

Referenced by load_module(), and unload_module().

pop_function

struct ast_custom_function pop_function

static

Initial value:

= {
    .name = "POP",
    .read2 = shift_pop,
}

Definition at line 1948 of file func_strings.c.

                                                 {
    .name = "POP",
    .read2 = shift_pop,
};

Referenced by load_module(), and unload_module().

push_function

struct ast_custom_function push_function

static

Initial value:

= {
    .name = "PUSH",
    .write = unshift_push,
}

Definition at line 2007 of file func_strings.c.

                                                  {
    .name = "PUSH",
    .write = unshift_push,
};

Referenced by load_module(), and unload_module().

quote_function

struct ast_custom_function quote_function

static

Initial value:

= {
    .name = "QUOTE",
    .read = quote,
}

Definition at line 1629 of file func_strings.c.

                                                   {
    .name = "QUOTE",
    .read = quote,
};

Referenced by load_module(), and unload_module().

regex_function

struct ast_custom_function regex_function

static

Initial value:

= {
    .name = "REGEX",
    .read = regex,
}

Definition at line 1300 of file func_strings.c.

                                                   {
    .name = "REGEX",
    .read = regex,
};

Referenced by load_module(), and unload_module().

replace_function

struct ast_custom_function replace_function

static

Initial value:

= {
    .name = "REPLACE",
    .read2 = replace,
}

Definition at line 1044 of file func_strings.c.

                                                     {
    .name = "REPLACE",
    .read2 = replace,
};

Referenced by load_module(), and unload_module().

rtrim_function

struct ast_custom_function rtrim_function

static

Initial value:

= {
    .name = "RTRIM",
    .read = function_rtrim,
}

Definition at line 1258 of file func_strings.c.

                                                   {
    .name = "RTRIM",
    .read = function_rtrim,
};

Referenced by load_module(), and unload_module().

shift_function

struct ast_custom_function shift_function

static

Initial value:

= {
    .name = "SHIFT",
    .read2 = shift_pop,
}

Definition at line 1943 of file func_strings.c.

                                                   {
    .name = "SHIFT",
    .read2 = shift_pop,
};

Referenced by load_module(), and unload_module().

strbetween_function

struct ast_custom_function strbetween_function

static

Initial value:

= {
    .name = "STRBETWEEN",
    .read2 = strbetween,
}

Definition at line 1180 of file func_strings.c.

                                                        {
    .name = "STRBETWEEN",
    .read2 = strbetween,
};

Referenced by load_module(), and unload_module().

strftime_function

struct ast_custom_function strftime_function

static

Initial value:

= {
    .name = "STRFTIME",
    .read = acf_strftime,
}

Definition at line 1716 of file func_strings.c.

                                                      {
    .name = "STRFTIME",
    .read = acf_strftime,
};

Referenced by load_module(), and unload_module().

strptime_function

struct ast_custom_function strptime_function

static

Initial value:

= {
    .name = "STRPTIME",
    .read = acf_strptime,
}

Definition at line 1758 of file func_strings.c.

                                                      {
    .name = "STRPTIME",
    .read = acf_strptime,
};

Referenced by load_module(), and unload_module().

strreplace_function

struct ast_custom_function strreplace_function

static

Initial value:

= {
    .name = "STRREPLACE",
    .read2 = strreplace,
}

Definition at line 1133 of file func_strings.c.

                                                        {
    .name = "STRREPLACE",
    .read2 = strreplace,
};

Referenced by load_module(), and unload_module().

tolower_function

struct ast_custom_function tolower_function

static

Initial value:

= {
    .name = "TOLOWER",
    .read = string_tolower,
    .read2 = string_tolower2,
}

Definition at line 1887 of file func_strings.c.

                                                     {
    .name = "TOLOWER",
    .read = string_tolower,
    .read2 = string_tolower2,
};

Referenced by load_module(), and unload_module().

toupper_function

struct ast_custom_function toupper_function

static

Initial value:

= {
    .name = "TOUPPER",
    .read = string_toupper,
    .read2 = string_toupper2,
}

Definition at line 1858 of file func_strings.c.

                                                     {
    .name = "TOUPPER",
    .read = string_toupper,
    .read2 = string_toupper2,
};

Referenced by load_module(), and unload_module().

trim_function

struct ast_custom_function trim_function

static

Initial value:

= {
    .name = "TRIM",
    .read = function_trim,
}

Definition at line 1248 of file func_strings.c.

                                                  {
    .name = "TRIM",
    .read = function_trim,
};

Referenced by load_module(), and unload_module().

unshift_function

struct ast_custom_function unshift_function

static

Initial value:

= {
    .name = "UNSHIFT",
    .write = unshift_push,
}

Definition at line 2012 of file func_strings.c.

                                                     {
    .name = "UNSHIFT",
    .write = unshift_push,
};

Referenced by load_module(), and unload_module().