webassembly003 whisper.cpp的main项目-4 一些宏定义细节

webassembly003 whisper.cpp的main项目-4 一些宏定义细节

    正在检查是否收录...
一言准备中...

标记函数为已弃用宏:WHISPER_DEPRECATED

对于 GNU 编译器(__GNUC__),使用 __attribute__((deprecated(hint))) 属性将函数标记为已弃用,并附带指定的提示信息。 对于微软 Visual C++ 编译器(_MSC_VER),使用 __declspec(deprecated(hint)) 属性实现相同的目的。 对于其他编译器,函数不会被标记为已弃用。
// 检查是否为 GNU 编译器 #ifdef __GNUC__ // 对于 GNU 编译器,使用 __attribute__((deprecated(hint))) 将函数标记为已弃用 // hint 参数用于提供关于已弃用的提示信息 #define WHISPER_DEPRECATED(func, hint) func __attribute__((deprecated(hint))) // 检查是否为 Microsoft Visual C++ 编译器 #elif defined(_MSC_VER) // 对于 Microsoft Visual C++ 编译器,使用 __declspec(deprecated(hint)) 将函数标记为已弃用 // hint 参数用于提供关于已弃用的提示信息 #define WHISPER_DEPRECATED(func, hint) __declspec(deprecated(hint)) func // 其他编译器 #else // 对于其他编译器,不进行已弃用标记 #define WHISPER_DEPRECATED(func, hint) func #endif 

使用示例

whisper_init_from_file_no_state 函数标记为已弃用,并建议使用 whisper_init_from_file_with_params_no_state 函数代替。
 WHISPER_DEPRECATED( WHISPER_API struct whisper_context * whisper_init_from_file_no_state(const char * path_model), "use whisper_init_from_file_with_params_no_state instead" ); 

WHISPER_API

// 如果定义了 WHISPER_SHARED #ifdef WHISPER_SHARED // 如果目标平台为 Windows(_WIN32) #ifdef _WIN32 // 如果是构建共享库(WHISPER_BUILD 已定义) #ifdef WHISPER_BUILD // 定义 WHISPER_API 为 __declspec(dllexport)(导出符号) #define WHISPER_API __declspec(dllexport) // 如果是使用共享库(WHISPER_BUILD 未定义) #else // 定义 WHISPER_API 为 __declspec(dllimport)(导入符号) #define WHISPER_API __declspec(dllimport) #endif // 如果目标平台不是 Windows #else // 定义 WHISPER_API 为 __attribute__ ((visibility ("default")))(设置可见性为默认) #define WHISPER_API __attribute__ ((visibility ("default"))) #endif // 如果未定义 WHISPER_SHARED #else // 定义 WHISPER_API 为空 #define WHISPER_API #endif 
注:宏定义使用 #define 关键字,定义 WHISPER_API 为空时(#define WHISPER_API),由于编译器在预处理阶段会将这些宏的出现替换为相应的代码或值。定义为空即什么也不做。

__declspec(dllimport) 和 __declspec(dllexport)

__declspec(dllimport)__declspec(dllexport) 是 Microsoft Visual C++ 编译器提供的一对扩展,用于标记动态链接库(DLL)中的函数或变量的导入和导出。这两个修饰符在 Windows 平台上特别常见,用于确保在不同模块(DLL 或可执行文件)之间正确地共享函数和变量。

使用这两个修饰符可以在代码中显式地声明哪些符号是导入的,哪些是导出的,增强了代码的可读性和维护性。

通过使用这些修饰符,编译器能够在函数调用时正确地处理调用约定(如 STDCALL 等),从而避免运行时的问题。- 不使用 __declspec(dllimport) 也能正确编译代码,但使用 __declspec(dllimport) 使编译器可以生成更好的代码。编译器之所以能够生成更好的代码,是因为它可以确定函数是否存在于 DLL 中,这使得编译器可以生成跳过间接寻址级别的代码,而这些代码通常会出现在跨 DLL 边界的函数调用中。但是,必须使用 __declspec(dllimport) 才能导入 DLL 中使用的变量。

__declspec(dllimport)

作用:

用于标记在外部 DLL 中定义的函数或变量,表示这些函数或变量将在运行时从 DLL 中导入到当前模块(通常是可执行文件或其他 DLL)中使用。

示例:

// 在可执行文件或其他 DLL 中使用的声明 __declspec(dllimport) void myFunction(); __declspec(dllimport) int myVariable; 

__declspec(dllexport)

作用:

用于标记在当前模块中定义的函数或变量,表示这些函数或变量将在运行时导出到 DLL 中,以便其他模块可以使用。

示例:

// 在 DLL 中定义的导出函数和变量 __declspec(dllexport) void myFunction() { // 函数体 } __declspec(dllexport) int myVariable = 42; 

使用示例

WHISPER_API struct whisper_context * whisper_init_from_file(const char * path_model); 

codewhisperapidefiwindowsmicrosoft可执行文件share关键字可见性可读性url
  • 本文作者:WAP站长网
  • 本文链接: https://wapzz.net/post-7310.html
  • 版权声明:本博客所有文章除特别声明外,均默认采用 CC BY-NC-SA 4.0 许可协议。
本站部分内容来源于网络转载,仅供学习交流使用。如涉及版权问题,请及时联系我们,我们将第一时间处理。
文章很赞!支持一下吧 还没有人为TA充电
为TA充电
还没有人为TA充电
0
  • 支付宝打赏
    支付宝扫一扫
  • 微信打赏
    微信扫一扫
感谢支持
文章很赞!支持一下吧
关于作者
2.7W+
9
1
2
WAP站长官方

程序员的利器:在VSCode中安装Copilot

上一篇

「爬虫教程」吐血整理,最详细的爬虫入门教程

下一篇
  • 复制图片
按住ctrl可打开默认菜单