__PRETTY_FUNCTION__语法解析及GCC中该宏的使用示例说明

阿华AIGC实验室

2026-5-21

解析GCC的__PRETTY_FUNCTION__：语法、功能与示例分析

嘿，咱们来深入聊聊GCC提供的__PRETTY_FUNCTION__这个实用扩展——不管是调试复杂模板代码，还是追踪函数调用细节，它都能帮上大忙。下面我会拆解它的语法、核心功能，再结合你给出的示例程序详细分析编译运行后的结果。

一、__PRETTY_FUNCTION__的语法本质

__PRETTY_FUNCTION__是GCC实现的预定义宏，属于GNU C扩展，并非C标准的一部分。它的使用语法非常简单：直接在函数体内引用即可，不需要额外的头文件或声明——编译器会在编译阶段自动将它替换为一个包含当前函数完整签名的字符串常量。

二、GCC中__PRETTY_FUNCTION__的核心功能

根据GCC文档第6.48章节（函数名称作为字符串），__PRETTY_FUNCTION__的核心作用是生成包含函数完整上下文信息的字符串，这比C++标准里的__func__要详细得多：

标准宏__func__仅返回函数的简单名称；
而__PRETTY_FUNCTION__会包含：
- 函数所属的命名空间、类/结构体名称；
- 类模板与函数模板的参数信息；
- 函数的const/volatile修饰符、noexcept异常说明；
- 函数的参数类型列表。

这个特性在处理模板重载、嵌套命名空间里的函数时，能帮你快速定位当前调用的是哪个具体的函数实例，调试效率拉满。

三、示例程序的编译运行分析

先看你给出的示例代码：

#include <iostream>
#include <string>
namespace n1 {
    namespace n2 {
        template<typename T>
        class t1 {
        public:
            template<typename R>
            R f(T const&) const noexcept {
                std::cout << __PRETTY_FUNCTION__ << std::endl;
                return {};
            }
        };
    }
}
int main() {
    n1::n2::t1<std::string>{}.f<double>(std::string{});
}

编译与运行结果

用g编译（比如g++ -std=c++11 example.cpp -o example，C11及以上标准都支持），运行生成的可执行文件后，会输出如下内容：

R n1::n2::t1<T>::f(const T&) const noexcept [with R = double; T = std::string]

输出内容拆解

咱们逐段解析这个输出的含义：

R：函数模板f的返回类型参数；
n1::n2::t1<T>：函数所属的类模板，包含了嵌套的命名空间n1::n2，T是类模板的类型参数；
f(const T&) const noexcept：函数的核心签名——函数名f、参数类型const T&、成员函数的const修饰符，以及noexcept异常说明；
[with R = double; T = std::string]：明确当前实例化的模板参数值——类模板t1的参数T是std::string，函数模板f的参数R是double。