/*
* Asterisk -- An open source telephony toolkit.
*
* Copyright (C) 1999 - 2006, Digium, Inc.
* Portions Copyright (C) 2005, Anthony Minessale II
*
* See http://www.asterisk.org for more information about
* the Asterisk project. Please do not directly contact
* any of the maintainers of this project for assistance;
* the project provides a web site, mailing lists and IRC
* channels for your use.
*
* This program is free software, distributed under the terms of
* the GNU General Public License Version 2. See the LICENSE file
* at the top of the source tree.
*/
/*! \file
*
* \brief Conditional logic dialplan functions
*
* \author Anthony Minessale II
*
* \ingroup functions
*/
/*** MODULEINFO
core
***/
#include "asterisk.h"
#include "asterisk/module.h"
#include "asterisk/channel.h"
#include "asterisk/pbx.h"
#include "asterisk/utils.h"
#include "asterisk/app.h"
/*** DOCUMENTATION
Check if a value is NULL.
Returns 1 if NULL or 0 otherwise.
SET assigns a value to a channel variable.
Test the existence of a value.
Returns 1 if exists, 0 otherwise.
Check for an expression.
Returns the data following ? if true, else the data following :
Temporal Conditional.
Returns the data following ? if true, else the data following :
Retrieve the value of a variable from another channel.
***/
static int isnull(struct ast_channel *chan, const char *cmd, char *data,
char *buf, size_t len)
{
strcpy(buf, data && *data ? "0" : "1");
return 0;
}
static int exists(struct ast_channel *chan, const char *cmd, char *data, char *buf,
size_t len)
{
strcpy(buf, data && *data ? "1" : "0");
return 0;
}
static int iftime(struct ast_channel *chan, const char *cmd, char *data, char *buf,
size_t len)
{
struct ast_timing timing;
char *expr;
char *iftrue;
char *iffalse;
data = ast_strip_quoted(data, "\"", "\"");
expr = strsep(&data, "?");
iftrue = strsep(&data, ":");
iffalse = data;
if (ast_strlen_zero(expr) || !(iftrue || iffalse)) {
ast_log(LOG_WARNING,
"Syntax IFTIME(?[][:])\n");
return -1;
}
if (!ast_build_timing(&timing, expr)) {
ast_log(LOG_WARNING, "Invalid Time Spec.\n");
ast_destroy_timing(&timing);
return -1;
}
if (iftrue)
iftrue = ast_strip_quoted(iftrue, "\"", "\"");
if (iffalse)
iffalse = ast_strip_quoted(iffalse, "\"", "\"");
ast_copy_string(buf, ast_check_timing(&timing) ? S_OR(iftrue, "") : S_OR(iffalse, ""), len);
ast_destroy_timing(&timing);
return 0;
}
static int acf_if(struct ast_channel *chan, const char *cmd, char *data, char *buf,
size_t len)
{
AST_DECLARE_APP_ARGS(args1,
AST_APP_ARG(expr);
AST_APP_ARG(remainder);
);
AST_DECLARE_APP_ARGS(args2,
AST_APP_ARG(iftrue);
AST_APP_ARG(iffalse);
);
args2.iftrue = args2.iffalse = NULL; /* you have to set these, because if there is nothing after the '?',
then args1.remainder will be NULL, not a pointer to a null string, and
then any garbage in args2.iffalse will not be cleared, and you'll crash.
-- and if you mod the ast_app_separate_args func instead, you'll really
mess things up badly, because the rest of everything depends on null args
for non-specified stuff. */
AST_NONSTANDARD_APP_ARGS(args1, data, '?');
AST_NONSTANDARD_APP_ARGS(args2, args1.remainder, ':');
if (ast_strlen_zero(args1.expr) || !(args2.iftrue || args2.iffalse)) {
ast_log(LOG_WARNING, "Syntax IF(?[][:]) (expr must be non-null, and either or must be non-null)\n");
ast_log(LOG_WARNING, " In this case, ='%s', ='%s', and ='%s'\n", args1.expr, args2.iftrue, args2.iffalse);
return -1;
}
args1.expr = ast_strip(args1.expr);
if (args2.iftrue)
args2.iftrue = ast_strip(args2.iftrue);
if (args2.iffalse)
args2.iffalse = ast_strip(args2.iffalse);
ast_copy_string(buf, pbx_checkcondition(args1.expr) ? (S_OR(args2.iftrue, "")) : (S_OR(args2.iffalse, "")), len);
return 0;
}
static int set(struct ast_channel *chan, const char *cmd, char *data, char *buf,
size_t len)
{
char *varname;
char *val;
varname = strsep(&data, "=");
val = data;
if (ast_strlen_zero(varname) || !val) {
ast_log(LOG_WARNING, "Syntax SET(=[])\n");
return -1;
}
varname = ast_strip(varname);
val = ast_strip(val);
pbx_builtin_setvar_helper(chan, varname, val);
ast_copy_string(buf, val, len);
return 0;
}
static int set2(struct ast_channel *chan, const char *cmd, char *data, struct ast_str **str, ssize_t len)
{
if (len > -1) {
ast_str_make_space(str, len == 0 ? strlen(data) : len);
}
return set(chan, cmd, data, ast_str_buffer(*str), ast_str_size(*str));
}
static int import_helper(struct ast_channel *chan, const char *cmd, char *data, char *buf, struct ast_str **str, ssize_t len)
{
AST_DECLARE_APP_ARGS(args,
AST_APP_ARG(channel);
AST_APP_ARG(varname);
);
AST_STANDARD_APP_ARGS(args, data);
if (buf) {
*buf = '\0';
}
if (!ast_strlen_zero(args.varname)) {
struct ast_channel *chan2;
if ((chan2 = ast_channel_get_by_name(args.channel))) {
char *s = ast_alloca(strlen(args.varname) + 4);
sprintf(s, "${%s}", args.varname);
ast_channel_lock(chan2);
if (buf) {
pbx_substitute_variables_helper(chan2, s, buf, len);
} else {
ast_str_substitute_variables(str, len, chan2, s);
}
ast_channel_unlock(chan2);
chan2 = ast_channel_unref(chan2);
}
}
return 0;
}
static int import_read(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
{
return import_helper(chan, cmd, data, buf, NULL, len);
}
static int import_read2(struct ast_channel *chan, const char *cmd, char *data, struct ast_str **str, ssize_t len)
{
return import_helper(chan, cmd, data, NULL, str, len);
}
static struct ast_custom_function isnull_function = {
.name = "ISNULL",
.read = isnull,
.read_max = 2,
};
static struct ast_custom_function set_function = {
.name = "SET",
.read = set,
.read2 = set2,
};
static struct ast_custom_function exists_function = {
.name = "EXISTS",
.read = exists,
.read_max = 2,
};
static struct ast_custom_function if_function = {
.name = "IF",
.read = acf_if,
};
static struct ast_custom_function if_time_function = {
.name = "IFTIME",
.read = iftime,
};
static struct ast_custom_function import_function = {
.name = "IMPORT",
.read = import_read,
.read2 = import_read2,
};
static int unload_module(void)
{
int res = 0;
res |= ast_custom_function_unregister(&isnull_function);
res |= ast_custom_function_unregister(&set_function);
res |= ast_custom_function_unregister(&exists_function);
res |= ast_custom_function_unregister(&if_function);
res |= ast_custom_function_unregister(&if_time_function);
res |= ast_custom_function_unregister(&import_function);
return res;
}
static int load_module(void)
{
int res = 0;
res |= ast_custom_function_register(&isnull_function);
res |= ast_custom_function_register(&set_function);
res |= ast_custom_function_register(&exists_function);
res |= ast_custom_function_register(&if_function);
res |= ast_custom_function_register(&if_time_function);
res |= ast_custom_function_register(&import_function);
return res;
}
AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Logical dialplan functions");