Сравнение шаблона и сгенерированного им файла

Этот рисунок показывает часть пользовательского измененного пользовательского шаблона обработки файлов (CFP) и полученного сгенерированного кода. Рисунок иллюстрирует, как можно использовать шаблон для:

  • Определите, какой код должна добавить программа генерации кода в сгенерированный файл

  • Управление расположением кода в файле

  • При необходимости вставьте комментарии в сгенерированный файл

Заметьте %<Includes>, для примера, на шаблоне. Термин Includes является именем символа. Процент знака и скобок (%< >) должны содержать все имена символов. Вы можете добавить желаемое имя символа (в пределах %< > разделитель) в определенном месте шаблона. Вот как вы управляете, где генератор кода помещает элемент в сгенерированный файл.

Шаблон и сгенерированный файл

Отображение спецификации шаблона с генерацией кода

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

Список символов шаблона и правил их использования см. в разделах «Группы шаблонов символов», «Символы шаблонов» и «Правила изменения или создания шаблона». Чтобы задать опции комментария, в диалоговом окне Параметры конфигурации выберите панель Code Generation > Comments. Для получения дополнительной информации см. раздел «Настройка комментариев кода».