编程语言语言运行时编译器【免费下载链接】wrenThe Wren Programming Language. Wren is a small, fast, class-based concurrent scripting language.项目地址https://gitcode.com/gh_mirrors/wr/wren点击查看免费下载Wren 是一门轻量级、基于类并发的脚本语言它的功能被组织为模块其中核心模块core module直接内置于虚拟机VM随每个脚本隐式可用而meta元编程与random随机数则属于可选模块由宿主应用通过编译期开关决定是否编入。本文以 doc/site/modules/index.markdown 为主线结合 wren_common.h、wren_vm.c 等源码讲清三类模块的边界、编译开关的配置方式并完整演示Meta类四个静态方法及Random类全部构造器与方法的用法。模块体系概览核心模块与可选模块的分界Wren 官方文档将模块明确划分为两类见 模块索引文档核心模块core module直接编译进 VM被每个模块隐式导入。任何 Wren 脚本无需import即可使用其中的对象与类型例如 数字Num、字符串String以及Bool、List、Map、Fiber、Fn、Class、Range、Sequence、System等全部内建类型完整列表见 核心模块文档。可选模块optional modules同样随 Wren 项目发布但是否被编译进宿主应用由宿主决定。它们全部用 Wren C 编写、无外部依赖纳入应用“简单到只需一个编译开关”。VM 本身运转并不依赖它们因此宿主可以只启用其中一部分、甚至全部禁用。这种核心极小化 可选模块化的设计源于 Wren 的定位——它是为嵌入应用而生的脚本语言核心模块聚焦于 Wren 对象自身的操作文件 I/O、图形等能力一律交给宿主应用提供接口而不是塞进语言核心。可选模块的编译开关WREN_OPT_META 与 WREN_OPT_RANDOM截至当前仓库Wren 共提供两个可选模块模块名导入语句内容禁用开关metaimport meta for Meta元编程模块变量枚举、运行时编译WREN_OPT_META 0randomimport random for RandomWELL512a 伪随机数生成器WREN_OPT_RANDOM 0开关的默认值与语义定义在 src/vm/wren_common.h// The VM includes a number of optional modules. You can choose to include // these or not. By default, they are all available. To disable one, set the // corresponding WREN_OPT_name define to 0. #ifndef WREN_OPT_META #define WREN_OPT_META 1 #endif #ifndef WREN_OPT_RANDOM #define WREN_OPT_RANDOM 1 #endif从源码结构看只要在编译 Wren 时把对应宏定义为0模块即可整体剔除wren_opt_meta.c 与 wren_opt_random.c 的整个实现体都包裹在#if WREN_OPT_META/#if WREN_OPT_RANDOM之内wren_vm.c 中的findForeignMethod也通过这两个宏决定是否注册对应的 C 绑定函数构建层面projects/make/wren.make 默认把wren_opt_meta.o与wren_opt_random.o一并编入目标。因此若宿主应用希望进一步瘦身或消除随机数等能力只需在编译时定义WREN_OPT_META0/WREN_OPT_RANDOM0反过来如果你使用的宿主没有开启这些模块脚本中import meta或import random会以“无法加载模块”报错使用前应先确认宿主是否提供。可选模块的底层加载与绑定机制可选模块之所以能“仅靠一个开关”挂进 VM靠的是 VM 的两条内置兜底路径源码加载wren_vm.c 的模块加载逻辑先询问宿主的loadModuleFn宿主未提供时再检查模块名是否为meta/random若是则直接使用预编译进二进制的 Wren 源码字符串wrenMetaSource()/wrenRandomSource()其内容来自 wren_opt_meta.wren.inc 与 wren_opt_random.wren.inc由构建脚本从同名.wren文件转换而来方法绑定findForeignMethodwren_vm.c在宿主bindForeignMethodFn未命中时按模块名回退到wrenMetaBindForeignMethod/wrenRandomBindForeignMethod把模块内部声明的foreign方法接到 C 实现上。换句话说这两个模块是Wren 源码 C foreign 函数的混合体类结构与纯逻辑如Random.sample的抽样算法写在.wren文件里性能关键路径如 WELL512a 状态推进写在.c文件里。meta 模块运行时元编程meta模块通过单个类 Meta 提供四类元编程能力枚举模块级变量、运行时编译并执行源码、运行时编译表达式与编译整段源码。使用前必须先导入import meta for MetaMeta.getModuleVariables(module)枚举模块级变量返回module中定义或可见的全部模块级变量包括显式从其他模块导入的变量以及隐式来自内建模块的变量。以文档中的示例为准模块module.wren定义var M 1再运行/* get_mod_vars.wren */ import meta for Meta import ./module for M var v 42 var f Fn.new { var g 2 } class C {} System.print(Meta.getModuleVariables(./get_mod_vars)) var w 43 // still returned even though defined later输出为[Object, Class, Object metaclass, Bool, Fiber, Fn, Null, Num, Sequence, MapSequence, SkipSequence, TakeSequence, WhereSequence, List, String, StringByteSequence, StringCodePointSequence, Map, MapKeySequence, MapValueSequence, MapEntry, Range, System, Meta, M, v, f, C, w]注意两点g是函数内的局部变量不会出现在列表中w虽然定义在调用之后但因为是模块级变量依然被返回。若module不是字符串或找不到对应模块会抛出运行时错误。实现上wren_opt_meta.wren 先做类型检查再由 C 侧 metaGetModuleVariables 从 VM 的模块表vm-modules取出ObjModule把variableNames逐个复制进新创建的 List 返回。对应测试见 test/meta/get_module_variables.wren其中验证了“包含隐式导入的核心类型”“包含后声明的模块级变量”“排除未知变量”等行为。Meta.eval(source)编译并立即执行把一段 Wren 源码编译成闭包并自动执行返回值即闭包调用结果未显式return时返回nullimport meta for Meta var a 2 var b 3 var source var c a * b System.print(c) Meta.eval(source) // 6注意eval编译出的源码在调用处所在模块的上下文中求值因此能访问a、b这些外层模块变量。若source不是字符串或编译失败均会报运行时错误编译错误本身不打印wren_opt_meta.wren 中compile_返回null时直接Fiber.abort。Meta.compileExpression(expression)编译表达式为闭包把单个 Wren表达式编译成闭包并返回不执行调用闭包得到表达式值import meta for Meta var d 4 var e 5 var expression d * e var closure Meta.compileExpression(expression) System.print(closure.call()) // 20与eval不同编译错误会被打印出来此时返回null但不会抛出异常。Meta.compile(source)编译源码为闭包把整段 Wren源码编译成闭包并返回不执行语义与compileExpression相同但接受完整语句序列且闭包末尾可通过return返回任意值。文档用它实现了一个可复用的枚举工厂import meta for Meta /* Enum creates an enum with any number of read-only static members. Members are assigned in order an initial integer value (often 0), incremented by 1 each time. The enum has: 1. static property getters for each member, 2. a static startsFrom property, and 3. a static members property which returns a list of its members as strings. */ class Enum { // Creates a class for the Enum (with an underscore after the name to avoid duplicate definition) // and returns a reference to it. static create(name, members, startsFrom) { if (name.type ! String || name ) Fiber.abort(Name must be a non-empty string.) if (members.isEmpty) Fiber.abort(An enum must have at least one member.) if (startsFrom.type ! Num || !startsFrom.isInteger) { Fiber.abort(Must start from an integer.) } name name _ var s class %(name) {\n for (i in 0...members.count) { var m members[i] s s static %(m) { %(i startsFrom) }\n } var mems members.map { |m| \%(m)\ }.join(, ) s s static startsFrom { %(startsFrom) }\n s s static members { [%(mems)] }\n}\n s s return %(name) return Meta.compile(s).call() } } var Fruits Enum.create(Fruits, [orange, apple, banana, lemon], 0) System.print(Fruits.banana) // 2 System.print(Fruits.startsFrom) // 0 System.print(Fruits.members) // [orange, apple, banana, lemon]这里Meta.compile(s).call()的返回值是动态生成的Fruits_类引用之后即可像普通类一样访问其静态成员。C 侧 metaCompile 通过wrenCompileSource完成编译其中对调用点所在模块的定位依赖对调用栈的假设代码注释明确标注这是脆弱的-2偏移任何对 meta 模块的改动都可能需要同步调整。random 模块WELL512a 伪随机数生成器random模块提供简单、快速的伪随机数生成器核心算法是WELL512awell equidistributed long-period linear PRNG状态为 16 个 32 位整数周期极长。使用前需导入import random for Random每个Random实例基于内部状态生成随机数序列状态由种子初始化两个种子相同的实例会生成完全相同的序列——这是可复现随机性的关键。对应测试见 test/random/new_sequence.wren两个以[1, 2, 3]为种子的实例连续 100 次float()结果完全一致。构造器Random.new()Random.new()以当前时间为种子C 侧 randomSeed0 内部用time(NULL)配合srand/rand填满 16 个状态字适合一般场景var random Random.new()Random.new(seed)以显式种子初始化。种子可以是一个数字也可以是非空数字序列序列超过 16 个元素时只用前 16 个不足 16 个时循环复用补齐 16 个种子值Random.new(12345) Random.new(appleseed.codePoints)补齐逻辑在 wren_opt_random.wren数字种子走 C 侧randomSeed1序列种子先收集前 16 个数空序列或含非数字元素会Fiber.abort不足部分用seeds[i]循环填充最后一次性传给 16 参数版本randomSeed16wren_opt_random.c 直接逐槽写入state[0..15]。浮点随机数float()float()返回[0.0, 1.0)区间含 0.0、不含 1.0的浮点数var random Random.new(12345) System.print(random.float()) // 0.53178795980617 System.print(random.float()) // 0.20180515043262 System.print(random.float()) // 0.43371948658705float(end)返回[0.0, end)区间浮点数var random Random.new(12345) System.print(random.float(0)) // 0 System.print(random.float(100)) // 20.180515043262 System.print(random.float(-100)) // -43.371948658705float(start, end)返回[start, end)区间浮点数var random Random.new(12345) System.print(random.float(3, 4)) // 3.5317879598062 System.print(random.float(-10, 10)) // -5.9638969913476 System.print(random.float(-4, 2)) // -1.3976830804777后两个重载并非 C 实现而是在 wren_opt_random.wren 中基于float()派生的纯 Wren 逻辑float(end) float() * endfloat(start, end) float() * (end - start) start。C 侧 randomFloat 的精度处理值得一提先取 32 位随机位左移 21 位再补 21 位凑足 double 尾数的 53 位精度最后除以2^53归一化到[0, 1)。整数随机数int()int(end)返回[0, end)区间整数var random Random.new(12345) System.print(random.int(1)) // 0 System.print(random.int(10)) // 2 System.print(random.int(-50)) // -22int(start, end)返回[start, end)区间整数var random Random.new(12345) System.print(random.int(3, 4)) // 3 System.print(random.int(-10, 10)) // -6 System.print(random.int(-4, 2)) // -2Wren 侧实现wren_opt_random.wren为(float() * end).floor与(float() * (end - start)).floor start无参版本int()则直接返回一个 32 位无符号状态字C 侧randomInt0。抽样与洗牌sample() 与 shuffle()sample(list)从列表中随机选 1 个元素空列表会Fiber.abort。sample(list, count)不重复抽样random without replacement返回由count个互不相同的元素组成的新列表count大于列表长度时报错。算法在 wren_opt_random.wren注释援引 Programming pearls: a sample of brilliance当抽样数小于群体 1/4 时用哈希表记录已选索引否则用布尔数组以平衡大样本下的时间与内存。shuffle(list)就地随机重排列表采用Fisher-Yates 算法保证每种排列等概率出现var random Random.new(12345) var list (1..5).toList random.shuffle(list) System.print(list) // [3, 2, 4, 1, 5]需要注意一个实用边界文档明确提醒即便中等大小的列表其排列总数也远超生成器内部状态容量。例如 56 张牌的洗牌方式约有10^74种而 WELL512a 内部状态远小于此因此存在生成器永远无法产出的排列。这是所有有界状态 PRNG 的固有特性不应对shuffle的等概率做绝对化理解。结语如何选用与验证一句话总结核心模块是你永远拿得到的语言基石meta与random则是按需编入的可选能力。在嵌入场景中先确认宿主编译时是否保留了WREN_OPT_META/WREN_OPT_RANDOM编写依赖可复现随机序列的测试时务必显式传入种子而非依赖Random.new()的时间种子做元编程时Meta.compile/compileExpression返回闭包、eval直接执行、getModuleVariables只统计模块级变量——这些差异决定了 API 的正确打开方式。仓库中 test/meta 与 test/random 目录下的大量.wren测试如get_module_variables.wren、new_sequence.wren、float.wren、int.wren等覆盖了正常路径与各种错误路径是理解与验证这两个模块行为的直接素材。赞分享编程语言语言运行时编译器【免费下载链接】wrenThe Wren Programming Language. Wren is a small, fast, class-based concurrent scripting language.项目地址https://gitcode.com/gh_mirrors/wr/wren点击查看免费下载相关推荐Candle让CNC机床控制变得直观简单的GRBL控制器Candle让CNC机床控制变得直观简单的GRBL控制器 Candle是一款基于Qt框架开发的GRBL控制器应用专为CNC机床用户设计。它将复杂的G代码控制物联网桌面应用Flowsurface终极指南5分钟掌握开源加密货币图表分析利器Flowsurface终极指南5分钟掌握开源加密货币图表分析利器 你是否曾经在加密货币交易中感到眼花缭乱面对多个交易所、各种图表工具想要一个统一的、专业的金融科技数据可视化桌面应用掌握MEAN.JS模块化开发5个核心模块实战指南与最佳实践掌握MEAN.JS模块化开发5个核心模块实战指南与最佳实践 MEAN.JS作为基于MongoDB、Express、AngularJS和Node.js的全栈Ja后端前端上一篇抖音内容批量下载神器douyin-downloader 完全指南下一篇抖音批量下载工具终极指南5分钟学会无水印保存与智能管理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考