Что значит @ {.... @} в Си? - PullRequest
2 голосов
/ 08 марта 2019

Я просматривал кодовую базу прошивки для нашей платы на базе ATSAME70 и наткнулся на что-то вроде этого:

//@{

#define SPI1_MISO_GPIO        (PIO_PC26_IDX)
#define SPI1_MISO_FLAGS       (PIO_PERIPH_C | PIO_PULLUP)

/** SPI1 MOSI pin definition. */
#define SPI1_MOSI_GPIO        (PIO_PC27_IDX)
#define SPI1_MOSI_FLAGS       (PIO_PERIPH_C | PIO_PULLUP)

/** SPI1 SPCK pin definition. */
#define SPI1_SPCK_GPIO        (PIO_PC24_IDX)
#define SPI1_SPCK_FLAGS       (PIO_PERIPH_C | PIO_DEFAULT)


/** SPI1 chip select 0 pin definition. (Only one configuration is possible) */
#define SPI1_NPCS0_GPIO        (PIO_PC25_IDX)
#define SPI1_NPCS0_FLAGS       (PIO_PERIPH_C | PIO_PULLUP)

//@}

Обратите внимание на @ {и @} в начале и конце соответственно. Я не знаю, было ли это закомментировано позже или это было похоже на все это время. Мне любопытно, что это значит. Это просто какой-то стиль комментирования или он имеет какое-то особое значение в C? Я пытался спросить в моей команде, но никто не имеет ни малейшего понятия, почему это там. Я даже не знаю, какие ключевые слова для поиска. Поиск @ {@} не дает никаких полезных результатов. Буду признателен, если кто-нибудь сможет пролить свет на это.

1 Ответ

4 голосов
/ 08 марта 2019

Разделители @{ и @} всегда комментировались в этом фрагменте кода. Они не являются частью языка C, они обрабатываются doxygen для создания документации программного обеспечения.

Вот страница с дополнительными пояснениями: http://www.doxygen.nl/manual/grouping.html

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...