@lpc-lang/core 1.1.2-5.1

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

@@ -0,0 +1,212 @@
+// parsing.h
+
+/**
+ * query_verb() - 返回当前正在执行的命令名称
+ *
+ * 给出当前命令的名称，如果不是从命令执行，则返回 0。
+ * 此函数在多个命令（动词）可能导致同一函数执行时非常有用，
+ * 需要确定是哪个动词调用了此函数。
+ *
+ */
+string query_verb( void );
+
+/**
+ * process_value() - 从描述的函数调用中获取一个值
+ *
+ * 获取一个语法模式的替代。模式的形式为：
+ * 
+ * "function[:filename][|arg1|arg2....|argN]"
+ * 
+ * 返回的值可以是任何类型。
+ * 
+ * 注意对象和参数都是用括号标记为可选的，
+ * 并且括号不包含在实际模式中。
+ *
+ */
+mixed process_value( string calldescription );
+
+/**
+ * process_string() - 返回替换了调用描述的字符串
+ *
+ * 通过用在解释模式时返回的内容替换特定的语法模式来处理字符串。
+ * 
+ * 语法模式的形式为：
+ * 
+ * "@@function[:filename][|arg1|arg2....|argN]@@"
+ * 
+ * 这被解释为一次调用：
+ * 
+ * filename->function(arg1, arg2, ....., argN)
+ * 
+ * 注意 process_string 不会递归处理返回的替代值。
+ * 如果一个函数返回另一个语法模式，该描述将不会被替换。
+ * 
+ * 在 'combinestring' 中的所有此类出现都会被处理并替换，
+ * 如果返回值是字符串的话。如果返回值不是字符串，
+ * 则该模式将保持未替换状态。
+ * 
+ * 注意对象和参数都是用括号标记为可选的，
+ * 并且括号不包含在实际模式中。
+ *
+ * 一个字符串：
+ * "你被 @@query_the_name:/obj/monster#123@@ 向东追赶。"
+ * 
+ * 被替换为：
+ * "你被兽人向东追赶。"
+ * 
+ * 假设 monster#123 中的 query_the_name 返回 "兽人"。
+ *
+ */
+string process_string( string combinestring );
+
+/**
+ * parse_sentence() - 解析给定字符串中的命令
+ *
+ * 此 efun 调用驱动程序解析器，并告诉它解析并执行
+ * 给定字符串中的命令。该 efun 可能返回一个整数
+ * 错误代码，或一个字符串错误消息。如果返回字符串消息，
+ * 应该显示给玩家。整数代码为：
+ * 
+ * * 1: 命令处理正常
+ * * 0: 未找到匹配命令，没有处理
+ * * -1: 找到匹配命令但没有匹配任何规则。
+ * * -2: 一条规则有意义，但所有 "can" 或 "direct" 应用都返回 0。
+ *
+ */
+mixed parse_sentence(string, void | int, void | object *, void | mapping);
+
+/**
+ * parse_refresh()
+ *
+ * 解析包缓存有关对象的信息以提高性能。
+ * 这意味着如果任何缓存的信息发生变化，
+ * 你需要告诉 MudOS 清除缓存。这就是此 efun 的作用。
+ * 如果下面的任何应用返回的信息发生变化，
+ * 你需要调用 parse_refresh() 以便解析器知道它已改变。
+ * 例如，如果对象的名称发生变化，或者在施法将其
+ * 从蓝色变为红色时，形容词发生变化 - 之后调用 parse_refresh()。
+ * 此 efun 会清除调用它的对象的缓存。
+ *
+ */
+void parse_refresh();
+
+/**
+ * parse_init()
+ *
+ * efun parse_init() 用于告诉 MudOS 该对象
+ * 可能会被解析包使用或被使用。如果你的对象
+ * 没有调用此方法，则尝试使用其他解析 efuns 将
+ * 产生运行时错误，解析器在搜索匹配项时将忽略该对象。
+ * 建议在标准对象的 create() 中调用 parse_init()。
+ *
+ */
+void parse_init();
+
+/**
+ * parse_command() - 尝试将字符串与给定模式匹配
+ *
+ * parse_command() 是一个改进版的 sscanf(3)，
+ * 以单词为基础操作。它的工作原理类似于 sscanf(3)，
+ * 需要一个模式和一个可变参数集合作为目标。
+ * 仅与 sscanf(3) 一起，是唯一的 efun 使用引用传递
+ * 其他变量而不是数组。也就是说，parse_command() 返回
+ * 值在其参数中。
+ * 
+ * 如果 'command' 被认为与 'pattern' 匹配，
+ * parse_command() 返回 1。
+ * 
+ * 'env' 或 'oblist' 参数可以持有一个对象，
+ * 或对象的列表。如果它持有单个对象，则通过
+ * 添加对象的深度库存自动创建对象的列表，
+ * 即这两者是相同的：
+ * 
+ * parse_command(cmd, environment(), pattern, arg)
+ * 
+ * 和
+ * 
+ * parse_command( cmd, ({ environment() }) +
+ * deep_inventory(environment()), pattern, arg)
+ * 
+ * 'pattern' 是一个单词和格式的列表：
+ * 
+ * 示例字符串 = " 'get' / 'take' %i "
+ * 语法：
+ * 'word'          必需文本
+ * [word]          可选文本
+ * /               选择标记
+ * %o              单个项目，对象
+ * %l              活动对象
+ * %s              任何文本
+ * %w              任何单词
+ * %p              列表中的一个（介词）
+ * %i              任何项目
+ * %d              数字 0- 或 tx(0-99)
+ * 
+ * 'arg' 列表是零个或多个参数。这些是结果变量，
+ * 如同 sscanf。注意每个 %_ 需要一个变量。
+ * 
+ * 不同 %_ 的返回类型：
+ * %o      返回一个对象
+ * %s      返回一个字符串的单词
+ * %w      返回一个字符串的一个单词
+ * %p      可以在输入时持有一个字词的列表数组
+ * 或一个空变量
+ * 返回：
+ * 如果空变量：返回一个字符串
+ * 如果数组：array[0] = 匹配单词
+ * %i      返回一个特殊数组形式：
+ * [0] = (int) +(wanted) -(order) 0(all)
+ * [1..n] (object) 对象指针
+ * %l      返回一个特殊数组形式：
+ * [0] = (int) +(wanted) -(order) 0(all)
+ * [1..n] (object) 对象指针
+ * 这些仅是生物对象。
+ * %d      返回一个数字
+ * 
+ * 唯一使用从对象加载的所有信息的 % 类型是 %i 和 %l。
+ * 这些实际上是相同的，只是 %l 从对象列表中
+ * 过滤出所有非生物对象。
+ * 
+ * %i 和 %l 的返回值也是最复杂的。它们返回一个数组，
+ * 首先是一个数字，然后是所有可能的匹配对象。
+ * 一个典型的字符串被 %i/%l 匹配，看起来像：
+ * '三朵红玫瑰'，'所有可恶的虫子' 或 '第二把蓝剑'，
+ * 数字表明匹配的是哪个数字构造：
+ * 
+ * 如果数字 >0 则匹配的是三、四、五等
+ * 如果数字 <0 则匹配的是第二、二十一等
+ * 如果数字==0 则匹配的是 '所有' 或通用复数形式，
+ * 如 '苹果'。
+ * 
+ * 如果 (parse_command("spray car",environment(this_player()),
+ * " 'spray' / 'paint' [paint] %i ",items))
+ * {
+ * /*
+ * 如果模式匹配成功那么 items 持有的是一个返回数组，
+ * 如上述 'destargs' %i 所描述的那样。
+ * *\/
+ * }
+ *
+ */
+int parse_command( string command, object|object* env,
+                   string pattern, mixed arg... );
+
+/**
+ * parse_add_rule() - 为动词添加解析规则
+ *
+ * 此处 "verb" 是命令词（例如 "look"，"read" 等），
+ * "rule" 是要添加的解析规则。规则由两部分构成 -
+ * 令牌和介词。令牌用于匹配各种对象或字符串，
+ * 而介词是用来指定含义的固定位置词（如 "with" 或 "in"）。
+ * 
+ * MudOS 接受我知道的六个令牌：
+ * 
+ * OBJ - 匹配单个对象
+ * OBS - 匹配一个或多个对象
+ * LIV - 匹配单个生物对象
+ * LVS - 匹配一个或多个生物对象
+ * WRD - 匹配单个单词
+ * STR - 匹配一个或多个单词
+ *
+ */
+void parse_add_rule(string verb, string rule);

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

@@ -0,0 +1,67 @@
+// pcre.h
+
+/**
+ * pcre_version() - 返回使用的已编译PCRE库的版本
+ *
+ * 返回使用的已编译PCRE库的版本
+ *
+ */
+string pcre_version(void);
+
+/**
+ * pcre_replace_callback() - 字符串替换使用回调函数获取替换字符串
+ *
+ * 返回一个字符串，其中所有捕获的组已被函数指针fun或对象ob中的函数fun的返回值替换。（使用匹配字符串和匹配编号调用，编号从0开始）
+ *
+ */
+string pcre_replace_callback(string input, string pattern, string|function, mixed *args...);
+
+/**
+ * pcre_replace()
+ *
+ * 返回一个字符串，其中所有捕获的组已被替换数组的元素替换。子组数量和替换数组的大小必须匹配。
+ *
+ */
+string pcre_replace(string input, string pattern, string *replacments);
+
+/**
+ * pcre_match_all() - 查找所有匹配项
+ *
+ * 类似于php的preg_match_all，这个EFUN返回一个字符串数组的数组，包含所有匹配项和捕获的组。
+ *
+ */
+mixed pcre_match_all(string input, string pattern);
+
+/**
+ * pcre_match() - 正则表达式处理器
+ *
+ * 由于向后兼容的原因与正则表达式efun类似，但利用了PCRE库。
+ *
+ */
+mixed pcre_match(string|string *lines, string pattern, void|int flag);
+
+/**
+ * pcre_extract() - 提取匹配部分
+ *
+ * 返回模式中指定的捕获组的数组。
+ *
+ */
+string *pcre_extract(string input, string pattern);
+
+/**
+ * pcre_cache() - 返回pcre缓存的内容
+ *
+ * 返回pcre缓存的内容（不是很有用）。
+ *
+ */
+mapping pcre_cache(void);
+
+/**
+ * pcre_assoc() - 正则模式子字符串提取器
+ *
+ * 由于向后兼容的原因与reg_assoc efun类似，但利用了PCRE库。
+ *
+ */
+varargs mixed *pcre_assoc(string input, string *patterns, 
+    mixed *token_aray, 
+    mixed default_value);

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

@@ -0,0 +1,230 @@
+// sockets.h
+
+/**
+ * socket_write() - 从套接字发送消息
+ *
+ * socket_write() 在套接字 s 上发送一条消息。如果套接字 s 的类型是
+ * STREAM 或 MUD，则该套接字必须已经连接，且地址未指定。如果套接字
+ * 是 DATAGRAM 类型，则必须指定地址。地址的格式为："127.0.0.1 23"。
+ *
+ */
+int socket_write( int s, mixed message,
+                  void | string address );
+
+/**
+ * socket_status() - 显示每个 LPC 套接字的状态
+ *
+ * socket_status() 返回一个数组，每个套接字对应一个数组。
+ *
+ */
+mixed *socket_status(void | int);
+
+/**
+ * socket_release() - 将套接字的所有权转移给另一个对象
+ *
+ * socket_release() 用于将套接字的所有权（和控制权）转移给另一个
+ * 对象。这在处理连接设置的守护进程对象（如 inetd）中非常有用。
+ * 它会在将一个已连接的套接字转移给另一个对象以便进一步处理时使用。
+ * 
+ * 套接字所有权的转移涉及到当前所有者对象与欲转移的套接字之间的
+ * 握手。当调用 socket_release() 时，握手被引发。socket_release()
+ * 执行适当的安全/完整性检查，然后调用对象 ob 中的 release_callback
+ * 函数。此函数用于通知 ob 套接字所有权正在转移给它。随后，ob 有
+ * 责任在释放回调函数内调用 socket_acquire()。如果调用了 socket_acquire()
+ * ，则握手完成，套接字所有权成功转移至 ob。如果 ob 不接受套接字的
+ * 责任而不调用 socket_acquire()，则所有权不发生变化，当前的套接字
+ * 拥有者必须自行决定如何响应。
+ * 
+ * 如果套接字所有者成功转移，则 socket_release() 返回 EESUCCESS。如果
+ * ob 不接受套接字所有权，则返回 EESOCKNOTRLSD。其他错误可能基于
+ * 安全违规、无效的套接字描述符值等返回。
+ *
+ */
+int socket_release( int socket, object ob,
+                    string release_callback );
+
+/**
+ * socket_listen() - 监听套接字上的连接
+ *
+ * 要接受连接，首先使用 socket_create(3) 创建一个套接字，然后使用
+ * socket_listen(3) 将套接字置于监听模式，并使用 socket_accept(3)
+ * 接受连接。socket_listen() 调用仅适用于 STREAM 或 MUD 类型的
+ * 套接字。
+ * 
+ * 参数 listen_callback 是在监听套接字上请求连接时，驱动程序要调用
+ * 的一个函数的名称。监听回调函数应遵循以下格式：
+ * 
+ * void listen_callback(int fd)
+ * 
+ * 其中 fd 是监听套接字。
+ *
+ */
+int socket_listen( int s, string listen_callback );
+
+/**
+ * socket_error() - 返回套接字错误的文本描述
+ *
+ * socket_error() 返回一个字符串，描述由 error 表示的错误。
+ *
+ */
+string socket_error( int error );
+
+/**
+ * socket_create() - 创建一个 efun 套接字
+ *
+ * socket_create() 创建一个 efun 套接字。mode 决定创建的套接字类型。
+ * 当前支持的套接字模式有：
+ * 
+ * 0  MUD             使用 TCP 协议发送 LPC 数据类型。
+ * 
+ * 1  STREAM          使用 TCP 协议发送原始数据。
+ * 
+ * 2  DATAGRAM        使用 UDP 协议。
+ * 
+ * 3  STREAM_BINARY   使用 TCP 协议交换二进制消息。
+ * 
+ * 4  DATAGRAM_BINARY 使用 UDP 协议交换二进制消息。
+ * 
+ * 参数 read_callback 是在套接字从其对等体获取数据时，驱动程序要调用
+ * 的一个函数的名称。读取回调应遵循以下格式：
+ * 
+ * void read_callback(int fd, mixed message, string addr)
+ * 
+ * 其中 fd 是接收到数据的套接字，message 是接收到的数据，addr 是客户的地址。
+ * 
+ * 在非二进制模式下，message 将使用 UTF8 编码进行清理并作为字符串返回。
+ * 
+ * 在二进制模式下，原始消息将作为缓冲区返回。
+ * 
+ * 参数 close_callback 是在套接字意外关闭时（即不是由于 socket_close(3)
+ * 调用的结果），驱动程序要调用的一个函数的名称。关闭回调应遵循
+ * 以下格式：
+ * 
+ * void close_callback(int fd)
+ * 
+ * 其中 fd 是已关闭的套接字。注意：close_callback 不适用于 DATAGRAM 模式的套接字。
+ *
+ */
+int socket_create( int mode, string read_callback,
+                   void | string close_callback );
+
+/**
+ * socket_connect() - 在套接字上发起连接
+ *
+ * 参数 s 是一个套接字，s 必须是 STREAM 模式或 MUD 模式的套接字。
+ * address 是套接字尝试连接的地址。address 的格式为："127.0.0.1 23"
+ * 
+ * 参数 read_callback 是在套接字从其对等体获取数据时，驱动程序要调用
+ * 的一个函数的名称。读取回调应遵循以下格式：
+ * 
+ * void read_callback(int fd, mixed message)
+ * 
+ * 其中 fd 是接收到数据的套接字，message 是接收到的数据。
+ * 
+ * 参数 write_callback 是在套接字准备好写入时，驱动程序要调用的一个
+ * 函数的名称。写入回调应遵循以下格式：
+ * 
+ * void write_callback(int fd)
+ * 
+ * 其中 fd 是准备好写入的套接字。
+ *
+ */
+int socket_connect( int s, string address,
+                    string read_callback,
+                    string write_callback );
+
+/**
+ * socket_close() - 关闭一个套接字
+ *
+ * socket_close() 关闭套接字 s。这将释放一个套接字 efun 槽以供使用。
+ *
+ */
+int socket_close( int s );
+
+/**
+ * socket_bind() - 将名称绑定到一个套接字
+ *
+ * socket_bind() 将一个名称分配给一个未命名的套接字。当通过 socket_create(3)
+ * 创建一个套接字时，它存在于一个命名空间（地址族）中，但未分配名称。
+ * socket_bind() 请求将端口分配给套接字 s。
+ *
+ */
+int socket_bind( int s, int port );
+
+/**
+ * socket_address() - 返回 efun 套接字的远程地址
+ *
+ * socket_address() 返回 efun 套接字 s 的远程地址。返回的地址格式为：
+ * 
+ * "127.0.0.1 23"。
+ *
+ */
+string socket_address( int s );
+
+/**
+ * socket_acquire() - 假定一个套接字的所有权
+ *
+ * socket_acquire() 是在 socket_release() 开始的握手中调用，以将
+ * 套接字的所有权（和控制权）转移给一个新对象。socket_release() 在
+ * 新拥有者对象内调用释放回调函数，以通知该对象希望将套接字的控制权
+ * 转交给它。新的所有者套接字需要决定是否希望接受该套接字。如果接受，
+ * 则调用 socket_acquire() 完成转移。如果不接受，则回调函数简单返回
+ * 而不完成握手。
+ * 
+ * 在前一种情况下，握手完成，新对象成为套接字所有者。读取、写入和关闭
+ * 回调函数参数指的是新对象内的函数。这些参数是为了让 MudOS 驱动程序
+ * 知道在新对象内调用哪些函数。拒绝获取套接字将导致 socket_release()
+ * 返回 EESOCKNOTRLSD，从而使所有者能够执行适当的清理。
+ * 
+ * socket_acquire() 只能在释放回调函数的上下文中调用，并且只能与指定的
+ * 套接字一起调用。
+ *
+ */
+int socket_acquire( int socket, string read_callback,
+                    string write_callback,
+                    string close_callback );
+
+/**
+ * socket_accept() - 在套接字上接受连接
+ *
+ * 参数 s 是一个通过 socket_create(3) 创建的套接字，已通过
+ * socket_bind(3) 绑定到地址，并在 socket_listen(3) 后开始监听
+ * 连接。socket_accept() 从待处理连接的队列中提取第一个连接，创建
+ * 一个具有与 s 相同属性的新套接字，并为该套接字分配新的文件描述符。
+ * 如果在队列上没有待处理连接，socket_accept() 将返回一个错误，如
+ * 下所述。已接受的套接字用于从这个套接字读取和写入数据；它不用于
+ * 接受更多连接。原始套接字 s 仍然打开以接受进一步连接。
+ * 
+ * 参数 read_callback 是当新套接字（而非接受套接字）接收到数据时，
+ * 驱动程序要调用的一个函数的名称。读取回调应遵循以下格式：
+ * 
+ * void read_callback(int fd)
+ * 
+ * 其中 fd 是准备接受数据的套接字。
+ * 
+ * 参数 write_callback 是当新套接字（而非接受套接字）准备好写入时，
+ * 驱动程序要调用的一个函数的名称。写入回调应遵循以下格式：
+ * 
+ * void write_callback(int fd)
+ * 
+ * 其中 fd 是准备好写入的套接字。
+ * 
+ * 注意：如果新套接字意外关闭，即不是由于 socket_close(3) 调用的结果，
+ * 接受套接字的 close_callback 会被调用。关闭回调应遵循以下格式：
+ * 
+ * void close_callback(int fd)
+ * 
+ * 其中 fd 是已关闭的套接字。
+ *
+ */
+int socket_accept( int s, string read_callback,
+                   string write_callback );
+
+
+/**
+ * 设置套接字的选项。
+ * @param socket 
+ * @param option 
+ * @param host 
+ */
+void socket_set_option(int socket, int option, int|string host);