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