Spec-Zone.ru › GCC 12

6.50 Имена функций как строки

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 массивов или конкатенироваться со строковыми литералами.

Далее: Адрес возврата, Предыдущее: Неполные перечисления, Вверх: Расширения C [Содержание][Индекс]

© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-12.2.0/gcc/Function-Names.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API