На этом рисунке показана часть пользовательского шаблона пользовательской обработки файлов (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 | Функции | Наконец, генератор кода добавляет функции из модели, а также комментарии, заданные в диалоговом окне Параметры конфигурации (Configuration Parameters). Но он не добавляет комментарии в качестве заголовка для функций, потому что шаблон не имеет таковой. Этот код является последним, поскольку запись шаблона является последней. |
Список символов шаблонов и правила их использования см. в разделах Группы символов шаблонов, Символы шаблонов и Правила изменения или создания шаблонов. Чтобы задать параметры комментария, в диалоговом окне «Параметры конфигурации» выберите панель «Создание кода» > «Комментарии». Дополнительные сведения см. в разделе Настройка комментариев кода.