阿里云-云小站(无限量代金券发放中)
【腾讯云】云服务器、云数据库、COS、CDN、短信等热卖云产品特惠抢购

跨平台代码三种组织方式详解

288次阅读
没有评论

共计 2539 个字符,预计需要花费 7 分钟才能阅读完成。

导读 我们在源代码中也会遇到一些跨平台的问题。不同的功能,在不同的平台下,实现方式是不一样的,如何对这些平台相关的代码进行组织呢? 这篇文章就来聊聊这个问题。

跨平台代码三种组织方式详解

一、缘起

在上一篇文章中,分享了一个跨平台的头文件是长成什么样子的,这个头文件对于 windows 平台下更有意义一些,因为要处理库函数的导入和导出声明 (dllexport、dllimport)。

其实,可以在这个头文件的基础上继续扩充,以达到更细粒度的控制。例如:对编译器的判断、对编译器版本的判断等等。

同样的,我们在源代码中也会遇到一些跨平台的问题。不同的功能,在不同的平台下,实现方式是不一样的,如何对这些平台相关的代码进行组织呢? 这篇文章就来聊聊这个问题。

PS: 文末提供了一个简单的、跨平台构建代码示例。

二、问题引入

假设我们写一个库,需要实现一个函数:获取系统时间戳。作为实现库的作者,你决定提供下面的 API 函数:

t_time.h: 声明接口函数(t_get_timestamp);t_time.c:实现接口函数;

下面的任务就是在函数实现中,通过不同下的 C 库或系统调用,来计算系统当前的时间戳。

在 Linux 平台下,可以通过下面这段代码实现:

struct timeval tv; 
gettimeofday(&tv, null); 
return tv.tv_sec * 1000 + tv.tv_usec / 1000;

在 Windows 平台下,可以通过下面这段代码实现:

struct timeb tp; 
ftime(&tp); 
return tp.time *1000 + tp.millitm;

那么问题来了:怎么把这两段平台相关的代码组织在一起? 下面就介绍 3 种不同的组织方式,没有优劣之分,每个人都有不同的习惯,选择适合自己和团队的方式就行。

此外,这个示例中只有 1 个函数,而且比较短小。如果这种跨平台的函数很多、而且都很长,也许你的选择又不一样了。

三、三个解决方案
方案 1

直接在接口函数中,通过平台宏定义来区分不同平台。

平台宏定义 (T_LINUX, T_WINDOWS),是在上一篇文章中介绍的,通过操作系统、编译器来判断当前的平台是什么,然后定义出统一的平台宏定义为我们自己所用:

代码组织方式如下:

int64 t_get_timestamp() 
{ 
    int64 ts = -1; 
     
#if defined(T_LINUX) 
    struct timeval tv; 
    gettimeofday(&tv, null); 
    ts = tv.tv_sec * 1000 + tv.tv_usec / 1000; 
#elif defined(T_WINDOWS) 
    struct timeb tp; 
    ftime(&tp); 
    ts = tp.time; 
    ts = ts *1000 + tp.millitm; 
#endif 
 
    return ts; 
}

这样的方式,把所有平台代码全部放在 API 函数中了,通过平台宏定义进行条件编译,因为代码比较短小,看起来还不错。

方案 2

把不同平台的实现代码放在独立的文件中,然后通过 #include 预处理符号,在 API 函数中,把平台相关的代码引入进来。

也就是再增加 2 个文件:

t_time_linux.c:存放 Linux 平台下的代码实现;t_time_windows.c:存放 Windows 平台下的代码实现;(1) t_time_linux.c

#include "t_time.h" 
#include  
 
int64 t_get_timestamp() 
{ 
    int64 ts = -1; 
     
    struct timeval tv; 
    gettimeofday(&tv, null); 
    ts = tv.tv_sec * 1000 + tv.tv_usec / 1000; 
     
    return ts; 
} 

(2) t_time_windows.c

#include "t_time.h" 
#include  
#include  
 
int64 t_get_timestamp() 
{ 
    int64 ts = -1; 
     
    struct timeb tp; 
    ftime(&tp); 
    ts = tp.time; 
    ts = ts *1000 + tp.millitm; 
 
    return ts; 
} 

(3) t_time.c

这个文件不做任何事情,仅仅是 include 其他的代码。

#include "t_time.h" 
 
#if defined(T_LINUX) 
#include  
#elif defined(T_WINDOWS) 
#include  
#else 
int64 t_get_timestamp() 
{return -1;} 
#endif 

有些人比较反感这样的组织方式,一般都是 include 一个 .h 头文件,而这里通过平台宏定义,include 不同的 .c 源文件,感觉怪怪的?!

其实,也有一些开源库是这么干的,比如下面:
跨平台代码三种组织方式详解

方案 3

在上面方案 2 中,是在源代码中填入不同平台的实现代码。

其实可以换一种思路,既然已经根据平台的不同、放在不同的文件中了,那么可以让不同的源文件加入到编译过程中就可以了。

测试代码是使用 cmake 工具来构建的,因此可以编辑 CMakelists.txt 文件,来控制参与编译的源文件。

CMakelists.txt 文件部分内容

# 设置平台变量 
if (CMAKE_SYSTEM_NAME MATCHES "Linux") 
set(PLATFORM linux) 
elseif (CMAKE_SYSTEM_NAME MATCHES "Windows") 
set(PLATFORM windows) 
endif()

# 根据平台变量,来编译不同的源文件

set(LIBSRC  t_time_${PLATFORM}.c)

这样的组织方式,感觉代码更“干净”一些。同样的,我们也可以看到一些开源库也是这么做的:
跨平台代码三种组织方式详解
跨平台代码三种组织方式详解

四、One More Thing

为了文章的篇幅,以上只是贴了代码的片段。

我写了一个最简单的 demo,使用 cmake 来构建跨平台的动态库、静态库、可执行程序。写这个 demo 的目的,主要是作为一个外壳,来测试一些写文章时的代码。

在 Linux 平台下,通过 cmake 指令手动编译; 在 Windows 平台下,可以通过 CLion 集成开发环境直接编译、执行,也可以通过 cmake 工具直接生成 VS2017/2019 解决方案。

已经把这个 demo 放在 gitee 仓库中了

阿里云 2 核 2G 服务器 3M 带宽 61 元 1 年,有高配

腾讯云新客低至 82 元 / 年,老客户 99 元 / 年

代金券:在阿里云专用满减优惠券

正文完
星哥玩云-微信公众号
post-qrcode
 0
星锅
版权声明:本站原创文章,由 星锅 于2024-07-25发表,共计2539字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
【腾讯云】推广者专属福利,新客户无门槛领取总价值高达2860元代金券,每种代金券限量500张,先到先得。
阿里云-最新活动爆款每日限量供应
评论(没有评论)
验证码
【腾讯云】云服务器、云数据库、COS、CDN、短信等云产品特惠热卖中

星哥玩云

星哥玩云
星哥玩云
分享互联网知识
用户数
4
文章数
19350
评论数
4
阅读量
7963612
文章搜索
热门文章
星哥带你玩飞牛NAS-6:抖音视频同步工具,视频下载自动下载保存

星哥带你玩飞牛NAS-6:抖音视频同步工具,视频下载自动下载保存

星哥带你玩飞牛 NAS-6:抖音视频同步工具,视频下载自动下载保存 前言 各位玩 NAS 的朋友好,我是星哥!...
星哥带你玩飞牛NAS-3:安装飞牛NAS后的很有必要的操作

星哥带你玩飞牛NAS-3:安装飞牛NAS后的很有必要的操作

星哥带你玩飞牛 NAS-3:安装飞牛 NAS 后的很有必要的操作 前言 如果你已经有了飞牛 NAS 系统,之前...
我把用了20年的360安全卫士卸载了

我把用了20年的360安全卫士卸载了

我把用了 20 年的 360 安全卫士卸载了 是的,正如标题你看到的。 原因 偷摸安装自家的软件 莫名其妙安装...
再见zabbix!轻量级自建服务器监控神器在Linux 的完整部署指南

再见zabbix!轻量级自建服务器监控神器在Linux 的完整部署指南

再见 zabbix!轻量级自建服务器监控神器在 Linux 的完整部署指南 在日常运维中,服务器监控是绕不开的...
飞牛NAS中安装Navidrome音乐文件中文标签乱码问题解决、安装FntermX终端

飞牛NAS中安装Navidrome音乐文件中文标签乱码问题解决、安装FntermX终端

飞牛 NAS 中安装 Navidrome 音乐文件中文标签乱码问题解决、安装 FntermX 终端 问题背景 ...
阿里云CDN
阿里云CDN-提高用户访问的响应速度和成功率
随机文章
国产开源公众号AI知识库 Agent:突破未认证号限制,一键搞定自动回复,重构运营效率

国产开源公众号AI知识库 Agent:突破未认证号限制,一键搞定自动回复,重构运营效率

国产开源公众号 AI 知识库 Agent:突破未认证号限制,一键搞定自动回复,重构运营效率 大家好,我是星哥,...
【1024程序员】我劝你赶紧去免费领一个AWS、华为云等的主机

【1024程序员】我劝你赶紧去免费领一个AWS、华为云等的主机

【1024 程序员】我劝你赶紧去免费领一个 AWS、华为云等的主机 每年 10 月 24 日,程序员们都会迎来...
如何免费使用强大的Nano Banana Pro?附赠邪修的用法

如何免费使用强大的Nano Banana Pro?附赠邪修的用法

如何免费使用强大的 Nano Banana Pro?附赠邪修的用法 前言 大家好,我是星哥,今天来介绍谷歌的 ...
三大开源投屏神器横评:QtScrcpy、scrcpy、escrcpy 谁才是跨平台控制 Android 的最优解?

三大开源投屏神器横评:QtScrcpy、scrcpy、escrcpy 谁才是跨平台控制 Android 的最优解?

  三大开源投屏神器横评:QtScrcpy、scrcpy、escrcpy 谁才是跨平台控制 Andr...
开发者福利:免费 .frii.site 子域名,一分钟申请即用

开发者福利:免费 .frii.site 子域名,一分钟申请即用

  开发者福利:免费 .frii.site 子域名,一分钟申请即用 前言 在学习 Web 开发、部署...

免费图片视频管理工具让灵感库告别混乱

一言一句话
-「
手气不错
星哥带你玩飞牛NAS-11:咪咕视频订阅部署全攻略

星哥带你玩飞牛NAS-11:咪咕视频订阅部署全攻略

星哥带你玩飞牛 NAS-11:咪咕视频订阅部署全攻略 前言 在家庭影音系统里,NAS 不仅是存储中心,更是内容...
安装并使用谷歌AI编程工具Antigravity(亲测有效)

安装并使用谷歌AI编程工具Antigravity(亲测有效)

  安装并使用谷歌 AI 编程工具 Antigravity(亲测有效) 引言 Antigravity...
自己手撸一个AI智能体—跟创业大佬对话

自己手撸一个AI智能体—跟创业大佬对话

自己手撸一个 AI 智能体 — 跟创业大佬对话 前言 智能体(Agent)已经成为创业者和技术人绕...
240 元左右!五盘位 NAS主机,7 代U硬解4K稳如狗,拓展性碾压同价位

240 元左右!五盘位 NAS主机,7 代U硬解4K稳如狗,拓展性碾压同价位

  240 元左右!五盘位 NAS 主机,7 代 U 硬解 4K 稳如狗,拓展性碾压同价位 在 NA...
开源MoneyPrinterTurbo 利用AI大模型,一键生成高清短视频!

开源MoneyPrinterTurbo 利用AI大模型,一键生成高清短视频!

  开源 MoneyPrinterTurbo 利用 AI 大模型,一键生成高清短视频! 在短视频内容...