Документация

%% text

Однострочный комментарий, где text является комментарием.

/% text%/

Один (или мультилиния) комментируют, где text является комментарием.

%matlab

Вызывает функцию MATLAB, которая не возвращает результат. Например, %matlab disp(2.718).

%<expr>

Выражения выходного языка, которые выполнены. Например, если у вас будет переменная TLC, которая была создана через %assign varName = "foo", затем %<varName> расширится до foo. Выражения могут также быть вызовами функции, как в %<FcnName(param1,param2)>. На направляющих строках выражения TLC не должны быть помещены в синтаксисе %<>. Выполнение так вызывает двойную оценку. Например, %if %<x> == 3 обрабатывается путем создания скрытой переменной для оцененного значения переменной x. Оператор %if затем оценивает эту скрытую переменную и сравнивает ее с 3. Эффективный способ сделать эту операцию состоит в том, чтобы записать %if x == 3. В обозначении MATLAB это приравнялось бы к записи если eval('x') == 3 в противоположность если x = 3. Исключение к этому во время %assign для управления форматом, как в

 %assign str = "value is: %<var>"

Примечание: Вложенные выражения анализа (например, %<foo(%<expr>)> ) не поддержаны.

Нет штрафа скорости за оценки в строках, такой как

%assign x = "%<expr>"

Избегайте оценок вне строк, таких как следующий пример.

%assign x = %<expr>

%if expr
%elseif expr
%else
%endif

Условное включение, где константное выражение expr должен оценить к целому числу. Например, следующий код проверяет, имеет ли параметр, k, числовое значение 0.0 путем выполнения библиотечной функции TLC, чтобы проверять на равенство.

%if ISEQUAL(k, 0.0)
  <text and directives to be processed if k is 0.0>
%endif

В этом и других директивах, вы не должны расширять переменные или выражения с помощью обозначения %<expr>, если expr не появляется в строке. Например,

%if ISEQUAL(idx, "my_idx%<i>"), где idx и i являются оба строками.

Как на других языках, логические оценки делают короткую схему (остановлены, когда результат известен).

%switch expr
  %case expr
  %break
  %default
  %break
%endswitch

Директива %switch подобна оператору switch языка C. expr выражения должен иметь тип, который может быть сравнен для равенства с помощью the == operator. Если %break не будет включен после оператора %case, то он упадет до следующего оператора.

%with
%endwith

%with recordName является оператором определения объема. Используйте его, чтобы принести именованную запись в текущий осциллограф, остаться, пока с соответствующим %endwith не сталкиваются (директивы %with могут быть вложены, как желаемый).

Обратите внимание на то, что на левой стороне операторов %assign, содержавших в блоке %with / %endwith, ссылки на поля записей должны быть полностью определены (см. Значения Присвоения к Полям Записей), как в следующем примере.

%with CompiledModel
	 %assign oldName = name
	 %assign CompiledModel.name = "newname"
 	%endwith

%setcommandswitch string

Изменяет значение переключателя командной строки, как задано строкой аргумента. Только следующие переключатели поддерживаются:

v, m, p, O, d, r, I, a

Следующий пример устанавливает уровень многословия на 1.

%setcommandswitch "-v1"

См. также Параметры командной строки.

%assert expr

Тестирует значение Булевого выражения. Если выражение оценивает ко лжи, TLC выдает ошибку сообщение, трассировка стека и выход; в противном случае выполнение обычно продолжается. Чтобы включить оценку утверждений вне среды генератора кода, используйте параметр командной строки -da. При создании из генератора кода проигнорирован этот флаг, когда это заменяется флажком Enable TLC assertion на разделе TLC process Code Generation> панель Debug. Чтобы управлять обработкой утверждения из Окна Команды MATLAB, использовать

set_param(model, 'TLCAssertion', 'on|off')

установить этот флаг на или прочь. Значение по умолчанию Выключено. Чтобы видеть, что ток устанавливает, использовать

get_param(model, 'TLCAssertion')

%error
%warning
%trace
%exit

Директивы управления потоками:

При создании отчетов об ошибках используйте следующую команду, если ошибка производится неправильной настройкой, которую пользователь должен зафиксировать в модели.

%exit Error Message

Если вы добавляете, утверждают код (то есть, код, который никогда не должен достигаться), использовать

%setcommandswitch "-v1" %% force TLC stack trace 
%exit Assert message

%assign

Создает идентификаторы (переменные). Общая форма

%assign [::]variable = expression 

 :: указывает, что создаваемая переменная является глобальной переменной; в противном случае это - локальная переменная в текущем осциллографе (т.е. локальная переменная в функции).

Если необходимо отформатировать переменную, скажем, в строке, основанной на других переменных TLC, то необходимо выполнить двойную оценку, как в

%assign nameInfo = "The name of this is %<Name>"

или поочередно

%assign nameInfo = "The name of this is " + Name

Чтобы присвоить значение полю записи, необходимо использовать квалифицированное переменное выражение. Смотрите Значения Присвоения к Полям Записей.

%createrecord

Создает записи в памяти. Эта команда принимает список одной или нескольких спецификаций записи (например, { foo 27 }). Каждая спецификация записи содержит список нуля или большего количества пар "имя-значение" (например, foo 27), которые становятся членами создаваемой записи. Сами значения могут быть спецификациями записи, когда следующее иллюстрирует.

%createrecord NEW_RECORD { foo 1 ; SUB_RECORD {foo 2} }
%assign x = NEW_RECORD.foo                  /* x = 1 */
%assign y = NEW_RECORD.SUB_RECORD.foo       /* y = 2 */

Если больше чем одна спецификация записи следует за данным именем записи, набор спецификаций записи составляет массив записей.

%createrecord RECORD_ARRAY { foo 1 } ...
							        { foo 2 } ...
							        { bar 3 } 
%assign x = RECORD_ARRAY[1].foo             /* x = 2 */
%assign y = RECORD_ARRAY[2].bar             /* y = 3 */

Обратите внимание на то, что можно создать и индексировать массивы подзаписей путем определения %createrecord с тождественно именованными подзаписями, можно следующим образом:

%createrecord RECORD_ARRAY { SUB_RECORD { foo 1 } ... 
                             SUB_RECORD { foo 2 } ... 
                             SUB_RECORD { foo 3 } }
%assign x = RECORD_ARRAY.SUB_RECORD[1].foo  /* x = 2 */
%assign y = RECORD_ARRAY.SUB_RECORD[2].foo  /* y = 3 */

Если оператор разрешения области видимости (::) является первой лексемой после того, как лексема %createrecord, запись будет создана в глобальной области видимости.

%addtorecord

Добавляют поля к существующей записи. Новые поля могут быть парами "имя-значение" или псевдонимами к уже существующим записям.

%addtorecord OLD_RECORD foo 1

Если новое добавляемое поле является записью, то %addtorecord делает псевдоним к той записи вместо глубокой копии. Чтобы сделать глубокую копию, используйте %copyrecord.

%createrecord NEW_RECORD { foo 1 }
%addtorecord OLD_RECORD NEW_RECORD_ALIAS NEW_RECORD

%mergerecord

Добавляет (или слияния) одну или несколько записей в другого. Первая запись будет содержать результаты слияния первой записи плюс содержимое других записей, заданных командой. Содержимое второго (и последующий) записи глубоко копируются в первое (т.е. они не ссылки).

%mergerecord OLD_RECORD NEW_RECORD

Если дублирующиеся поля существуют в объединяемых записях, поля исходной записи не перезаписываются.

%copyrecord

Делает глубокую копию существующей записи. Это создает новую запись подобным способом к %createrecord кроме компонентов записи, глубоко копируются с существующей записи. Псевдонимы заменяются копиями.

%copyrecord NEW_RECORD OLD_RECORD

%realformat

Задает, как отформатировать действительные переменные. К формату в экспоненциальном представлении с 16 цифрами точности использовать

%realformat "EXPONENTIAL"

К формату без потери точности и минимального количества символов, использовать

%realformat "CONCISE"

При встраивании S-функций формат установлен в concise. Вы можете переключиться на exponential, но должны переключить его назад на concise, когда сделано.

%language

Это должно появиться перед первым GENERATE или вызовом функции GENERATE_TYPE. Это задает имя языка как строка, которая генерируется как в %language "C". Обычно это добавляется к вашему системному конечному файлу.

Единственным допустимым значением является C, который включает поддержку C и генерации кода C++, как задано параметром конфигурации TargetLang (см. Язык для получения дополнительной информации).

%implements

Помещенный в файле .tlc для определенного типа записи, когда сопоставлено через %generatefile. Синтаксисом является %implements "Type" "Language". При встраивании S-функции в C или C++, это должно быть первой строкой некомментария в файле, как в

%implements "s_function_name" "C"

Следующие строки некомментария будут директивами %function, задающими функциональность S-функции.

Смотрите, что %language и GENERATE функционируют описания для получения дополнительной информации.

%generatefile

Обеспечивает отображение между Type записи и функциями, содержавшимися в файле. Каждая запись может иметь функции того же имени, но различного содержимого, сопоставленного с ним (т.е. полиморфизм). Обычно это используется, чтобы сопоставить запись Block Type с файлом .tlc, который реализует функциональность блока, как в

%generatefile "Sin" "sin_wave.tlc"

%filescope

Ограничивает осциллограф переменных к файлу, в котором они заданы. Директива %filescope где угодно в файле объявляет, что переменные в файле видимы только в том файле. Обратите внимание на то, что это ограничение также применяется к вставленным файлам, с помощью директивы %include, в файл, содержащий директиву %filescope.

Вы не должны использовать директиву %filescope в функциях GENERATE или функциях.

%filescope полезен в сохранении памяти. Переменные, осциллограф которых ограничивается %filescope, выходят из осциллографа, когда выполнение файла, содержащего их, завершается. Это освобождает память выделенный таким переменным. В отличие от этого, глобальные переменные сохраняются в памяти в течение осуществления программы.

%include

Используйте %include "file.tlc", чтобы вставить заданный конечный файл в текущей точке.

Директивы %include ведут себя, как будто они были в глобальном контексте. Например,

%addincludepath "./sub1"
%addincludepath "./sub2"

в .tlc файл позволяет любой подпапке ссылаться неявно:

%include "file_in_sub1.tlc"
%include "file_in_sub2.tlc"

Используйте наклонные черты вправо для имен папок, когда они работают и над UNIX^® и над системами PC. Однако, если вы действительно используете наклонные черты влево на имена папок PC, убедиться выйти из них, например, "C:\\mytlc". Также можно выразить имя папки PC как литерал с помощью спецификатора формата L, как в L"C:\mytlc".

%addincludepath

Используйте %addincludepath "folder", чтобы добавить дополнительные пути, которые будут искаться. Могут появиться несколько директив %addincludepath. Компилятор оценивает несколько директив %addincludepath с самого начала.

Используя %addincludepath директивы устанавливает глобальный контекст. Например,

%addincludepath "./sub1"
%addincludepath "./sub2"

в .tlc файл позволяет любой подпапке ссылаться неявно:

%include "file_in_sub1.tlc"
%include "file_in_sub2.tlc"

Используйте наклонные черты вправо для имен папок, когда они работают и над UNIX и над системами PC. Однако, если вы действительно используете наклонные черты влево на имена папок PC, убедиться выйти из них, например, "C:\\mytlc". Также можно выразить имя папки PC как литерал с помощью спецификатора формата L, как в L"C:\mytlc".

%roll
%endroll

Несколько включение плюс внутренний цикл, прокручивающийся основанный на заданном пороге. Эта директива может использоваться большинством блоков Simulink^®, которые имеют концепцию полного блока width, который обычно является шириной сигнала, проходящего через блок.

Этот пример директивы %roll для операции усиления, y=u*k:

%function Outputs(block, system) Output
  /* %<Type> Block: %<Name> */
  %assign rollVars = ["U", "Y", "P"]
  %roll sigIdx = RollRegions, lcv = RollThreshold, block,... 
        "Roller", rollVars
    %assign y = LibBlockOutputSignal(0, "", lcv, sigIdx)
    %assign u = LibBlockInputSignal(0, "", lcv, sigIdx)
    %assign k = LibBlockParameter(Gain, "", lcv, sigIdx)
      %<y> = %<u> * %<k>;
  %endroll
%endfunction

Директива %roll подобна %foreach, за исключением того, что это выполняет итерации идентификатора (sigIdx в этом примере) по областям списка. Прокрутитесь области вычисляются путем рассмотрения входных сигналов и генерации областей, где входные параметры непрерывны. Для блоков переменная RollRegions автоматически вычисляется и помещается в запись Block. Примером вектора областей списка является [0:19, 20:39], где существует две непрерывных области значений сигналов, проходящих через блок. Первым является 0:19 и второй is 20:39. Каждая область списка или помещается в тело цикла (например, оператор for языка C) или встраивается, в зависимости от того, является ли длина области меньше, чем порог списка.

Каждый раз через цикл %roll, sigIdx является целым числом для запуска текущей области списка или смещения относительно полного блока width, когда текущая область списка является меньше, чем порог списка. Глобальная переменная TLC RollThreshold является общим значением всей модели, раньше решала, когда поместить данную область списка в цикл. Когда решение принято, чтобы поместить данную область в цикл, контрольная переменная цикла является допустимым идентификатором (например, "i"); в противном случае это - "".

Параметр block является текущим блоком, который прокручивается. Параметр "Roller" задает имя для внутренних вызовов GENERATE_TYPE, выполненных %roll. Обработчиком %roll по умолчанию является "Roller", который ответственен за подготовку структур прокрутки цикла блока по умолчанию (например, цикл for C).

rollVars (переменные списка) передается функциям "Roller", чтобы создать структуры списка. Заданные переменные цикла относительно блока

К roll ваш собственный вектор, основанный на областях списка блока, необходимо обойти указатель на вектор. На принятие вашего вектора указывает первый PWork, названный name,

datatype *buf = (datatype*)%<LibBlockPWork(name,"","",0)
%roll sigIdx = RollRegions, lcv = RollThreshold, block, ...
      "Roller", rollVars
  *buf++ = whatever;
%endroll

Примечание: В вышеупомянутом примере, sigIdx и lcv локальны для тела цикла.

%breakpoint

Устанавливает точку останова для отладчика TLC. См. %breakpoint Директиву.

%function
%return
%endfunction

Функция, которая возвращает значение, задана как

%function name(optional-arguments) 
    %return value 
  %endfunction

Пустая функция не производит вывод и не требуется, чтобы возвращать значение. Это задано как

%function name(optional-arguments) void 
  %endfunction

Функция, которая производит выходные параметры для текущего потока и не требуется, чтобы возвращать значение, задана как

%function name(optional-arguments) Output 
  %endfunction

Для конечных файлов блока можно добавить во встроенный файл .tlc следующие функции, которые вызваны конечными файлами всей модели во время генерации кода.

%foreach
%endforeach

Несколько включение, которое выполняет итерации от 0 до upperLimit-1 постоянного целого выражения. Каждый раз через цикл, loopIdentifier, (например, x) присвоен текущее значение итерации.

%foreach loopIdentifier = upperLimit 
   %break -- use this to exit the loop 
   %continue -- use this to skip the following code and  
                continue to the next iteration 
%endforeach

Примечание: выражение upperLimit брошено к целочисленному значению TLC. loopIdentifier локален для тела цикла.

%for

Несколько директива включения с синтаксисом

%for ident1 = const-exp1, const-exp2, ident2 = const-exp3
  %body
    %break
    %continue
  %endbody
%endfor

Первый фрагмент директивы %for идентичен оператору %foreach. %break и директивы %continue действуют то же самое, как они делают в директиве %foreach. const-exp2 является Булево выражение, которое указывает, должен ли цикл быть прокручен (см. %roll выше).

Если const-exp2 оценивает к TRUE, ident2 присвоен значение const-exp3. В противном случае ident2 присвоен пустая строка.

Примечание: ident1 и ident2 выше локальны для тела цикла.

%openfile
%selectfile
%closefile

Они используются, чтобы управлять файлами, которые создаются. Синтаксис

%openfile streamId="filename.ext" mode  {open for writing} 
%selectfile streamId                   {select an open file} 
%closefile streamId                     {close an open file}

Обратите внимание на то, что "filename.ext" является дополнительным. Если имя файла не задано, переменная (буфер строки) названный streamId создается содержащий вывод. Аргумент режима является дополнительным. Если задано, это может быть "a" для добавления или "w" для записи.

Обратите внимание на то, что специальная строка streamIdNULL_FILE не задает вывода. Специальная строка streamIdSTDOUT задает вывод к терминалу.

Чтобы создать буфер текста, использовать

%openfile buffer
text to be placed in the 'buffer' variable.
%closefile buffer

Теперь buffer содержит расширенный текст, заданный между директивами %closefile и %openfile.

%generate

%generate blk fn эквивалентен GENERATE (blk,fn).

%generate blk fn type эквивалентен GENERATE (blk,fn,type).

Смотрите ГЕНЕРИРУЮТ и функции GENERATE_TYPE.

%undef

%undef var удаляет переменную var из осциллографа. Если var является полем в записи, %undef удаляет то поле из записи. Если var является массивом записи, %undef удаляет целый массив записи.

Продвижения данных TLC

Когда Компилятор Выходного языка работает со смешанными типами выражений, он продвигает результаты общие типы, обозначенные в следующей таблице.

Таблица использует следующие сокращения:

Верхняя строка (полужирным) и первый столбец (полужирным) показывают типы выражения, используемого в операции. Пересечение строки и столбца показывает получившийся тип выражений.

Например, если операция включит Булево выражение (B) и выражение без знака (U), результатом будет выражение без знака (U).

%if

constant-expression должен оценить к целому выражению. Это управляет включением следующих строк, пока это не сталкивается с %else, %elseif или директивой %endif. Если constant-expression оценивает к 0, строки после директивы не включены. Если constant-expression оценивает к целочисленному значению кроме 0, строки после директивы %if включены до %endif, %elseif или директивы %else.

Когда компилятор сталкивается с директивой %elseif и никакая предшествующая директива %if или %elseif оценила к ненулевому, компилятор выполняет выражение. Если значение 0, строки после директивы %elseif не включены. Если значение является ненулевым, строки после директивы %elseif включены до последующего %else, %elseif или директивы %endif.

Директива %else начинает включение исходного текста, если предыдущие операторы %elseif или исходный оператор %if оценивают к 0; в противном случае это предотвращает включение последующих строк до и включая следующий %endif.

constant-expression может содержать любое выражение, заданное в Выражениях Выходного языка.

%switch

Оператор %switch выполняет константное выражение и сравнивает его с выражениями, появляющимися на селекторах %case. Если соответствие найдено, тело %case включено; в противном случае %default включен.

Тела %case ... %default текут вместе, как в C, и %break должен использоваться, чтобы выйти из оператора switch. %break выходит из самого близкого включения %switch, %foreach или цикл %for, в котором это появляется. Например,

%switch(type)
%case x         
	/* Matches variable x. */
	/* Note: Any valid TLC type is allowed. */
%case "Sin"
	/* Matches Sin or falls through from case x. */
   %break
	/* Exits the switch. */
%case "gain"
	/* Matches gain. */
   %break
%default
	/* Does not match x, "Sin," or "gain." */
%endswitch

В целом это - больше удобочитаемой формы для конструкции %if/%elseif/%else.

%foreach

Синтаксис %foreach несколько директива включения

%foreach identifier = constant-expression
   %break
   %continue
%endforeach

constant-expression должен оценить к целому выражению, которое затем определяет число раз, чтобы выполнить цикл foreach. identifier постепенно увеличивается от 0 до меньше, чем конкретное количество. В цикле foreach можно использовать x, где x является идентификатором, чтобы получить доступ к переменной идентификатора. %break и %continue являются дополнительными директивами, чтобы можно было включать в директиву %foreach:

для

Синтаксис %for несколько директива включения

%for ident1 = const-exp1, const-exp2, ident2 = const-exp3
  %body
    %break
    %continue
  %endbody
%endfor

Первый фрагмент директивы %for идентичен оператору %foreach, в котором это заставляет цикл выполняться от 0 до времен N-1 по телу цикла. В нормальном случае это включает только строки между %body и %endbody, и строки между %for и %body, и игнорирует строки между %endbody и %endfor.

%break и директивы %continue действуют то же самое, как они делают в директиве %foreach.

const-exp2 является Булево выражение, которое указывает, должен ли цикл быть прокручен. Если const-exp2 верен, ident2 получает значение const-exp3; в противном случае это получает пустую строку. Когда цикл прокручивается, строки между %for и %endfor включены в вывод точно одно время. ident2 задает идентификатор, который будет использоваться для тестирования, был ли цикл прокручен в теле. Например,

%for Index = <NumNonVirtualSubsystems>3, rollvar="i"

    {
        int i;

        for (i=0; i< %<NumNonVirtualSubsystems>; i++)
        {
          %body
	x[%<rollvar>] = system_name[%<rollvar>];
          %endbody

        }
    }
%endfor

Если количество невиртуальных подсистем (NumNonVirtualSubsystems) больше, чем или равно 3, цикл прокручивается, заставляя код в цикле быть сгенерированным точно однажды. В этом случае, Index = 0.

Если цикл не прокручивается, текст до и после тела цикла проигнорирован, и тело является сгенерированными временами NumNonVirtualSubsystems.

Этот механизм передает каждому отдельному управлению циклом, должно ли это быть прокручено.

%roll

Синтаксис %roll несколько директива включения

%roll ident1 = roll-vector-exp, ident2 = threshold-exp, ... 
               block-exp [, type-string [,exp-list] ]
  %break
  %continue
%endroll

Этот оператор использует roll-vector-exp, чтобы расширить тело оператора %roll многократно как в операторе %foreach. Если спектр будет предоставлен в roll-vector-exp, и та область значений больше, чем выражение threshold-exp, цикл прокрутится. То, когда цикл прокручивается, тело цикла расширено однажды, и идентификатор (ident2) предусмотрел пороговое выражение, установлено в имя контрольной переменной цикла. Если никакая область значений не больше, чем заданный порог прокрутки, этот оператор идентичен оператору %foreach. Например,

%roll Idx = [ 1 2 3:5, 6, 7:10 ], lcv = 10, ablock
%endroll

В этом случае тело оператора %roll расширяется 10 раз, как в операторе %foreach, потому что нет никаких областей, больше, чем или равны 10. количества Idx от 1 до 10, и lcv установлены в пустую строку, "".

Когда Компилятор Выходного языка решает, что данный блок прокрутится, это выполняет вызов функции GENERATE_TYPE вывести различные части цикла (кроме тела). Используемым типом по умолчанию является Roller; можно заменить этот тип со строкой, которую вы задаете. Дополнительные аргументы, переданные оператору %roll, предоставляются в качестве аргументов этим функциям специального назначения. Вызванная функция является одной из этих четырех функций:

RollHeader(block, ...).  Эта функция вызвана однажды на первом разделе этого вектора списка, который на самом деле прокрутится. Это должно возвратить строку, которая присвоена lcv в теле оператора %roll.

LoopHeader(block, StartIdx, Niterations, Nrolled, ...).  Эта функция вызвана однажды для каждого раздела, который прокрутится до тела оператора %roll.

LoopTrailer(block, Startidx, Niterations, Nrolled, ...).  Эта функция вызвана однажды для каждого раздела, который прокрутится после тела оператора %roll.

RollTrailer(block, ...).  Эта функция вызвана однажды в конце оператора %roll, если какая-либо из областей значений вызвала прокрутку цикла.

Эти функции должны вывести специфичные для языка объявления, код цикла, и так далее как требуется, чтобы сгенерировать код для цикла.

Пример файла Roller.tlc

%implements Roller "C"
%function RollHeader(block) Output
	{
		int i;
	%return ("i")
%endfunction
%function LoopHeader(block,StartIdx,Niterations,Nrolled) Output
 	for (i = %<StartIdx>; i < %<Niterations+StartIdx>; i++)
	{
%endfunction
%function LoopTrailer(block,StartIdx,Niterations,Nrolled) Output
	}
%endfunction
%function RollTrailer(block) Output
	}
%endfunction

Расширение бывшего примера к циклу, который прокручивается,

%language "C"
%assign ablock = BLOCK { Name "Hi" }
%roll Idx = [ 1:20, 21, 22, 23:25, 26:46], lcv = 10, ablock
	Block[%< lcv == "" ? Idx : lcv>] *= 3.0;
%endroll

Этот код Компилятора Выходного языка производит этот вывод:

{
	int             i;
	for (i = 1; i < 21; i++)
	{
	    Block[i] *= 3.0;
	}
	Block[21] *= 3.0;
	Block[22] *= 3.0;
	Block[23] *= 3.0;
	Block[24] *= 3.0;
	Block[25] *= 3.0;
	for (i = 26; i < 47; i++)
	{
	    Block[i] *= 3.0;
	}
}

%language

Директива %language задает сгенерированный выходной язык. Это требуется как проверка на непротиворечивость проверить файлы реализации, найденные для сгенерированного языка. Директива %language должна появиться до первого GENERATE или вызова встроенной функции GENERATE_TYPE. %language задает язык как строку. Например:

%language "C"

Блоки Simulink имеют параметр Type. Этот параметр является строкой, которая задает тип блока, например, "Sin" или "Gain". Объектно-ориентированное средство использует этот тип, чтобы искать путь файл, который реализует блок. По умолчанию именем файла является Type блока с добавленным .tlc, так например, если бы Type является "Sin", Компилятор искал бы "Sin.tlc" вдоль пути. Можно заменить это имя файла по умолчанию с помощью директивы %generatefile, чтобы задать имя файла, которое вы хотите использовать, чтобы заменить имя файла по умолчанию. Например,

%generatefile "Sin" "sin_wave.tlc"

Файлы, которые реализуют специфичный для блока код, должны содержать директиву %implements указание и тип и реализовываемый язык. Компилятор Выходного языка произведет ошибку, если директива %implements не будет соответствовать как ожидалось. Например,

%implements "Sin" "Pascal"

вызывает ошибку, если начальным выбором языка был C.

Можно использовать один файл, чтобы реализовать больше чем один выходной язык путем определения желаемых языков в векторе. Например,

%implements "Sin" "C"

Наконец, можно реализовать несколько типов с помощью подстановочного знака (*) для поля типа:

%implements * "C"

СГЕНЕРИРУЙТЕ и функции GENERATE_TYPE

Компилятор Выходного языка имеет две встроенных функции, которые диспетчеризируют объектно-ориентированные вызовы, GENERATE и GENERATE_TYPE. Можно вызвать функцию, появляющуюся в файле реализации (снаружи заданного файла) только при помощи GENERATE и GENERATE_TYPE специальные функции.

СГЕНЕРИРОВАТЬ.  Функция GENERATE берет два или больше входных параметра. Первый аргумент должен быть допустимым осциллографом и вторым строка, содержащая имя функции, чтобы вызвать. Функция GENERATE передает первый аргумент блока и любые дополнительные аргументы, заданные к вызванной функции. Возвращаемый аргумент является значением, если таковые имеются, возвращенный в вызванную функцию. Обратите внимание на то, что компилятор автоматически “определяет объем” или добавляет первый аргумент в список осциллографов, искавших, как будто это появляется на направляющей строке %with. (См. Переменное Определение объема.) Этот осциллограф удален, когда функция возвращается.

GENERATE_TYPE.  Функция GENERATE_TYPE берет три или больше входных параметра. Это обрабатывает первые два аргумента тождественно к вызову функции GENERATE. Третий аргумент является типом; тип, заданный в блоке Simulink, проигнорирован. Это средство используется, чтобы обработать генерацию кода S-функции процессом сборки. Таким образом, типом блока является S-function, но Компилятор Выходного языка генерирует его как определенную S-функцию, заданную GENERATE_TYPE. Например,

GENERATE_TYPE(block, "Output", "dp_read")

указывает, что S-функция block имеет тип dp_read.

Аргумент block и любые дополнительные аргументы передаются вызванной функции. Как встроенная функция GENERATE, компилятор автоматически определяет объем первого аргумента, прежде чем функция GENERATE_TYPE будет введена и затем удалит осциллограф по возврату.

В файле, содержащем %implements, вызовы функции ищутся сначала в файле и затем в глобальной области видимости. Это позволяет скрыть функции помощника, используемые исключительно текущим объектом.

Открытый файл

Директива %openfile открывает файл или буфер для записи; необходимая строковая переменная становится переменной типа file. Например,

%openfile x               /% Opens and selects x for writing. %/
%openfile out = "out.h"   /% Opens "out.h" for writing. %/

Выбор File

Директива %selectfile выбирает файл, заданный переменной как поток текущей производительности. Выведите переходит к тому файлу, пока другой файл не выбран с помощью %selectfile. Например,

%selectfile x               /% Select file x for output. %/

%closefile

Директива %closefile закрывает заданный файл или буфер. Если закрытая сущность является в настоящее время выбранным потоком вывода, %closefile вызывает %selectfile к повторному выбору ранее выбранный поток вывода.

Существует два возможных случая, которые должен обработать %closefile:

При желании можно добавить к выходному файлу или строке при помощи дополнительного режима, a, как в

%openfile "foo.c", "a"             %% Opens foo.c for appending.

Включение

Директива %include ищет путь конечный файл, заданный string, и включает содержимое файла, встроенного в точке, где оператор %include появляется.

%addincludepath

Директива %addincludepath добавляет, что дополнительное включает путь, который будет искаться, когда Справочники по компилятору Выходного языка %include или блокируют конечные файлы. Синтаксис

%addincludepath string

string может быть абсолютным путем или явным относительным путем. Например, чтобы задать абсолютный путь, использовать

%addincludepath "C:\\folder1\\folder2"     (PC)
%addincludepath "/folder1/folder2"         (UNIX)

Чтобы задать относительный путь, путь должен явным образом запуститься с .. Например,

%addincludepath ".\\folder2"                  (PC)
%addincludepath "./folder2"                   (UNIX)

Обратите внимание на то, что для PC, наклонных черт влево нужно оставить (удвоенные).

Когда явный относительный путь задан, папка, которая добавляется к пути поиска файлов Компилятора Выходного языка, создается путем конкатенации местоположения конечного файла, который содержит директиву %addincludepath и явный относительный путь.

Компилятор Выходного языка ищет папки в следующем порядке цель, или включайте файлы:

Как правило, директивы %addincludepath должны быть заданы в вашем системном конечном файле. Несколько директив %addincludepath добавят разнообразные пути к пути поиска файлов Компилятора Выходного языка.

Функция FEVAL

%assign result = FEVAL( matlab-function-name, rhs1, rhs2, ... 
	rhs3, ... );

%assign result = FEVAL( "sin", 3.14159 )