Spec-Zone.ru › GCC 4

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

GCC предоставляет три магические переменные, которые хранят имя текущей функции в виде строки. Первая из них — __func__, которая является частью стандарта C99:

Идентификатор __func__ неявно объявляется переводчиком как будто, сразу после открывающей фигурной скобки каждого определения функции, объявление

static const char __func__[] = "function-name";

появляется, где function-name — имя лексически окружающей функции. Это имя — простое имя функции.

__FUNCTION__ — это другое имя для __func__. Более старые версии GCC распознают только это имя. Однако оно не стандартизовано. Для максимальной переносимости рекомендуется использовать __func__, но предоставить резервное определение с помощью препроцессора:

#if __STDC_VERSION__ < 199901L
# if __GNUC__ >= 2
#  define __func__ __FUNCTION__
# else
#  define __func__ "<unknown>"
# endif
#endif

В C, __PRETTY_FUNCTION__ — еще одно имя для __func__. Однако в C++, __PRETTY_FUNCTION__ содержит сигнатуру типа функции, а также ее простое имя. Например, эта программа:

extern "C" {
extern int printf (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)

Эти идентификаторы не являются макросами препроцессора. В GCC 3.3 и более ранних версиях, только в C, __FUNCTION__ и __PRETTY_FUNCTION__ обрабатывались как строковые литералы; они могли использоваться для инициализации массивов char, и они могли конкатенироваться с другими строковыми литералами. GCC 3.4 и более поздние версии обрабатывают их как переменные, как __func__. В C++, __FUNCTION__ и __PRETTY_FUNCTION__ всегда были переменными.

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

Spec-Zone.ru

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