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

标记函数为已弃用宏:WHISPER_DEPRECATED

  • 对于 GNU 编译器(__GNUC__),使用 __attribute__((deprecated(hint))) 属性将函数标记为已弃用,并附带指定的提示信息。
  • 对于微软 Visual C++ 编译器(_MSC_VER),使用 __declspec(deprecated(hint)) 属性实现相同的目的。
  • 对于其他编译器,函数不会被标记为已弃用。
cpp 复制代码
// 检查是否为 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

cpp 复制代码
// 如果定义了 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)

  1. 作用

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

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

__declspec(dllexport)

  1. 作用

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

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

使用示例

复制代码
WHISPER_API struct whisper_context * whisper_init_from_file(const char * path_model);
相关推荐
Hello_Embed7 小时前
STM32HAL 快速入门(二十):UART 中断改进 —— 环形缓冲区解决数据丢失
笔记·stm32·单片机·学习·嵌入式软件
咸甜适中7 小时前
rust语言 (1.88) 学习笔记:客户端和服务器端同在一个项目中
笔记·学习·rust
Grassto8 小时前
RAG 从入门到放弃?丐版 demo 实战笔记(go+python)
笔记
Magnetic_h8 小时前
【iOS】设计模式复习
笔记·学习·ios·设计模式·objective-c·cocoa
周周记笔记11 小时前
学习笔记:第一个Python程序
笔记·学习
丑小鸭是白天鹅11 小时前
Kotlin协程详细笔记之切线程和挂起函数
开发语言·笔记·kotlin
潘达斯奈基~11 小时前
《大数据之路1》笔记2:数据模型
大数据·笔记
..过云雨12 小时前
05.【Linux系统编程】进程(冯诺依曼体系结构、进程概念、进程状态(注意僵尸和孤儿)、进程优先级、进程切换和调度)
linux·笔记·学习
咸甜适中12 小时前
rust语言 (1.88) egui (0.32.2) 学习笔记(逐行注释)(二十八)使用图片控件显示图片
笔记·学习·rust·egui
一又四分之一.12 小时前
高数基础知识(下)②
笔记