【UEFI实战】StdLib的编译和使用

UEFI的源代码中有一个Pacakge实现了UEFI下的标准C库，如下所示：

里面有很多C语言的基础函数，比如有stdio.h：

使用StdLib库可以方便对Linux等的代码的快速移植，也方便从其他C语言领域到UEFI开发的转移。

本文接下去介绍如何在UEFI下使用StdLib。

代码以vUDK2017: https://github.com/tianocore/edk2.git Tag vUDK2017.中的为例。

StdLib有独立的Package，可以独立编译。

本文使用的编译器是VS2015。

编译的步骤如下：

1. 运行edksetup.bat：

2. 执行build命令：

但是发现执行命令时报错了：

从说明中可以看出，报错的原因是宏重定义了，这是一个warning（编号是4117），由于EDK编译时默认设置了警告视为错误，所以这里就报错了。

我们可以查看出错代码：

所以意思是这里的__STDC_HOSTED__有重定义，所以这里可以做如下的修改：

这样的话编译就OK了。

这种方法理论上是OK的，但是有一个疑问，即默认情况下__STDC_HOSTED__的值是1吗？如果不是1的话，显然跟我们需要定义的值不一致。

这边没有找到这个宏到底是在哪个文件，不过可以在网上搜到相关的说明（Predefined macros | Microsoft Docs）：

Standard predefined macros

The compiler supports these predefined macros specified by the ISO C99 and ISO C++17 standards.

__cplusplus Defined as an integer literal value when the translation unit is compiled as C++. Otherwise, undefined.

__DATE__ The compilation date of the current source file. The date is a constant length string literal of the form Mmm dd yyyy. The month name Mmm is the same as the abbreviated month name in dates generated by the C Runtime Library asctime function. The first character of date dd is a space if the value is less than 10. This macro is always defined.

__FILE__ The name of the current source file. __FILE__ expands to a character string literal. To ensure that the full path to the file is displayed, use /FC (Full Path of Source Code File in Diagnostics). This macro is always defined.

__LINE__ Defined as the integer line number in the current source file. The value of the __LINE__ macro can be changed by using a #line directive. This macro is always defined.

__STDC__ Defined as 1 only when compiled as C and if the /Za compiler option is specified. Otherwise, undefined.

__STDC_HOSTED__ Defined as 1 if the implementation is a hosted implementation, one that supports the entire required standard library. Otherwise, defined as 0.

__STDCPP_THREADS__ Defined as 1 if and only if a program can have more than one thread of execution, and compiled as C++. Otherwise, undefined.

__TIME__ The time of translation of the preprocessed translation unit. The time is a character string literal of the form hh:mm:ss, the same as the time returned by the C Runtime Library asctime function. This macro is always defined.

可见这个宏的值不是0，就是1，所以上述的代码修改是没有问题的。

我们也可以在VS2015下实际编写一个程序来确定：

执行的结果如下：

当然上述的问题还有其它的解决方法：

1. 在代码中使用#pragma来屏蔽这个警告：

2. 在DSC中添加宏控制来屏蔽这个警告：

新加了宏之后，可以看到编译时有体现：

以上的三种方式都能够解决编译的问题。

一般StdLib单独编译没有多大的意义，重要的是将它编译到其它的实用模块中。

比如有AppPkg：

在AppPkg.dsc中可以看到对StdLib的包含：

对于StdLib的使用似乎也没有什么好多讲的，就是包含头文件之类的。

后续如果使用到再深入。

以上。