Сравнение шаблона и сгенерированного им файла
Этот рисунок показывает часть пользовательского измененного пользовательского шаблона обработки файлов (CFP) и полученного сгенерированного кода. Рисунок иллюстрирует, как можно использовать шаблон для:
Определите, какой код должна добавить программа генерации кода в сгенерированный файл
Управление расположением кода в файле
При необходимости вставьте комментарии в сгенерированный файл
Заметьте %<Includes>, для примера, на шаблоне. Термин Includes является именем символа. Процент знака и скобок (%< >) должны содержать все имена символов. Вы можете добавить желаемое имя символа (в пределах %< > разделитель) в определенном месте шаблона. Вот как вы управляете, где генератор кода помещает элемент в сгенерированный файл.
Шаблон и сгенерированный файл
Отображение спецификации шаблона с генерацией кода
| Эта часть шаблона... | Генерирует в файле... | Объяснение | ||
|---|---|---|---|---|
| Линия | Описание | |||
| (1) | /*#INCLUDES*/ %<Includes> | 26–28 | Система координат /*#INCLUDES*/ комментарий, далее следуют #include операторы | Генератор кода добавляет комментарий C/C + + в качестве заголовка, а затем интерпретирует %<Includes> символ шаблона для перечисления необходимых #include операторы в файле. Этот код находится сначала в этом разделе файла, поскольку сначала указываются записи шаблона. |
| (2) | /*#DEFINES*/ %<Defines> | 30 | A /*#DEFINES*/ комментарий, но нет #define операторы | Затем генератор кода помещает комментарий в качестве заголовка для #define операторы, но файл не нужен #define. Код не добавлен. |
| (3) | #pragma string1 | 31 | #pragma операторы | Пока генератор кода требует %<> разделители для символов шаблона, они также могут интерпретировать операторы C/C + + в шаблоне без разделителей. В этом случае генератор добавляет указанные операторы в код, следуя порядку, в котором операторы появляются в шаблоне. |
| (5) | #pragma string2 | 42 | ||
| (4) | /*DEFINITIONS*/ %<Definitions> | 32–41 | /*DEFINITIONS*/ комментарий, за которым следуют определения | Генератор кода помещает комментарий и определения в файл между #pragma операторы в соответствии с порядком в шаблоне. Он также вставляет комментарии (линии 33 и 36), которые предустановлены в диалоговом окне параметров конфигурации модели. |
| (6) | %<Declarations> | 43 | Никаких деклараций | Файл не нуждается в объявлениях, поэтому генератор кода не генерирует объявления для этого файла. Шаблон не имеет комментария, чтобы предоставить заголовок. Линия 43 остается пустой. |
| (7) | %<Functions> | 44–74 | Функции | Наконец, генератор кода добавляет функции из модели, плюс комментарии, которые предустановлены в диалоговом окне Параметры конфигурации. Но он не добавляет никаких комментариев в качестве заголовка для функций, потому что у шаблона его нет. Этот код является последним, поскольку запись шаблона является последней. |
Список символов шаблона и правил их использования см. в разделах «Группы шаблонов символов», «Символы шаблонов» и «Правила изменения или создания шаблона». Чтобы задать опции комментария, в диалоговом окне Параметры конфигурации выберите панель Code Generation > Comments. Для получения дополнительной информации см. раздел «Настройка комментариев кода».