【我的C/C++语言学习进阶之旅】使用stb_image库时候报错 multiple definition of ‘stbi_xxxxx‘ 和 previous definition here

2024-02-14 17:50
文章标签 语言 c++ 进阶 学习 使用 报错 image multiple definition 之旅 stb xxxxx previous stbi

本文主要是介绍【我的C/C++语言学习进阶之旅】使用stb_image库时候报错 multiple definition of ‘stbi_xxxxx‘ 和 previous definition here，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

  • 一、问题描述
    • 1.1 `error: undefined reference to 'stbi_load'` 和 `error: undefined reference to 'stbi_image_free'`之类的错误
    • 1.2 报错：multiple definition of 'stbi_xxxxx'
  • 二、分析错误
    • 2.1 为啥会重复写呢？
    • 2.2 解决问题
      • 2.2.1 了解一下`STB_IMAGE_IMPLEMENTATION`这个宏定义的作用
      • 2.2.2 解决方法1 只在一个源文件（.c、.cpp文件）中定义`STB_IMAGE_IMPLEMENTATION`
      • 2.2.3 解决方法2 添加另外一个宏定义
        • 2.2.3.1 分析源码
        • 2.2.3.2 解决问题
  • 三、总结

一、问题描述

1.1 error: undefined reference to 'stbi_load' 和 error: undefined reference to 'stbi_image_free'之类的错误

在我的博客【我的C/C++语言学习进阶之旅】介绍一下NDK开发之C的简单易用图像库stb 中有介绍，要使用 stb_image，您应该有将 stb_image.h 文件添加到工程中，然后在C++文件添加下面的代码

#define STB_IMAGE_IMPLEMENTATION
#include "stb_image.h"

但是如果你只添加了.h头文件，而不添加宏定义的话，则会编译失败

#include "stb_image.h"

则会报错 error: undefined reference to 'stbi_load' 和 error: undefined reference to 'stbi_image_free'之类的错误，如下所示：
在这里插入图片描述
上面的错误是我第一次添加stb_image.h库的时候犯的错误。直到我认真读完stb的README文件才解决这个问题。

在这里插入图片描述

通过定义STB_IMAGE_IMPLEMENTATION，预处理器会修改头文件，让其只包含相关的函数定义源码，等于是将这个stb_image.h头文件变为一个.cpp文件了。现在只需要在你的程序中包含stb_image.h并编译就可以了。（工程中不要放stb_image.c文件，否则会报其他错误）

1.2 报错：multiple definition of ‘stbi_xxxxx’

但是，如果将下面这段代码，分别添加到两个cpp文件中，

#define STB_IMAGE_IMPLEMENTATION
#include "stb_image.h"

就会报另外一个错：multiple definition of 'stbi_xxxxx'

例如：我在一个叫做FaceStickerLoader.cpp文件中和一个叫做ImageUtils.cpp中分别引入了下面这段代码。

#define STB_IMAGE_IMPLEMENTATION
#include "stb_image.h"

首先，在FaceStickerLoader.cpp文件中，引入stb_image.h，并定义宏定义 STB_IMAGE_IMPLEMENTATION，如下所示：
在这里插入图片描述

然后，我在ImageUtils.cpp中想把相关的图片加载代码抽取出来，然后又引入stb_image.h，并定义宏定义 STB_IMAGE_IMPLEMENTATION，如下所示：
在这里插入图片描述
所以就引入了两个宏定义 STB_IMAGE_IMPLEMENTATION
在这里插入图片描述

那么编译的时候，就好编译失败，报如下错误：

在这里插入图片描述

二、分析错误

2.1 为啥会重复写呢？

因为1.1小结的结论，必须在.c或.cpp文件中添加下面的代码

#define STB_IMAGE_IMPLEMENTATION
#include "stb_image.h"

否则会报错 error: undefined reference to 'stbi_load' 和 error: undefined reference to 'stbi_image_free'之类的错误。

导致我以为需要在每一个引入头文件stb_image.h的cpp代码中都需要添加下面这个宏定义

#define STB_IMAGE_IMPLEMENTATION

真的是一朝被蛇咬十年怕井绳！！！

2.2 解决问题

2.2.1 了解一下STB_IMAGE_IMPLEMENTATION这个宏定义的作用

我们首先了解一下STB_IMAGE_IMPLEMENTATION这个宏定义的作用。

通过定义STB_IMAGE_IMPLEMENTATION，预处理器会修改头文件，让其只包含相关的函数定义源码，等于是将这个stb_image.h头文件变为一个.cpp文件了。现在只需要在你的程序中包含stb_image.h并编译就可以了。（工程中不要放stb_image.c文件，否则会报其他错误）

我们打开stb_image.h头文件代码也可以看到上面作用。

  1. 如果定义了 宏定义STB_IMAGE_IMPLEMENTATION，才会执行下面所有的代码

在这里插入图片描述
2. 直到7671行代码才结束这个 宏定义STB_IMAGE_IMPLEMENTATION的范围在这里插入图片描述
3. 因此，我们可以看出来，通过定义STB_IMAGE_IMPLEMENTATION，预处理器会修改头文件，让其只包含相关的函数定义源码，等于是将这个stb_image.h头文件变为一个.cpp文件了。现在只需要在你的程序中包含stb_image.h并编译就可以了。

2.2.2 解决方法1 只在一个源文件（.c、.cpp文件）中定义STB_IMAGE_IMPLEMENTATION

被当做头文件包含到别的文件中，则其不应该在不同的 .c、.cpp文件中被展开（注意：源文件的头文件会在预处理阶段将其头文件展开，也有可能会变成这种情况），否则相当于在不同的源文件中定义同名的C函数，再编译生成 .o文件时肯定会报重定义的错误。

因此，我们的解决方法就是只在一个源文件（.c、.cpp文件）中声明宏定义STB_IMAGE_IMPLEMENTATION。
如下所示：

在这里插入图片描述
这样我们就可以正常编译项目。

但是这样的解决方法不好，就是如果后续有人copy代码，copy了比如ImageUtils.cpp这个文件到其他的工程去，只包含了stb_image.h头文件单没有声明宏定义STB_IMAGE_IMPLEMENTATION，

#include "../include/stb/stb_image.h"

那么就会出现1.1小结出现的问题：报错 error: undefined reference to 'stbi_load' 和 error: undefined reference to 'stbi_image_free'之类的错误，如下所示：
在这里插入图片描述
那么有没有其他方式呢？答案是有的！我们接着看。

2.2.3 解决方法2 添加另外一个宏定义

2.2.3.1 分析源码

C语言中为解决多个源文件包含相同的函数提供了更好的办法，相信你已经猜到了------static关键字，其修饰的函数和全局变量只在本文件中可见，这样就不会和其他文件冲突了。

我们来看下错误，我们先看第一次报错的两行提示，如下所示

在这里插入图片描述

  C:/Android/SDK/ndk/21.4.7075529/toolchains/llvm/prebuilt/windows-x86_64/lib/gcc/arm-linux-androideabi/4.9.x/../../../../arm-linux-androideabi/bin\ld: error: XXXRender.a(ImageUtils.cpp.o): multiple definition of 'stbi__unpremultiply_on_load_thread(int)'C:/Android/SDK/ndk/21.4.7075529/toolchains/llvm/prebuilt/windows-x86_64/lib/gcc/arm-linux-androideabi/4.9.x/../../../../arm-linux-androideabi/bin\ld: XXXRender.a(FaceStickerLoader.cpp.o): previous definition here

然后我们查看这个stbi__unpremultiply_on_load_thread(int)方法的实现，如下所示：
在这里插入图片描述

STBIDEF void stbi__unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply)
{stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply;stbi__unpremultiply_on_load_set = 1;
}

在函数前面有一个STBIDEF宏定义来修饰函数。我们来查看下这个STBIDEF宏定义是什么情况？

在这里插入图片描述

#ifndef STBIDEF
#ifdef STB_IMAGE_STATIC
#define STBIDEF static
#else
#define STBIDEF extern
#endif
#endif

好家伙，如果定义了宏定义STB_IMAGE_STATIC
那么宏定义 STBIDEF就是 static
否则宏定义 STBIDEF就是extern

可以参考这篇博客：static和extern对函数的作用 了解static和extern两个关键字。

好了，问题迎刃而解！

我们只要定义了宏定义STB_IMAGE_STATIC，那么那么宏定义 STBIDEF就是 static，那么下面的代码就是：
在这里插入图片描述
即：

STBIDEF void stbi__unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply)
{stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply;stbi__unpremultiply_on_load_set = 1;
}

编译之后就是

static void stbi__unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply)
{stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply;stbi__unpremultiply_on_load_set = 1;
}

那么就不会编译出错了！！！

2.2.3.2 解决问题

两个cpp文件都添加

#define STB_IMAGE_STATIC
#define STB_IMAGE_IMPLEMENTATION
#include "../include/stb/stb_image.h"

使用前预先定义 STB_IMAGE_STATIC ，添加该宏定义以后，函数会被static 修饰（否则为extern修饰），完美的解决了重定义的问题。推荐大家使用！

如下所示：
在这里插入图片描述
添加好之后，重新编译即可成功！！！

三、总结

我们介绍了两种方式解决此问题，推荐使用第2种方式来解决！

这篇关于【我的C/C++语言学习进阶之旅】使用stb_image库时候报错 multiple definition of ‘stbi_xxxxx‘ 和 previous definition here的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/709188。

相关文章

HarmonyOS学习(七)——UI（五）常用布局总结

HarmonyOS学习(七)——UI（五）常用布局总结

自适应布局 1.1、线性布局（LinearLayout） 通过线性容器Row和Column实现线性布局。Column容器内的子组件按照垂直方向排列，Row组件中的子组件按照水平方向排列。 属性说明space通过space参数设置主轴上子组件的间距，达到各子组件在排列上的等间距效果alignItems设置子组件在交叉轴上的对齐方式，且在各类尺寸屏幕上表现一致，其中交叉轴为垂直时，取值为Vert
阅读更多...
Ilya-AI分享的他在OpenAI学习到的15个提示工程技巧

Ilya-AI分享的他在OpenAI学习到的15个提示工程技巧

Ilya（不是本人，claude AI）在社交媒体上分享了他在OpenAI学习到的15个Prompt撰写技巧。 以下是详细的内容： 提示精确化:在编写提示时,力求表达清晰准确。清楚地阐述任务需求和概念定义至关重要。例:不用"分析文本",而用"判断这段话的情感倾向:积极、消极还是中性"。 快速迭代:善于快速连续调整提示。熟练的提示工程师能够灵活地进行多轮优化。例:从"总结文章"到"用
阅读更多...
Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
中文分词jieba库的使用与实景应用（一）

中文分词jieba库的使用与实景应用（一）

知识星球：https://articles.zsxq.com/id_fxvgc803qmr2.html 目录 一.定义： 精确模式（默认模式）： 全模式： 搜索引擎模式： paddle 模式（基于深度学习的分词模式）： 二 自定义词典 三.文本解析   调整词出现的频率 四. 关键词提取 A. 基于TF-IDF算法的关键词提取 B. 基于TextRank算法的关键词提取
阅读更多...
使用SecondaryNameNode恢复NameNode的数据

使用SecondaryNameNode恢复NameNode的数据

1）需求： NameNode进程挂了并且存储的数据也丢失了，如何恢复NameNode 此种方式恢复的数据可能存在小部分数据的丢失。 2）故障模拟 （1）kill -9 NameNode进程 [lytfly@hadoop102 current]$ kill -9 19886 （2）删除NameNode存储的数据（/opt/module/hadoop-3.1.4/data/tmp/dfs/na
阅读更多...
Hadoop数据压缩使用介绍

Hadoop数据压缩使用介绍

一、压缩原则 （1）运算密集型的Job，少用压缩 （2）IO密集型的Job，多用压缩 二、压缩算法比较 三、压缩位置选择 四、压缩参数配置 1）为了支持多种压缩/解压缩算法，Hadoop引入了编码/解码器 2）要在Hadoop中启用压缩，可以配置如下参数
阅读更多...
【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【课程链接】 AntV G6：深入图形与图形分组、自定义节点、节点动画（下）_哔哩哔哩_bilibili 本章十吾老师讲解了一个复杂的自定义节点中，应该怎样去计算和绘制图形，如何给一个图形制作不间断的动画，以及在鼠标事件之后产生动画。（有点难，需要好好理解） <!DOCTYPE html><html><head><meta charset="UTF-8"><title>06
阅读更多...
Java进阶13讲__第12讲_1/2

Java进阶13讲__第12讲_1/2

多线程、线程池 1.  线程概念 1.1  什么是线程 1.2  线程的好处 2.   创建线程的三种方式 注意事项 2.1  继承Thread类 2.1.1 认识  2.1.2  编码实现  package cn.hdc.oop10.Thread;import org.slf4j.Logger;import org.slf4j.LoggerFactory
阅读更多...
Makefile简明使用教程

Makefile简明使用教程

文章目录 规则makefile文件的基本语法：加在命令前的特殊符号：.PHONY伪目标: Makefilev1 直观写法v2 加上中间过程v3 伪目标v4 变量 make 选项-f-n-C Make 是一种流行的构建工具，常用于将源代码转换成可执行文件或者其他形式的输出文件(如库文件、文档等)。Make 可以自动化地执行编译、链接等一系列操作。 规则 makefile文件
阅读更多...
学习hash总结

学习hash总结

2014/1/29/   最近刚开始学hash，名字很陌生，但是hash的思想却很熟悉，以前早就做过此类的题，但是不知道这就是hash思想而已，说白了hash就是一个映射，往往灵活利用数组的下标来实现算法，hash的作用：1、判重；2、统计次数；
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2