6.51 Имена функций как строки
GCC предоставляет три магические константы, которые содержат имя текущей функции в виде строки. В режимах C++11 и более поздних версиях все три рассматриваются как константные выражения и могут быть использованы в constexpr контекстах. Первая из этих констант — __func__, которая является частью стандарта C99:
Идентификатор __func__ неявно объявляется транслятором так, как будто сразу после открывающей фигурной скобки каждого определения функции объявляется
static const char __func__[] = "function-name";
где function-name — имя лексически окружающей функции. Это имя функции без дополнительных деталей. В качестве расширения, на уровне файла (или, в C++, на уровне пространства имён), __func__ возвращает пустую строку.
__FUNCTION__ — другое имя для __func__, предоставленное для обратной совместимости со старыми версиями GCC.
В C, __PRETTY_FUNCTION__ — ещё одно имя для __func__, за исключением того, что на уровне файла (или, в C++, на уровне пространства имён) оно возвращает строку "top level". Кроме того, в C++, __PRETTY_FUNCTION__ содержит подпись функции, а также её простое имя. Например, эта программа:
extern "C" int printf (const char *, ...);
class a {
public:
void sub (int i)
{
printf ("__FUNCTION__ = %s\n", __FUNCTION__);
printf ("__PRETTY_FUNCTION__ = %s\n", __PRETTY_FUNCTION__);
}
};
int
main (void)
{
a ax;
ax.sub (0);
return 0;
}
выводит следующий результат:
__FUNCTION__ = sub __PRETTY_FUNCTION__ = void a::sub(int)
Эти идентификаторы являются переменными, а не макросами препроцессора, и их нельзя использовать для инициализации char массивов или конкатенировать со строковыми литералами.
© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-14.2.0/gcc/Function-Names.html