表达式

这个组件实现了对一种简单的表达式进行解析的功能。表达式所支持的仅有：变量、常量和函数。

写法如下：

abc   --这是一个变量
"abc" --这是一个字符串常量
'abc' --这也是字符串常量
1     --整数
1.2   --浮点数
0xa   --十六进制整数
0311  --八进制整数

concat(abc, bcd) --这是一个函数，参数有两个，都是变量
concat(abc, "bcd") --这是一个函数，参数有两个，一个是变量，一个是常量
concat(1, "bcd") --两个参数都是常量
concat("abc", concat(bcd, "efg")) --这个例子展示了函数嵌套调用
concat("abc", concat(bcd, "efg")) aaa concat("bcd", concat(efg, "hij")) --这个例子展示运行多个表达式

-- if else
if a then
  var1
else
  func2()
fi

if a then
  func1()
  if b then
  fi
else
  if c then
  else
  fi
fi

-- loop
loop condition do
  aaa
  func(func2())
  if a then
    bbb
  else
    ccc
  fi
end

头文件

#include "mln_expr.h"

模块名

expr

函数

mln_expr_val_new

mln_expr_val_t *mln_expr_val_new(mln_expr_typ_t type, void *data, mln_expr_udata_free free);

typedef void (*mln_expr_udata_free)(void *);

typedef enum {
    mln_expr_type_null = 0,
    mln_expr_type_bool,
    mln_expr_type_int,
    mln_expr_type_real,
    mln_expr_type_string,
    mln_expr_type_udata,
} mln_expr_typ_t;

typedef struct {
    mln_expr_typ_t       type;
    union {
        mln_u8_t         b;
        mln_s64_t        i;
        double           r;
        mln_string_t    *s;
        void            *u;
    } data;
    mln_expr_udata_free  free;
} mln_expr_val_t;

描述：创建一个表达式值对象。mln_expr_typ_t是表达式的类型，mln_expr_val_t是值对象的结构。函数mln_expr_val_new的第二个参数的类型根据第一个参数不同，会有如下几种：

• mln_u8_t *
• mln_s64_t *
• double *
• mln_string_t * 字符串会在函数内使用函数mln_string_ref引用该字符串。
• void * 用户自定义数据。可以使用第三个参数free来释放这个用户数据。

返回值：

• 成功：mln_expr_val_t指针
• 失败：NULL

mln_expr_val_free

void mln_expr_val_free(mln_expr_val_t *ev);

描述：释放一个表达式值对象。如果值是string类型，同时free回调也被设置，那么将使用free对字符串进行释放，否则使用mln_string_free释放字符串。

返回值：无

mln_expr_val_copy

void mln_expr_val_copy(mln_expr_val_t *dest, mln_expr_val_t *src);

描述：拷贝一个表达式值对象。将src的内容拷贝到dest中。如果是字符串类型，则会使用函数mln_string_ref引用字符串。如果是udata类型，则直接复制数据指针，并将src的free置NULL，保证src释放时，用户自定义数据不会被释放。

返回值：无

mln_expr_val_dup

mln_expr_val_t *mln_expr_val_dup(mln_expr_val_t *val);

描述：拷贝一个表达式值对象。与mln_expr_val_copy相似，但会分配一块全新的内存。

返回值：

• 成功：mln_expr_val_t指针
• 失败：NULL

mln_expr_run

mln_expr_val_t *mln_expr_run(mln_string_t *exp, mln_expr_cb_t cb, void *data);

typedef mln_expr_val_t *(*mln_expr_cb_t)(mln_string_t *name, int is_func, mln_array_t *args, void *data);

描述：运行表达式exp。表达式中的变量以及函数（和函数的参数）还有用户自定义数据data，都会被传递到回调函数cb中进行解析。开发者可以根据需求，定制化这些函数和变量的值。

返回值：

• 成功：mln_expr_val_t指针，存放运行结果。
• 失败：NULL

mln_expr_run

mln_expr_val_t *mln_expr_run(mln_string_t *exp, mln_expr_cb_t cb, void *data);

typedef mln_expr_val_t *(*mln_expr_cb_t)(mln_string_t *name, int is_func, mln_array_t *args, void *data);

描述：运行表达式exp。表达式中的变量以及函数（和函数的参数）还有用户自定义数据data，都会被传递到回调函数cb中进行解析。开发者可以根据需求，定制化这些函数和变量的值。

返回值：

• 成功：mln_expr_val_t指针，存放运行结果。
• 失败：NULL

mln_expr_run_filr

mln_expr_val_t *mln_expr_run_file(mln_string_t *path, mln_expr_cb_t cb, void *data);

typedef mln_expr_val_t *(*mln_expr_cb_t)(mln_string_t *name, int is_func, mln_array_t *args, void *data);

描述：运行由path指定的文件中的表达式。表达式中的变量以及函数（和函数的参数）还有用户自定义数据data，都会被传递到回调函数cb中进行解析。开发者可以根据需求，定制化这些函数和变量的值。

返回值：

• 成功：mln_expr_val_t指针，存放运行结果。
• 失败：NULL

示例

#include "mln_expr.h"
#include "mln_log.h"
#include <stdio.h>

static mln_expr_val_t *var_expr_handler(mln_string_t *name, int is_func, mln_array_t *args, void *data)
{
    mln_string_t *s;
    mln_expr_val_t *ret;

    printf("%p %p %p\n", name, args, data);
    if (is_func)
        mln_log(none, "%S %d %U %X\n", name, is_func, args->nelts, data);
    else
        mln_log(none, "%S %d %X\n", name, is_func, data);
    if ((s = mln_string_dup(name)) == NULL) return NULL;
    ret = mln_expr_val_new(mln_expr_type_string, s, NULL);
    mln_string_free(s);
    return ret;
}

static mln_expr_val_t *func_expr_handler(mln_string_t *name, int is_func, mln_array_t *args, void *data)
{
    mln_expr_val_t *v, *p;
    int i;
    mln_string_t *s1 = NULL, *s2, *s3;

    if (!is_func)
        return mln_expr_val_new(mln_expr_type_string, name, NULL);

    for (i = 0, v = p = mln_array_elts(args); i < mln_array_nelts(args); v = p + (++i)) {
        if (s1 == NULL) {
            s1 = mln_string_ref(v->data.s);
            continue;
        }
        s2 = v->data.s;
        s3 = mln_string_strcat(s1, s2);
        mln_string_free(s1);
        s1 = s3;
    }

    v = mln_expr_val_new(mln_expr_type_string, s1, NULL);
    mln_string_free(s1);

    return v;
}

int main(void)
{
    mln_string_t var_exp = mln_string("aaa bbb");
    mln_string_t func_exp = mln_string("concat('abc', concat(aaa, 'bbb')) ccc concat('eee', concat(bbb, 'fff'))");

    mln_expr_val_t *v;

    v = mln_expr_run(&var_exp, var_expr_handler, NULL);
    if (v == NULL) {
        mln_log(error, "run failed\n");
        return -1;
    }
    mln_log(debug, "%d %S\n", v->type, v->data.s);
    mln_expr_val_free(v);

    v = mln_expr_run(&func_exp, func_expr_handler, NULL);
    if (v == NULL) {
        mln_log(error, "run failed\n");
        return -1;
    }
    mln_log(debug, "%d %S\n", v->type, v->data.s);
    mln_expr_val_free(v);

    return 0;
}

执行结果：

0x4bbb720 (nil) (nil)
aaa 0 0
0x4bbb830 (nil) (nil)
bbb 0 0
03/19/2024 00:17:17 UTC DEBUG: a.c:main:59: PID:2317789 4 bbb
03/19/2024 00:17:17 UTC DEBUG: a.c:main:67: PID:2317789 4 eeebbbfff