Каковы правила использования подчеркивания в идентификаторе C ++? - PullRequest
875 голосов
/ 23 октября 2008

В C ++ принято называть переменные-члены с каким-то префиксом, обозначающим тот факт, что они являются переменными-членами, а не локальными переменными или параметрами. Если вы пришли из MFC, вы, вероятно, будете использовать m_foo. Я также иногда видел myFoo.

C # (или, возможно, просто .NET) рекомендует использовать только подчеркивание, как в _foo. Это разрешено стандартом C ++?

Ответы [ 5 ]

799 голосов
/ 23 октября 2008

Правила (которые не изменились в C ++ 11):

  • Зарезервировано в любой области, в том числе для использования в качестве реализации макросов:
    • идентификаторы, начинающиеся с символа подчеркивания, за которым сразу следует заглавная буква
    • идентификаторы, содержащие соседние подчеркивания (или «двойное подчеркивание»)
  • Зарезервировано в глобальном пространстве имен:
    • идентификаторы, начинающиеся с подчеркивания
  • Кроме того, все в пространстве имен std зарезервировано. (Тем не менее, вы можете добавлять шаблоны специализаций.)

Из стандарта C ++ 2003:

17.4.3.1.2 Глобальные имена [lib.global.names]

Определенные наборы имен и сигнатур функций всегда зарезервированы для реализации:

  • Каждое имя, которое содержит двойное подчеркивание (__) или начинается с подчеркивания, за которым следует заглавная буква (2.11), зарезервировано для реализации для любого использования.
  • Каждое имя, которое начинается со знака подчеркивания, зарезервировано для реализации для использования в качестве имени в глобальном пространстве имен. 165

165) Такие имена также зарезервированы в пространстве имен ::std (17.4.3.1).

Поскольку C ++ основан на стандарте C (1.1 / 2, C ++ 03), а C99 является нормативным справочником (1.2 / 1, C ++ 03), они также применимы к стандарту C 1999 года:

7.1.3 Зарезервированные идентификаторы

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

  • Все идентификаторы, которые начинаются с символа подчеркивания и заглавной буквы или другого подчеркивание всегда зарезервировано для любого использования.
  • Все идентификаторы, которые начинаются с подчеркивания, всегда зарезервированы для использования в качестве идентификаторов с областью видимости файла как в обычном пространстве, так и в пространстве имен тегов.
  • Каждое имя макроса в любом из следующих подпунктов (включая будущую библиотеку направления) зарезервировано для использования, как указано, если включен какой-либо из связанных с ним заголовков; если прямо не указано иное (см. 7.1.4).
  • Все идентификаторы с внешней связью в любом из следующих подпунктов (включая будущие направления библиотеки) всегда зарезервированы для использования в качестве идентификаторов с внешними связь. 154
  • Каждый идентификатор с областью действия файла указан в любом из следующих подпунктов (включая будущие направления библиотеки) зарезервировано для использования в качестве имени макроса и в качестве идентификатора с область файла в том же пространстве имен, если в нее включен любой из связанных с ним заголовков.

Другие идентификаторы не зарезервированы. Если программа объявляет или определяет идентификатор в контекст, в котором он зарезервирован (кроме как разрешено в 7.1.4), или определяет зарезервированный идентификатор в качестве имени макроса, поведение не определено.

Если программа удаляет (с #undef) любое макроопределение идентификатора в первом группа, указанная выше, поведение не определено.

154) Список зарезервированных идентификаторов с внешней связью включает в себя errno, math_errhandling, setjmp и va_end.

Могут применяться другие ограничения. Например, стандарт POSIX резервирует множество идентификаторов, которые могут отображаться в обычном коде:

  • Имена, начинающиеся с заглавной буквы E, за которой следует цифра или заглавная буква:
    • может использоваться для дополнительных имен кодов ошибок.
  • Имена, начинающиеся с is или to, за которыми следует строчная буква
    • может использоваться для дополнительных функций тестирования и преобразования символов.
  • Имена, начинающиеся с LC_, за которыми следует заглавная буква
    • может использоваться для дополнительных макросов, определяющих атрибуты локали.
  • Имена всех существующих математических функций с суффиксом f или l зарезервированы
    • для соответствующих функций, которые работают с аргументами типа float и long double.
  • Имена, начинающиеся с SIG, за которыми следует заглавная буква, зарезервированы
    • для дополнительных имен сигналов.
  • Имена, начинающиеся с SIG_, за которыми следует заглавная буква, зарезервированы
    • для дополнительных действий сигнала.
  • Имена, начинающиеся с str, mem или wcs, за которыми следует строчная буква, зарезервированы
    • для дополнительных функций строк и массивов.
  • Имена, начинающиеся с PRI или SCN, за которыми следует любая строчная буква или X, зарезервированы
    • для макросов дополнительного формата
  • Имена, заканчивающиеся на _t, зарезервированы
    • для дополнительных имен типов.

Хотя использование этих имен в ваших собственных целях в настоящее время может не вызывать проблем, они повышают вероятность конфликта с будущими версиями этого стандарта.


Лично я просто не начинаю идентификаторы с подчеркивания. Новое дополнение к моему правилу: нигде не используйте двойные подчеркивания, что легко, поскольку я редко использую подчеркивание.

После исследования этой статьи мои идентификаторы больше не заканчиваются на _t поскольку это зарезервировано стандартом POSIX.

Правило о любом идентификаторе, оканчивающемся на _t, меня очень удивило. Я думаю, что это стандарт POSIX (пока не уверен), требующий разъяснений, а также официальных главы и стиха. Это из руководства GNU libtool , в котором перечислены зарезервированные имена.

CesarB предоставил следующую ссылку на POSIX 2004 зарезервированные символы и примечания «что многие другие зарезервированные префиксы и суффиксы ... можно найти там». POSIX 2008 здесь определены зарезервированные символы. Ограничения несколько более тонкие, чем указанные выше.

186 голосов
/ 23 октября 2008

Правила, позволяющие избежать коллизии имен, содержатся в стандарте C ++ (см. Книгу Страуструпа) и упоминаются гуру C ++ (Саттер и т. Д.).

Личное правило

Поскольку я не хотел иметь дело с делами и хотел простое правило, я разработал персональное , простое и правильное:

При именовании символа вы избежите столкновения с компилятором / ОС / стандартными библиотеками, если вы:

  • никогда не начинайте символ с подчеркивания
  • никогда не называйте символ с двумя последовательными подчеркиваниями внутри.

Конечно, размещение вашего кода в уникальном пространстве имен также помогает избежать коллизий (но не защитит от злых макросов)

Некоторые примеры

(я использую макросы, потому что они больше загрязняют код символов C / C ++, но это может быть что угодно, от имени переменной до имени класса)

#define _WRONG
#define __WRONG_AGAIN
#define RIGHT_
#define WRONG__WRONG
#define RIGHT_RIGHT
#define RIGHT_x_RIGHT

Выдержки из C ++ 0x draft

Из файла n3242.pdf (я ожидаю, что окончательный стандартный текст будет аналогичным):

17.6.3.3.2 Глобальные имена [global.names]

Определенные наборы имен и сигнатур функций всегда зарезервированы для реализации:

- Каждое имя, которое содержит двойное подчеркивание _ _ или начинается с подчеркивания, за которым следует заглавная буква (2.12), зарезервировано для реализации для любого использования.

- Каждое имя, начинающееся с подчеркивания, зарезервировано для реализации для использования в качестве имени в глобальном пространстве имен.

Но также:

17.6.3.3.5 Пользовательские литеральные суффиксы [usrlit.suffix]

Буквенные идентификаторы суффиксов, которые не начинаются с подчеркивания, зарезервированы для будущей стандартизации.

Это последнее предложение сбивает с толку, если только вы не считаете, что имя, начинающееся с одного подчеркивания и сопровождаемое строчной буквой, будет Ok, если не определено в общем пространстве имен ...

35 голосов
/ 23 октября 2008

С MSDN :

Использование двух последовательных символов подчеркивания (__) в начале идентификатора или одного начального подчеркивания, за которым следует заглавная буква, зарезервировано для реализаций C ++ во всех областях. Следует избегать использования одного начального подчеркивания, за которым следует строчная буква для имен с областью видимости файла из-за возможных конфликтов с текущими или будущими зарезервированными идентификаторами.

Это означает, что вы можете использовать одно подчеркивание в качестве префикса переменной-члена, если за ним следует строчная буква.

Это, по-видимому, взято из раздела 17.4.3.1.2 стандарта C ++, но я не могу найти оригинальный источник полного стандарта в Интернете.

См. Также этот вопрос .

23 голосов
/ 14 ноября 2008

Что касается другой части вопроса, обычно ставят подчеркивание на конце имени переменной, чтобы не конфликтовать с чем-то внутренним.

Я делаю это даже внутри классов и пространств имен, потому что тогда мне нужно запомнить только одно правило (по сравнению с «в конце имени в глобальной области видимости и в начале имени везде»).

3 голосов
/ 23 октября 2008

Да, подчеркивания могут использоваться в любом месте идентификатора. Я считаю, что правила таковы: любой из a-z, A-Z, _ в первом символе и те + 0-9 для следующих символов.

Префикс подчеркивания часто встречается в коде C - одиночное подчеркивание означает «частное», а двойное подчеркивание обычно резервируется для использования компилятором.

...