洛书编程语言C API一览

洛书API的用途

洛书API提供了洛书与C/C++直接的交互接口，是洛书胶水语言性质的重要依托。

API文档的获取

洛书编程语言的官网提供了文档中心，网址如下：

https://losu.tech/wiki/%E4%B8%AD%E7%BA%A7%E6%95%99%E7%A8%8B/%E6%B4%9B%E4%B9%A6API%E8%AF%A6%E8%A7%A3.md

洛书的作者还提供了一个Gitee仓库，可以从那里下载文档。

losu-wiki: 洛书的wiki仓库

准备工作

要使用洛书API，需要包含els.h头文件并且链接到洛书内核。els.h头文件还依赖其他的文件，这些东西可以使用lpt来拉取。

losu -r lpt source losu_core

之后该目录下回出现一个losu_core子目录，在该目录中使用make编译内核。

mingw32-make

本人的编译环境是mignw32，也是洛书在windows的编译环境。开发者可以根据自身情况编译内核。

之后包含头文件和链接内核的过程可以在网上查找资料。

洛书内核和模块本质是C语言动态库（.dll、.lib、.so文件，视平台而定）。只是改了后缀而已。

洛书虚拟机相关API

洛书虚拟机相关API有统一的vm前缀，如

vm_create
vm_close
vm_stip
vm_dostring

相关功能请参阅官方文档，此处直击应用

在C语言程序中运行洛书代码

如果要在C语言程序中运行洛书代码，需要使用vm_create创建一个洛书虚拟机，并且在调用vm_dostring运行字符串。在程序的末尾，需要调用vm_close关闭虚拟机来释放资源。

例程如下

#include <els.h>

const char demo_losu_script[] = 
    "import('stdlib')\n"
    "print('this is a demo to use losu c API.')\n"
    "print('end...')\n"
;

int main()
{
    els_VmObj* vm = vm_create(1024); //参数为栈大小，一般建议为1024

    vm_dostring(vm, demo_losu_script);

    vm_close(vm);

    return 0;
}

本文还在不定时更新中...