【UIKit】-1- UIKitDefines.h - 跨平台,包容 C 库

http://blog.csdn.net/u013059266/article/details/46998703

import <Availability.h>

ifdef __cplusplus

define UIKIT_EXTERN extern "C" attribute((visibility("default")))

else

define UIKIT_EXTERN extern attribute((visibility ("default")))

endif

defineUIKIT_STATIC_INLINE static inline

我的总结主要是为了跨平台使用代码 extern “C”,就是为了支持C的库。苹果 api 中用的比较多。
类似 UIKIT_EXTERN,对应还有FOUNDATION_EXTERN

if defined(__cplusplus)

define FOUNDATION_EXTERNextern "C"

else

define FOUNDATION_EXTERNextern

endif

部分使用,不是很懂的样子。
UIKIT_EXTERNNSString *const UIDeviceOrientationDidChangeNotification; // 设备旋转
UIKIT_EXTERNNSString *const UIDeviceBatteryStateDidChangeNotification;  // 电池状态
UIKIT_EXTERNNSString *const UIDeviceBatteryLevelDidChangeNotification;  // 电池电量
UIKIT_EXTERNNSString *const UIDeviceProximityStateDidChangeNotification;  // 近距离传感器

1、UIKitt提供中几个图像上下文(Graphics contex)的函数,此处忽略pdf相关的处理
UIKIT_EXTERNCGContextRef UIGraphicsGetCurrentContext(void);
UIKIT_EXTERN voidUIGraphicsPushContext(CGContextRef context);
UIKIT_EXTERN voidUIGraphicsPopContext(void);

UIKIT_EXTERN voidUIRectFillUsingBlendMode(CGRect rect, CGBlendMode blendMode);
UIKIT_EXTERN voidUIRectFill(CGRect rect);

UIKIT_EXTERN voidUIRectFrameUsingBlendMode(CGRect rect, CGBlendMode blendMode);
UIKIT_EXTERN voidUIRectFrame(CGRect rect);

UIKIT_EXTERN voidUIRectClip(CGRect rect);

// UIImage context
UIKIT_EXTERN void UIGraphicsBeginImageContext(CGSize size);
UIKIT_EXTERN void UIGraphicsBeginImageContextWithOptions(CGSize size, BOOL opaque, CGFloatscale) NS_AVAILABLE_IOS(4_0);
UIKIT_EXTERN UIImage*UIGraphicsGetImageFromCurrentImageContext(void);
UIKIT_EXTERN void UIGraphicsEndImageContext(void);

各种解释:以下转载
一般用于将C++代码以标准C形式输出(即以C的形式被调用),这是因为C++虽然常被认为是C的超集,但是C++的编译器还是与C的编译器不同的。C中调用C++中的代码这样定义会是安全的。
一般的考虑跨平台使用方法如下:

ifdefined(__cplusplus)||defined(c_plusplus) //跨平台定义方法

extern "C"{

endif

//... 正常的声明段

ifdefined(__cplusplus)||defined(c_plusplus)

}

endif

简单的用在windows下可以如下定义:

ifdef __cplusplus

extern "C"{
//... 正常的声明段
}

endif

某一网文:

ifdef__cplusplus是什么意思?

时常在cpp的代码之中看到这样的代码:

ifdef__cplusplus

extern"C"{

endif

//一段代码

ifdef__cplusplus

}

endif

这样的代码到底是什么意思呢?
首先,__cplusplus是cpp中的自定义宏,那么定义了这个宏的话表示这是一段cpp的代码,也就是说,上面的代码的含义是:
如果这是一段cpp的代码,那么加入extern"C"{和}处理其中的代码。
要明白为何使用extern"C",还得从cpp中对函数的重载处理开始说起。在c++中,为了支持重载机制,在编译生成的汇编码中,要对函数的名字进行一些处理,加入比如函数的返回类型等等.而在C中,只是简单的函数名字而已,不会加入其他的信息.也就是说:C++和C对产生的函数名字的处理是不一样的.
比如下面的一段简单的函数,我们看看加入和不加入extern"C"产生的汇编代码都有哪
些变化:
intf(void)
{
return1;
}
在加入extern"C"的时候产生的汇编代码是:
.file"test.cxx"
.text
.align2
.globl_f
.def_f;.scl2;.type32;.endef
_f:
pushl%ebp
movl%esp,%ebp
movl$1,%eax
popl%ebp
ret
但是不加入了extern"C"之后
.file"test.cxx"
.text
.align2
.globl__Z1fv
.def__Z1fv;.scl2;.type 32;.endef
__Z1fv:
pushl%ebp
movl%esp,%ebp
movl$1,%eax
popl%ebp
ret
两段汇编代码同样都是使用gcc-S命令产生的,所有的地方都是一样的,唯独是产生的
函数名,一个是_f,一个是__Z1fv。
明白了加入与不加入extern"C"之后对函数名称产生的影响,我们继续我们的讨论:为什
么需要使用extern"C"呢?C++之父在设计C++之时,考虑到当时已经存在了大量的C代码,
为了支持原来的C代码和已经写好C库,需要在C++中尽可能的支持C,而extern"C"就是
其中的一个策略。
试想这样的情况:一个库文件已经用C写好了而且运行得很良好,这个时候我们需要使
用这个库文件,但是我们需要使用C++来写这个新的代码。如果这个代码使用的是C++的
方式链接这个C库文件的话,那么就会出现链接错误.我们来看一段代码:首先,我们使用C
的处理方式来写一个函数,也就是说假设这个函数当时是用C写成的:
//f1.c
extern"C"
{
voidf1()
{
return;
}
}
编译命令是:gcc-cf1.c-of1.o产生了一个叫f1.o的库文件。再写一段代码调用这个f1
函数:
//test.cxx
//这个extern表示f1函数在别的地方定义,这样可以通过
//编译,但是链接的时候还是需要
//链接上原来的库文件.
externvoidf1();
intmain()
{
f1();
return0;
}
通过gcc-ctest.cxx-otest.o产生一个叫test.o的文件。然后,我们使用gcctest.of1.o来
链接两个文件,可是出错了,错误的提示是:
test.o(.text+0x1f):test.cxx:undefinereferenceto'f1()'
也就是说,在编译test.cxx的时候编译器是使用C++的方式来处理f1()函数的,但是实
际上链接的库文件却是用C的方式来处理函数的,所以就会出现链接过不去的错误:因为链
接器找不到函数。
因此,为了在C++代码中调用用C写成的库文件,就需要用extern"C"来告诉编译器:
这是一个用C写成的库文件,请用C的方式来链接它们。
比如,现在我们有了一个C库文件,它的头文件是f.h,产生的lib文件是f.lib,那么我
们如果要在C++中使用这个库文件,我们需要这样写:
extern"C"
{

include"f.h"

}
回到上面的问题,如果要改正链接错误,我们需要这样子改写test.cxx:
extern"C"
{
externvoidf1();
}
intmain()
{
f1();
return0;
}
重新编译并且链接就可以过去了.
总结
C和C++对函数的处理方式是不同的.extern"C"是使C++能够调用C写作的库文件的一
个手段,如果要对编译器提示使用C的方式来处理函数的话,那么就要使用extern"C"来说
明。
另一篇文章:

ifdef__cplusplus

ifdef__cplusplus倒底是什么意思?

时常在cpp的代码之中看到这样的代码:

ifdef__cplusplus

extern "C" {

endif

//一段代码

ifdef__cplusplus

}

endif

这样的代码到底是什么意思呢?首先,__cplusplus是cpp中的自定义宏,那么定义了这个宏的话表示这是一段cpp的代码,也就是说,上面的代码的含义是:如果这是一段cpp的代码,那么加入extern "C"{和}处理其中的代码。

要明白为何使用extern "C",还得从cpp中对函数的重载处理开始说起。在c++中,为了支持重载机制,在编译生成的汇编码中,要对函数的名字进行一些处理,加入比如函数的返回类型等等.而在C中,只是简单的函数名字而已,不会加入其他的信息.也就是说:C++和C对产生的函数名字的处理是不一样的.

比如下面的一段简单的函数,我们看看加入和不加入extern"C"产生的汇编代码都有哪些变化:

int f(void)
{
return 1;
}
  在加入extern "C"的时候产生的汇编代码是:

.file "test.cxx"
.text
.align 2
.globl _f
.def _f; .scl 2; .type 32; .endef
_f:
pushl %ebp
movl %esp, %ebp
movl $1, %eax
popl %ebp
ret
  但是不加入了extern "C"之后

.file "test.cxx"
.text
.align 2
.globl __Z1fv
.def __Z1fv; .scl 2; .type 32; .endef
__Z1fv:
pushl %ebp
movl %esp, %ebp
movl $1, %eax
popl %ebp
ret
  两段汇编代码同样都是使用gcc -S命令产生的,所有的地方都是一样的,唯独是产生的函数名,一个是_f,一个是__Z1fv。

明白了加入与不加入extern "C"之后对函数名称产生的影响,我们继续我们的讨论:为什么需要使用extern "C"呢?C++之父在设计C++之时,考虑到当时已经存在了大量的C代码,为了支持原来的C代码和已经写好C库,需要在C++中尽可能的支持C,而extern"C"就是其中的一个策略。

试想这样的情况:一个库文件已经用C写好了而且运行得很良好,这个时候我们需要使用这个库文件,但是我们需要使用C++来写这个新的代码。如果这个代码使用的是C++的方式链接这个C库文件的话,那么就会出现链接错误.我们来看一段代码:首先,我们使用C的处理方式来写一个函数,也就是说假设这个函数当时是用C写成的:

//f1.c
extern "C"
{
void f1()
{
return;
}
}
  编译命令是:gcc -c f1.c -o f1.o产生了一个叫f1.o的库文件。再写一段代码调用这个f1函数:

// test.cxx
//这个extern表示f1函数在别的地方定义,这样可以通过
//编译,但是链接的时候还是需要
//链接上原来的库文件.
extern void f1();

int main()
{
f1();

return 0;
}
  通过gcc -c test.cxx -o test.o产生一个叫test.o的文件。然后,我们使用gcc test.o f1.o来链接两个文件,可是出错了,错误的提示是:

test.o(.text + 0x1f):test.cxx: undefinereference to 'f1()'
  也就是说,在编译test.cxx的时候编译器是使用C++的方式来处理f1()函数的,但是实际上链接的库文件却是用C的方式来处理函数的,所以就会出现链接过不去的错误:因为链接器找不到函数。

因此,为了在C++代码中调用用C写成的库文件,就需要用extern "C"来告诉编译器:这是一个用C写成的库文件,请用C的方式来链接它们。

比如,现在我们有了一个C库文件,它的头文件是f.h,产生的lib文件是f.lib,那么我们如果要在C++中使用这个库文件,我们需要这样写:

extern "C"
{

include "f.h"

}
  回到上面的问题,如果要改正链接错误,我们需要这样子改写test.cxx:

extern "C"
{
extern void f1();
}

int main()
{
f1();

return 0;
}
  重新编译并且链接就可以过去了.

总结

C和C++对函数的处理方式是不同的.extern "C"是使C++能够调用C写作的库文件的一个手段,如果要对编译器提示使用C的方式来处理函数的话,那么就要使用extern "C"来说明。

1.引言
C++语言的创建初衷是“a better C”,但是这并不意味着C++中类似C语言的全局变量和函数所采用的编译和连接方式与C语言完全相同。作为一种欲与C兼容的语言,C++保留了一部分过程式语言的特点(被世人称为“不彻底地面向对象”),因而它可以定义不属于任何类的全局变量和函数。但是,C++毕竟是一种面向对象的程序设计语言,为了支持函数的重载,C++对全局函数的处理方式与C有明显的不同。
2.从标准头文件说起
某企业曾经给出如下的一道面试题:
面试题
为什么标准头文件都有类似以下的结构?

ifndef __INCvxWorksh

define __INCvxWorksh

ifdef__cplusplus

extern "C" {

endif

ifdef__cplusplus

}

endif

endif

分析
显然,头文件中的编译宏“#ifndef __INCvxWorksh、#define __INCvxWorksh、#endif”的作用是防止该头文件被重复引用。
那么

ifdef__cplusplus

extern "C" {

endif

ifdef__cplusplus

}

endif

的作用又是什么呢?我们将在下文一一道来。
3.深层揭密extern "C"
extern "C" 包含双重含义,从字面上即可得到:首先,被它修饰的目标是“extern”的;其次,被它修饰的目标是“C”的。让我们来详细解读这两重含义。
(1)被extern "C"限定的函数或变量是extern类型的;
extern是C/C++语言中表明函数和全局变量作用范围(可见性)的关键字,该关键字告诉编译器,其声明的函数和变量可以在本模块或其它模块中使用。记住,下列语句:
extern int a;
仅仅是一个变量的声明,其并不是在定义变量a,并未为a分配内存空间。变量a在所有模块中作为一种全局变量只能被定义一次,否则会出现连接错误。
通常,在模块的头文件中对本模块提供给其它模块引用的函数和全局变量以关键字extern声明。例如,如果模块B欲引用该模块A中定义的全局变量和函数时只需包含模块A的头文件即可。这样,模块B中调用模块A中的函数时,在编译阶段,模块B虽然找不到该函数,但是并不会报错;它会在连接阶段中从模块 A编译生成的目标代码中找到此函数。
与extern对应的关键字是static,被它修饰的全局变量和函数只能在本模块中使用。因此,一个函数或变量只可能被本模块使用时,其不可能被extern “C”修饰。
(2)被extern "C"修饰的变量和函数是按照C语言方式编译和连接的;
未加extern “C”声明时的编译方式
首先看看C++中对类似C的函数是怎样编译的。
作为一种面向对象的语言,C++支持函数重载,而过程式语言C则不支持。函数被C++编译后在符号库中的名字与C语言的不同。例如,假设某个函数的原型为:
void foo( int x, int y );
该函数被C编译器编译后在符号库中的名字为_foo,而C++编译器则会产生像_foo_int_int之类的名字(不同的编译器可能生成的名字不同,但是都采用了相同的机制,生成的新名字称为“mangled name”)。_foo_int_int这样的名字包含了函数名、函数参数数量及类型信息,C++就是靠这种机制来实现函数重载的。例如,在C++中,函数void foo( int x, int y )与void foo( int x, float y )编译生成的符号是不相同的,后者为_foo_int_float。
同样地,C++中的变量除支持局部变量外,还支持类成员变量和全局变量。用户所编写程序的类成员变量可能与全局变量同名,我们以"."来区分。而本质上,编译器在进行编译时,与函数的处理相似,也为类中的变量取了一个独一无二的名字,这个名字与用户程序中同名的全局变量名字不同。
未加extern "C"声明时的连接方式
假设在C++中,模块A的头文件如下:
// 模块A头文件 moduleA.h

ifndef MODULE_A_H

define MODULE_A_H

int foo( int x, int y );

endif

在模块B中引用该函数:
// 模块B实现文件 moduleB.cpp
#i nclude "moduleA.h"
foo(2,3);
实际上,在连接阶段,连接器会从模块A生成的目标文件moduleA.obj中寻找_foo_int_int这样的符号!
加extern "C"声明后的编译和连接方式
加extern "C"声明后,模块A的头文件变为:
// 模块A头文件 moduleA.h

ifndef MODULE_A_H

define MODULE_A_H

extern "C" int foo( int x, int y);

endif

在模块B的实现文件中仍然调用foo( 2,3 ),其结果是:
(1)模块A编译生成foo的目标代码时,没有对其名字进行特殊处理,采用了C语言的方式;
(2)连接器在为模块B的目标代码寻找foo(2,3)调用时,寻找的是未经修改的符号名_foo。
如果在模块A中函数声明了foo为extern "C"类型,而模块B中包含的是extern int foo( int x, int y ) ,则模块B找不到模块A中的函数;反之亦然。
所以,可以用一句话概括extern “C”这个声明的真实目的(任何语言中的任何语法特性的诞生都不是随意而为的,来源于真实世界的需求驱动。我们在思考问题时,不能只停留在这个语言是怎么做的,还要问一问它为什么要这么做,动机是什么,这样我们可以更深入地理解许多问题):
实现C++与C及其它语言的混合编程。
明白了C++中extern"C"的设立动机,我们下面来具体分析extern "C"通常的使用技巧。
4.extern "C"的惯用法
(1)在C++中引用C语言中的函数和变量,在包含C语言头文件(假设为cExample.h)时,需进行下列处理:
extern "C"
{
#i nclude "cExample.h"
}
而在C语言的头文件中,对其外部函数只能指定为extern类型,C语言中不支持extern "C"声明,在.c文件中包含了extern "C"时会出现编译语法错误。
笔者编写的C++引用C函数例子工程中包含的三个文件的源代码如下:

ifndef C_EXAMPLE_H

define C_EXAMPLE_H

extern int add(int x,int y);

endif

#i nclude "cExample.h"
int add( int x, int y )
{
return x + y;
}
// c++实现文件,调用add:cppFile.cpp
extern "C"
{
#i nclude "cExample.h"
}
int main(int argc, char* argv[])
{
add(2,3);
return 0;
}
如果C++调用一个C语言编写的.DLL时,当包括.DLL的头文件或声明接口函数时,应加extern "C" {}。
(2)在C中引用C++语言中的函数和变量时,C++的头文件需添加extern "C",但是在C语言中不能直接引用声明了extern "C"的该头文件,应该仅将C文件中将C++中定义的extern "C"函数声明为extern类型。
笔者编写的C引用C++函数例子工程中包含的三个文件的源代码如下:
//C++头文件 cppExample.h

ifndef CPP_EXAMPLE_H

define CPP_EXAMPLE_H

extern "C" int add( int x, int y);

endif

//C++实现文件 cppExample.cpp
#i nclude "cppExample.h"
int add( int x, int y )
{
return x + y;
}

extern int add( int x, int y );
int main( int argc, char* argv[] )
{
add( 2, 3 );
return 0;
}

推荐阅读更多精彩内容

  • 简介 C++98/03的设计目标:一、比C语言更适合系统编程(且与C语言兼容)。二、支持数据抽象。三、支持面向对象...
    认真学计算机阅读 4,918评论 0 53
  • [简介][] 简介 目录 1. 关于 C++ 中的 extern "C" 1.1. 简介 1...
    QuietHeart阅读 3,209评论 1 29
  • 引言 C++保留了一部分过程式语言的特点,因而它可以定义不属于任何类的全局变量和函数。但是,C++毕竟是一种面向对...
    期门阅读 606评论 1 1
  • 1.项目经验 2.基础问题 3.指南认识 4.解决思路 ios开发三大块: 1.Oc基础 2.CocoaTouch...
    阳光的大男孩儿阅读 4,418评论 0 14
  • 一直想开自己的微信公众号,写点大家感兴趣的东西,但结果就是大家看到的,我的公众号注册了两个月,一个字都没有发...
    相信那个相信你的我阅读 829评论 2 1
  • 今天感慨有点多,请先看看下图 这是孩子们为我捯饬的花花草草。吃点心休息时间,问了他们几个问题,一下子把孩子的记...
    蕙心紈质阅读 155评论 0 0
  • 2013年的夏天,有天下班,大雨滂沱,我开车路过雁南路,看见我的小闺蜜段思思和她的古牧芭蕾在她家小区门口的站牌那拉...
    狸妍阅读 91评论 0 1
  • 《半生缘》是一个让我最不忍读下去的故事。 “日子过得真快,尤其对于中年以后的人,十年八年都好像是指顾间的事。可是对...
    南金吖阅读 6,381评论 4 5