_plugin_registerformatfunction

此函数用于注册由插件定义的格式化函数,以便用户可以在 字符串格式化 中使用它。

bool _plugin_registerformatfunction(
    int pluginHandle,                  //插件句柄
    const char* type,                  //格式化函数的名称
    CBPLUGINFORMATFUNCTION cbFunction, //回调函数
    void* userdata                     //用户数据
);

参数

pluginHandle:

调用插件的句柄。

type:

格式化函数的名称。这是字符串格式化函数中 ; 前面的部分。有效的名称必须以 _ 或字母开头,后面跟着 _.、字母或数字。

cbFunction:

具有以下类型的回调函数:

typedef FORMATRESULT(*CBPLUGINFORMATFUNCTION)(char* dest, size_t destCount, int argc, char* argv[], duint value, void* userdata);
userdata:

传递给回调函数的指针值,插件可使用此参数传递附加信息。

返回值

注册成功时返回 true,否则返回 false