quickjs module介绍
作者:互联网
原文见https://www.cnblogs.com/gaobw/p/11693876.html
其实子啊github.com/quickjs-zh/QuickJS
代码里有个例子bjson.c, test_bjson.js其实跟这个一样
1.5. std 模块
std模块为quickjs-libc提供包装器stdlib.h和stdio.h和其他一些实用程序。
std代码示例:
创建文件std_m.js
import * as std from 'std';
var file = std.open('std_open_file.js','w');
file.puts('var file = std.open(\"std_open_file.txt\",\"w\");\n');
file.puts('file.puts(\'std_open_file line1\\n\');\n');
file.puts('file.puts(\'std_open_file line2\\n\');\n');
file.puts('file.close();\n');
file.close();
std.loadScript('std_open_file.js');
var rdfile = std.open("std_open_file.txt","r");
do{
console.log(rdfile.getline());
}while(!rdfile.eof());
rdfile.close();
执行qjs std_m.js ,目录下会生成2个新文件std_open_file.js std_open_file.txt。
控制台输出:
std_open_file line1
std_open_file line2
null
1.6. os 模块
os 模块提供操作系统特定功能:底层文件访问、信号、计时器、异步 I/O。
代码示例:
import * as os from 'os';
os.remove('hello');
os.remove('std_open_file.js');
os.remove('std_open_file.txt');
删除生成的测试文件
1.7. 自定义C模块
ES6模块完全支持。默认名称解析规则如下:
模块名称带有前导.或..是相对于当前模块的路径
模块名称没有前导.或..是系统模块,例如std或os
模块名称以.so结尾,是使用QuickJS C API的原生模块
使用js文件模块和系统模块,参照引用原生js模块和上面的例子即可,这里就不多赘述。
这里着重讲解如何编写自己的原生C模块,并且以导入so文件的方式在js代码中使用。
1.7.1. js数据类型在C中的定义
typedef union JSValueUnion {
int32_t int32; //整数值
double float64; //double值
void *ptr; //QuickJS引用类型的指针
} JSValueUnion; //存放于同一地址,且互斥
typedef struct JSValue {
JSValueUnion u; //存放真实数值或着其指针
int64_t tag; //JSValue类型的标示符(如 undefined 其 tag == JS_TAG_UNDEFINED)
} JSValue;
此结构定义在 quickjs.h 中。
1.7.2. c模块编写
流程如下:
自定义原生C函数
定义 QuickJS C 函数
定义API的函数入口名称及列表
定义初始化回调方法,将函数入口列表在模块中暴露
定义初始化模块方法,由系统自动调用,且函数名称不可更改
创建编写c_test_m.c文件:
#include "quickjs.h"
#include "stdio.h"
#include "stdlib.h"
#include "string.h"
#define JS_INIT_MODULE js_init_module
#define countof(x) (sizeof(x) / sizeof((x)[0]))
/* 自定义原生C函数 */
static double test_add(int a, double b)
{
return a + b;
}
static char *test_add_str(const char *a, double b)
{
/* 要有足够的空间来容纳要拼接的字符串,否则可能会造成缓冲溢出的错误情况 */
char instr[64];
sprintf(instr, "%.2f", b);
char *dest = malloc(128);
memset(dest, 0, 128);
strcpy(dest, a);
char *retdest = strcat(dest, instr);
return dest;
}
/*
定义 QuickJS C 函数
*ctx : 运行时上下文
this_val : this对象
argc : 入参个数
*argv : 入参列表
*/
static JSValue js_test_add(JSContext *ctx, JSValueConst this_val,
int argc, JSValueConst *argv)
{
int a;
double b;
if (JS_ToInt32(ctx, &a, argv[0]))
return JS_EXCEPTION;
if (JS_ToFloat64(ctx, &b, argv[1]))
return JS_EXCEPTION;
printf("argc = %d \n", argc);
printf("a = %d \n", a);
printf("b = %lf \n", b);
printf("argv[1].u.float64 = %lf \n", argv[1].u.float64);
return JS_NewFloat64(ctx, test_add(a, b));
}
static JSValue js_test_add_str(JSContext *ctx, JSValueConst this_val,
int argc, JSValueConst *argv)
{
if (!JS_IsString(argv[0]))
{
return JS_EXCEPTION;
}
double d;
if (JS_ToFloat64(ctx, &d, argv[1]))
return JS_EXCEPTION;
const char *jscstr = JS_ToCString(ctx, argv[0]);
printf("JS_ToCString(ctx, argv[0]) = %s \n", jscstr);
printf("argv[1].u.float64 = %lf \n", argv[1].u.float64);
char *jsret = test_add_str(jscstr, d);
return JS_NewString(ctx, jsret);
}
/* 定义API的函数入口名称及列表 */
static const JSCFunctionListEntry js_test_funcs[] = {
/* JS_CFUNC_DEF(函数入口名称,入参个数,QuickJS C 函数) */
JS_CFUNC_DEF("testAdd", 2, js_test_add),
JS_CFUNC_DEF("testAddStr", 2, js_test_add_str),
};
/* 定义初始化回调方法(由系统调用,入参格式固定),将函数入口列表 在模块中暴露 */
static int js_test_init(JSContext *ctx, JSModuleDef *m)
{
return JS_SetModuleExportList(ctx, m, js_test_funcs,
countof(js_test_funcs));
}
/* 定义初始化模块方法,由系统自动调用,且函数名称不可更改 */
JSModuleDef *JS_INIT_MODULE(JSContext *ctx, const char *module_name)
{
JSModuleDef *m;
m = JS_NewCModule(ctx, module_name, js_test_init);
if (!m)
return NULL;
JS_AddModuleExportList(ctx, m, js_test_funcs, countof(js_test_funcs));
return m;
}
将 quickjs.h、quickjs-libc.h、libquickjs.a 拷贝到当前工程目录下。
执行命令
gcc c_test_m.c libquickjs.a -fPIC -shared -o libtest.so
生成libtest.so文件。
1.7.3. 使用.so模块
创建js文件 c_test_m.js
import { testAdd , testAddStr} from 'libtest.so'
console.log('\n')
console.log(`testAdd: ${testAdd(1, 0.5)}`)
console.log('\n')
console.log(`testAddStr: ${testAddStr('Pi equal to about ', 3.14159)}`)
console.log('\n')
qjs c_test_m.js
输出:
argc = 2
a = 1
b = 0.500000
argv[1].u.float64 = 0.500000
testAdd: 1.5
JS_ToCString(ctx, argv[0]) = Pi equal to about
argv[1].u.float64 = 3.141590
testAddStr: Pi equal to about 3.14
标签:std,quickjs,模块,介绍,JS,module,file,test,js 来源: https://blog.csdn.net/kv110/article/details/121346095