@lpc-lang/core 1.1.2-5.1

package/src/efuns/fluffos/zh-cn/db.zh-cn.h

@@ -0,0 +1,113 @@
+// db.h
+
+/**
+ * db_status() - 返回包状态
+ *
+ * 返回描述当前数据库包状态的字符串。
+ *
+ */
+string db_status( void );
+
+/**
+ * db_rollback() - 回滚上一个事务
+ *
+ * 对于事务性数据库，这将回滚最后一组操作。
+ * 
+ * 成功时返回1，否则返回0。
+ *
+ */
+int db_rollback( int );
+
+/**
+ * db_fetch() - 获取结果集
+ *
+ * 获取给定行的最后执行的SQL结果集，使用传递的数据库句柄。
+ * 
+ * 成功时返回命名行的列数组，否则返回错误字符串。
+ *
+ * string *res;
+ * mixed rows;
+ * int dbconn, i;
+ * 
+ * dbconn = db_connect("db.server", "db_mud");
+ * if(dbconn < 1)
+ * return  0;
+ * rows  =  db_exec(dbconn,  "SELECT player_name, exp FROM t_player");
+ * if(!rows)
+ * write("没有返回行。");
+ * else
+ * if(stringp(rows))  /* 错误 *\/
+ * write(rows);
+ * else
+ * for(i = 1; i <= rows; i++)
+ * {
+ * res = db_fetch(dbconn, i);
+ * write(res[0]);
+ * write(res[1]);
+ * }
+ * 
+ * db_close(dbconn);
+ *
+ */
+mixed *db_fetch( int handle, int row );
+
+/**
+ * db_exec() - 执行SQL语句
+ *
+ * 此函数将为给定的数据库句柄执行传递的SQL语句。
+ * 
+ * 成功时返回结果集中行的数量，否则返回错误字符串。
+ *
+ */
+mixed db_exec( int handle, string sql_query );
+
+/**
+ * db_connect() - 关闭数据库连接
+ *
+ * 在给定主机上创建与数据库db的新连接。连接使用给定用户或编译时值作为登录ID。类型可以用于选择数据库服务器的类型。有效值取决于编译时设置，应通过mudlib中的相应头文件提供。
+ * 
+ * 成功时返回新连接的句柄，否则返回0。
+ * 
+ * 驱动程序将调用主对象的valid_database函数以检索此数据库的密码（字符串）或批准（正整数）。
+ * 
+ * FlufFOS支持MYSQL、SQLITE3和PostgreSQL。
+ * 
+ * 编译驱动程序时，需要传递-DPACKAGE_DB=ON和
+ * -DPACKAGE_DB_MYSQL=X或
+ * -DPACKAGE_DB_SQLITE=X或
+ * -DPACKAGE_DB_POSTGRESQL=X
+ * 同时还应传递-DPACKAGE_DB_DEFAULT_DB=X，该值应为上述其中一个。如果某个值为空字符串，则驱动程序对该数据库的支持将被禁用。
+ * 
+ * 这里的X代表表示db_connect()中“类型”参数的整数。
+ * 
+ * 驱动程序为lib提供以下预定义常量以供数据库类型使用。
+ * 
+ * __USE_MYSQL__   是-DPACKAGE_DB_MYSQL=<value>的值，默认值为1
+ * __USE_SQLITE3__ 是-DPACKAGE_DB_SQLITE=<value>的值，默认未定义。
+ * __USE_POSTGRE__ 是-DPACKAGE_DB_POSTGRESQL=<value>的值，默认未定义。
+ * __DEFAULT_DB__  是-DPACKAGE_DB_DEFAULT_DB=<value>的值，默认值为1
+ *
+ */
+int db_connect( string host, string db );
+int db_connect( string host, string db, string user );
+int db_connect( string  host, string db, string user, int type );
+
+/**
+ * db_commit() - 提交上一个事务
+ *
+ * 对于事务性数据库，这将提交最后一组操作。
+ * 
+ * 成功时返回1，否则返回0。
+ *
+ */
+int db_commit(int handle );
+
+/**
+ * db_close() - 关闭数据库连接
+ *
+ * 关闭由给定句柄表示的数据库连接。
+ * 
+ * 成功时返回1，否则返回0。
+ *
+ */
+int db_close( int handle );

package/src/efuns/fluffos/zh-cn/ed.zh-cn.h

@@ -0,0 +1,42 @@
+// ed.h
+
+/**
+ * query_ed_mode() - 查询当前编辑会话的状态
+ *
+ * 找出当前对象的编辑会话状态（如果存在）。返回值为：
+ * 
+ * 0   - 当前对象处于正常的编辑提示（':'）
+ * 
+ * -1  - 当前对象不在编辑状态
+ * 
+ * -2  - 当前对象在帮助中处于中间的更多提示
+ * 
+ * >0  - 当前对象处于处理某一行的提示。数字表示行号。
+ *
+ */
+int query_ed_mode();
+
+/**
+ * ed_start() - 开始一个编辑会话
+ *
+ * 本函数仅在未定义 __OLD_ED__ 时可用。
+ * 
+ * 内部编辑器启动， optionally 加载 'file' 进行编辑。
+ * 返回结果输出。编辑会话保持活跃，可以进一步调用 ed_cmd() 发送命令。
+ * 
+ * 如果 restricted 为1，则将禁用更改正在编辑的文件的命令。
+ * 
+ * 每个对象一次只能有一个编辑会话处于活跃状态。
+ *
+ */
+string ed_start(void|string file, void|int restricted);
+
+/**
+ * ed_cmd() - 向编辑会话发送命令
+ *
+ * 本函数仅在未定义 __OLD_ED__ 时可用。
+ * 
+ * 命令 'cmd' 被发送到活跃的编辑会话，返回相应的输出。
+ *
+ */
+string ed_cmd(string cmd);

package/src/efuns/fluffos/zh-cn/efuns.fluffos.h

@@ -0,0 +1,76 @@
+/** These objects must be here - they are used by the type checker for various non-primitive types */
+object __LS__Array;
+object __LS__Mapping;
+object __LS__Object;
+object __LS__Function;
+object __LS__CallableFunction;
+object __LS__NewableFunction;
+object __LS__Int;
+object __LS__ReadonlyArray;
+object __LS__String;
+object __LS__Closure;
+
+// Driver Provided Defines 
+// These are made available to each sourcefile
+#define MUDOS                   1
+#define FLUFFOS                 1
+#define __GET_CHAR_IS_BUFFERED__ 1
+#define __MAX_READ_FILE_SIZE__  1000000
+#define __PORT__                1
+#define __VERSION__             "1.0"
+#define __ARCH__                "x86_64"
+#define __COMPILER__            "gcc"
+#define __CXXFLAGS__            "linux"
+#define MUD_NAME                "FluffOS"
+
+#define SIZEOFINT               4
+#define MAX_INT                 2147483647  /* the largest integer number */
+#define MIN_INT                 -2147483648 /* the smallest integer number */
+#define MAX_FLOAT               1.0e+20     /* the largest (positive) float number */
+#define MIN_FLOAT               0.00000     /* the smallest (positive) float number */
+#define __LARGEST_PRINTABLE_STRING__ 8192
+#define __CACHE_STATS__         1
+#define __STRING_STATS__        1
+#define __ARRAY_STATS__         1
+#define __CLASS_STATS__         1
+#define __CALLOUT_HANDLES__     1
+#define __ARGUMENTS_IN_TRACEBACK__ 1
+#define __LOCALS_IN_TRACEBACK__ 1
+#define __DEBUG_MACRO__         1
+
+/*
+ * efun 定义
+ * 
+ * FluffOS efun 文件中的文档注释是从 FluffOS 源代码中生成的。
+ * https://github.com/fluffos/fluffos/tree/master/docs
+ * 
+ * 请参阅 https://github.com/fluffos/fluffos/blob/master/Copyright 
+ * 获取许可证/版权信息。
+ */
+
+
+#include "arrays.zh-cn.h"
+#include "async.zh-cn.h"
+#include "buffers.zh-cn.h"
+#include "calls.zh-cn.h"
+#include "contrib.zh-cn.h"
+#include "db.zh-cn.h"
+#include "ed.zh-cn.h" 
+#include "external.zh-cn.h" 
+#include "filesystem.zh-cn.h"
+#include "floats.zh-cn.h"
+#include "functions.zh-cn.h" 
+#include "general.zh-cn.h"
+#include "interactive.zh-cn.h"
+#include "internals.zh-cn.h"
+#include "mappings.zh-cn.h"
+#include "misc.zh-cn.h"
+#include "mudlib.zh-cn.h"
+#include "numbers.zh-cn.h"
+#include "objects.zh-cn.h"
+#include "parsing.zh-cn.h"
+#include "pcre.zh-cn.h"
+#include "sockets.zh-cn.h"
+#include "strings.zh-cn.h"
+#include "system.zh-cn.h"
+

package/src/efuns/fluffos/zh-cn/external.zh-cn.h

@@ -0,0 +1,25 @@
+// external.h
+
+/**
+ * external_start() - 执行一个外部于驱动的shell命令
+ *
+ * 执行一个外部于驱动的shell命令。
+ * 
+ * 您希望执行的命令必须添加到运行时配置中。
+ * 这些枚举的命令可以通过它们的编号作为第一个参数 `external_index` 调用 external_start。
+ * 
+ * 此函数返回您应该记录的套接字号码，以便后续处理外部命令的结果。
+ * 
+ * `args` - 传递给外部命令的参数数组。
+ * `read_call_back` - 当数据可用时，此函数将被调用，参数是包含该数据的字符串。
+ * `write_call_back` - 我不太确定会向外部命令写入什么，但这是一个必需的参数。
+ * `close_call_back` - 当套接字关闭时，将调用此函数。
+ *
+ * 这是一个使用本文件提供的信息的非常基本的示例。
+ *
+ */
+int external_start(int external_index,
+                   string *args,
+                   string|function read_call_back,
+                   string|function write_call_back,
+                   string|function close_call_back);

package/src/efuns/fluffos/zh-cn/filesystem.zh-cn.h

@@ -0,0 +1,140 @@
+// filesystem.h
+
+/**
+ * write_file() - 将字符串写入文件
+ *
+ * 将字符串 'str' 追加到文件 'file' 中。返回 0 或 1 表示失败或成功。
+ * 如果 flag 为 1，write_file 将覆盖而不是追加。
+ *
+ */
+varargs int write_file( string file, string str, int flag );
+
+/**
+ * write_bytes() - 将连续的一系列字节写入文件
+ *
+ * 此函数将 'series' 中的字节写入由 'path' 指定的文件，从字节 # 'start' 开始。
+ * 如果失败则返回零 (0)，否则返回 1。
+ *
+ */
+int write_bytes( string path, int start, string series );
+
+/**
+ * stat() - 返回有关文件或目录的信息
+ *
+ * 如果 str 是常规文件的名称（不是目录），则 stat() 将返回与该文件相关的信息数组。
+ * 数组的格式如下：
+ * 
+ * ({ file_size, last_time_file_touched, time_object_loaded, time_file_created })
+ * 
+ * 如果 stat 被调用的对象是目录（而不是常规文件），或者第二个参数为 -1，则 stat() 的行为与 get_dir(3) 相同。
+ *
+ * @param {string} str - 要获取信息的文件或目录
+ * @param {int} flag 默认值为 0，如果为 0，则返回信息数组；如果为 -1，则返回子数组数组
+ */
+mixed stat( string str, int flag );
+
+/**
+ * rmdir() - 删除一个目录
+ *
+ * 删除目录 'dir'。
+ *
+ */
+int rmdir( string dir );
+
+/**
+ * rm() - 删除一个文件
+ *
+ * 删除文件 'file'。返回 0 表示失败，1 表示成功。
+ *
+ */
+int rm( string file );
+
+/**
+ * rename() - 重命名一个文件
+ *
+ * 将文件 <src> 重命名为 <dst>。
+ *
+ */
+int rename( string src, string dst );
+
+/**
+ * read_file() - 将文件读入字符串
+ *
+ * 从文件中读取一行文本到字符串中。第二个和第三个参数是可选的。
+ * 如果仅指定第一个参数，将返回整个文件（作为字符串）。
+ * 
+ * start_line 是您希望读取的行的行号。此例程将在您尝试超出文件末尾时返回 0，
+ * 或如果您尝试从非正行读取。
+ *
+ */
+varargs string read_file( string file, int start_line, int number_of_lines );
+
+/**
+ * read_bytes()  -  将连续的一系列字节从文件读取到字符串中
+ *
+ * 此函数从名为 'path' 的文件的字节 # 'start' 开始读取 'length' 字节。
+ * 这些字节作为字符串返回。注意 (start + length) 不能超出文件末尾，否则
+ * read_bytes 将失败。如果省略第二个和第三个参数，将返回整个文件。
+ *
+ */
+string read_bytes( string path, int start, int length );
+
+/**
+ * mkdir() - 创建一个目录
+ *
+ * 创建指定的目录。如果成功返回 1，失败返回 0。
+ *
+ */
+int mkdir( string directory );
+
+/**
+ * link() - 将文件链接到另一个文件
+ *
+ * 创建一个链接 <reference> 到文件 <original>。
+ * 此 efun 会在主对象中调用 valid_link(original, reference)。
+ * 如果 valid_link() 返回 0，则 link() 调用失败。
+ * 如果 valid_link() 返回 1，则 link() 成功，前提是如果使用相同的参数调用 rename() 会成功。
+ * 
+ * 注意：此 efun 创建硬链接，而不是符号链接。
+ * https://www.geeksforgeeks.org/difference-between-hard-link-and-soft-link/
+ *
+ */
+void link( string original, string reference );
+
+/**
+ * get_dir() - 返回与文件系统目录相关的信息
+ *
+ * 如果 'dir' 是文件名（支持 '*' 和 '?' 通配符），将返回一个字符串数组，
+ * 包含所有与该规范匹配的文件名。如果 'dir' 是目录名（以斜杠结束--即："/u/"，
+ * "/adm/"，等），将返回该目录中的所有文件名。
+ * 
+ * 如果以第二个参数 -1 调用，get_dir 将返回一个子数组数组，每个子数组的格式为：
+ * 
+ * ({ filename, size_of_file, last_time_file_touched })
+ * 
+ * 其中 filename 是一个字符串，last_time_file_touched 是一个整数，
+ * 表示从 1970 年 1 月 1 日以来的秒数（与 time(3) 格式相同）。
+ * size_of_file 元素是 file_size(3) 返回的相同值；文件的大小（以字节为单位），
+ * 或 -2 如果它是目录。
+ * 
+ * @param {string} dir - 要获取信息的目录
+ * @param {int} flag 默认值为 0，如果为 0，则返回字符串数组；如果为 -1，则返回子数组数组
+ */
+varargs mixed *get_dir(string dir, int flag);
+
+/**
+ * file_size() - 获取文件的大小
+ *
+ * file_size() 返回文件 <file> 的大小（以字节为单位）。大小为 -1 表示 <file> 
+ * 不存在，或您无法读取。大小为 -2 表示 <file> 是一个目录。
+ *
+ */
+int file_size( string file );
+
+/**
+ * cp() - 复制一个文件
+ *
+ * 将文件 <src> 复制到文件 <dst>。
+ *
+ */
+int cp( string src, string dst );

package/src/efuns/fluffos/zh-cn/floats.zh-cn.h

@@ -0,0 +1,129 @@
+// floats.h
+
+/**
+ * to_int - 将浮点数或缓冲区转换为整数
+ *
+ * 如果 'x' 是浮点数，to_int() 调用返回与 'x' 等效的整数类型的数字
+ * （去掉小数部分，并向下取整）。
+ * 
+ * 如果 'x' 是缓冲区，调用返回在缓冲区中嵌入的整数（以网络字节顺序）。
+ * 
+ * 如果 'x' 是字符串，调用将尝试将字符串转换为整数。转换将从第一个字符开始，
+ * 在最后一个非数字的字符串表示数字之前停止并返回。如果转换不成功，
+ * 将返回 UNDEFINED。
+ *
+ */
+int to_int( float | string | buffer x);
+
+/**
+ * tan() - 返回浮点数的正切
+ *
+ * 返回其参数 'f' 的正切值，单位为弧度。
+ *
+ */
+float tan( float f );
+
+/**
+ * sqrt() - 返回浮点数的平方根
+ *
+ * sqrt() 返回其参数 'f' 的非负平方根。'f' 的值不能为负数。
+ *
+ */
+float sqrt( float f );
+
+/**
+ * sin() - 返回浮点数的正弦
+ *
+ * 返回其参数 'f' 的正弦值，单位为弧度。
+ *
+ */
+float sin( float f );
+
+/**
+ * round() - 四舍五入浮点数
+ *
+ * 返回 'f' 的四舍五入值，类型为浮点数。
+ *
+ */
+float round( float f );
+
+/**
+ * pow() - 计算浮点数的指数
+ *
+ * pow() 返回 x 的 y 次方。如果 x 为 0.0，则 y 必须为正数。如果 x 为负数，
+ * 则 y 必须为整数。
+ *
+ */
+float pow( float x, float y );
+
+/**
+ * log() - 返回浮点数的自然对数
+ *
+ * 返回其参数 'f' 的自然对数。'f' 必须是正数。
+ *
+ */
+float log( float f );
+
+/**
+ * floor() - 将浮点数向下舍入到最接近的整数
+ *
+ * 返回（作为浮点数）小于或等于 f 的最接近的整数。
+ *
+ */
+float floor( float f );
+
+/**
+ * floatp() - 确定给定变量是否为浮点数
+ *
+ * 如果 'arg' 是浮点数，则返回 1，否则返回 0。
+ *
+ */
+int floatp( mixed arg );
+
+/**
+ * exp() - 计算 e 的浮点数次方
+ *
+ * exp() 返回 e^f。
+ *
+ */
+float exp( float f );
+
+/**
+ * cos() - 返回浮点数的余弦
+ *
+ * 返回其参数 'f' 的余弦值，单位为弧度。
+ *
+ */
+float cos( float f );
+
+/**
+ * ceil() - 将浮点数向上舍入到最接近的整数
+ *
+ * 返回（作为浮点数）大于或等于 f 的最接近的整数。
+ *
+ */
+float ceil( float f );
+
+/**
+ * atan() - 返回浮点数的反正切
+ *
+ * 返回其参数 'f' 的反正切值，单位为弧度。
+ *
+ */
+float atan( float f );
+
+/**
+ * asin() - 返回浮点数的反正弦
+ *
+ * 返回其参数 'f' 的反正弦值，单位为弧度。
+ *
+ */
+float asin( float f );
+
+/**
+ * acos() - 返回浮点数的反余弦
+ *
+ * 返回其参数 'f' 的反余弦值，单位为弧度。
+ *
+ */
+float acos( float f );

package/src/efuns/fluffos/zh-cn/functions.zh-cn.h

@@ -0,0 +1,87 @@
+// functions.h
+
+/**
+ * functionp()  -  确定给定变量是否是函数指针，如果是，则返回其类型
+ * @param arg - 要检查的变量
+ * @returns {arg is function} 如果 arg 是函数指针，则返回 1，否则返回 0
+ * 
+ * 如果 'arg' 是一个函数指针，则返回非零值，否则返回零 (0)。
+ * 函数指针是类型为 'function' 的变量，如文档中所述，例如：
+ * ```c
+ * f = (: obj, func :);
+ * ```
+ * 返回值使用在驱动程序包含文件 "include/function.h" 中给出的值来指示函数指针的类型。
+ * 
+ * 函数指针类型       值
+ * ---------------------       -----
+ * call_other                  FP_CALL_OTHER
+ * lfun                        FP_LOCAL
+ * efun                        FP_EFUN
+ * simul_efun                  FP_SIMUL
+ * functional                  FP_FUNCTIONAL
+ * 
+ * 此外，在某些情况下，将添加以下值：
+ * FP_HAS_ARGUMENTS            提供了参数
+ * FP_OWNER_DESTED             创建者已被销毁
+ * FP_NOT_BINDABLE             不可重新绑定
+ * 
+ * 最后一组值是位值，可以使用位运算进行测试。 值 FP_MASK 用于忽略位值并测试函数指针的基本类型。
+ * 
+ * 示例：
+ * 
+ * 检查一个函数变量是否是 efun 指针：
+ * ```c
+ * if ((functionp(f) & FP_MASK) == FP_EFUN) ...
+ * ```
+ * 检查它是否有参数：
+ * ```c
+ * if (functionp(f) & FP_HAS_ARGUMENTS) ...
+ * ```
+ */
+int functionp( mixed arg );
+
+/**
+ * evaluate() - 评估一个函数指针
+ *
+ * 如果 f 是一个函数，则使用其余参数调用 f。否则，返回 f。 evaluate(f, ...) 等同于 (*f)(...)。
+ *
+ */
+mixed evaluate(mixed f... );
+
+/**
+ * defer() - 在当前函数结束后执行函数
+ *
+ * 在当前函数结束时调用函数指针 *f（即使是由于运行时错误导致的）。
+ * 
+ * 例如：
+ * 
+ * void create()
+ * {
+ * ::create();
+ * 
+ * defer( (: enable_commands :) );
+ * }
+ * 
+ * defer() 函数的效果是它会导致 enable_commands() efun 在 create() 函数执行结束后被调用。传递给 defer() 的参数可以是任何函数类型。
+ *
+ */
+void defer(function f);
+
+/**
+ * bind() - 更改函数指针的所有者
+ *
+ * 返回一个与 f 完全相同的函数指针，但属于对象 'ob'，而不是创建 f 的对象。 如果 'f' 的创建者已经被销毁，或者 f 是一个 efun 指针指向一个对 'this_object' 做某事的 efun，则很有用。
+ * 
+ * 例如：
+ * 
+ * void make_living(object ob) {
+ * function f;
+ * 
+ * f = bind( (: enable_commands :), ob );
+ * 
+ * evaluate(f); }
+ * 
+ * 上述效果与 'ob' 自身评估 enable_commands() efun 的效果相同。 请注意，这涉及到安全风险，因为 bind() 允许您强制另一个对象运行一段代码。 为了防止这种情况，必须有一个有效的 valid_bind() 主应用程序返回 1，否则调用 bind() 将失败。
+ *
+ */
+function bind(function f, object ob);