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

%% 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 в отличие от if 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 директива аналогична языку C switch заявление. Выражение expr должен быть типа, который можно сравнить для равенства с помощью == 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

Проверяет значение логического выражения. Если выражение имеет значение false, 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 token, запись создается в глобальной области.

%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

Ограничивает область переменных файлом, в котором они определены. A %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 ®, так и в ПК. Однако если вы используете обратную косую черту в именах папок ПК, обязательно избегайте их, например ,"C:\\mytlc". Можно также выразить имя папки ПК как литерал, используя спецификатор формата 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, так и в ПК. Однако если вы используете обратную косую черту в именах папок ПК, обязательно избегайте их, например, "C:\\mytlc". Можно также выразить имя папки ПК как литерал, используя спецификатор формата L, как в L"C:\mytlc".

%roll
%endroll

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

Этот пример %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 и второй - 20:39. Каждая область рулона либо помещается в тело петли (например, язык Си). for оператор) или встроенный, в зависимости от того, меньше ли длина области, чем порог крена.

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

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

rollVars (переменные крена) передаются в "Roller" для создания структур рулона. Определенные переменные цикла относительно блока:

Чтобы свернуть собственный вектор на основе областей крена блока, необходимо пройтись по указателю на вектор. Предполагая, что на ваш вектор указывает первый 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

Функция void не производит вывод и не должна возвращать значение. Он определяется как

%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 содержит развернутый текст, указанный между %openfile и %closefile директивы.

%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).

% если

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 loop, можно использовать 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 true, 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 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 имеет значение NULL, "".

Когда компилятор целевого языка определяет, что данный блок будет вращаться, он выполняет 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 директива должна появиться до первой 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

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

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

% selectfile

%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)

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

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

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

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

Функция FEVAL

FEVAL встроенная функция вызывает файловые функции MATLAB и MEX-функции. Структура:

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

В этой таблице показаны преобразования, выполняемые при использовании FEVAL.

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

Другие типы значений в настоящее время не поддерживаются.

В качестве примера этот оператор использует FEVAL встроенная функция вызова MATLAB для получения синуса входного аргумента.

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

Переменные (идентификаторы) могут принимать следующие постоянные значения. Обратите внимание на суффикс значения.

В этой таблице представлены константы компилятора целевого языка и их эквивалентные значения MATLAB.

Создание записей

Используйте %createrecord директива для создания новых записей в текущей области. Например, если требуется создать новую запись с именем Rec который содержит два элемента (например, Name "Name" и Type "t"), использовать

%createrecord Rec {  Name "Name"; Type "t" }

Добавление записей

Используйте %addtorecord директива о добавлении новых записей в существующие записи. Например, если имеется запись с именем Rec1 который содержит запись с именем Rec2, и вы хотите добавить дополнительный Rec2 к нему, использовать

%addtorecord Rec1 Rec2 {  Name "Name1"; Type "t1" }

На этом рисунке показан результат добавления записи к существующей.

Если требуется получить доступ к новой записи, можно использовать

%assign myname = Rec1.Rec2[1].Name

В этом же примере, если требуется добавить две записи к существующей записи, используйте

%addtorecord Rec1 Rec2 {  Name "Name1"; Type "t1" }
%addtorecord Rec1 Rec2 {  Name "Name2"; Type "t2" }

Это приводит к

Добавление параметров к существующей записи

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

%addtorecord Block[Idx] N 500 /% Adds N with value 500 to Block %/
%assign myn = Block[Idx].N    /% Gets the value 500 %/

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

Объемы

В следующих разделах описываются возможные области, которые может иметь переменная TLC.

Глобальная область.  По умолчанию переменные TLC имеют глобальную область действия. Глобальные переменные являются видимыми для кода в любом месте программы TLC и на них может ссылаться код. Глобальные переменные сохраняются на протяжении всего выполнения программы TLC. Глобальные переменные относятся к глобальному пулу.

Обратите внимание, что CompiledModel запись model.rtw файл имеет глобальную область. Поэтому доступ к этой структуре можно получить из функций или файлов TLC.

Можно использовать оператор разрешения области (::) для явной ссылки или создания глобальных переменных внутри функции. Примеры см. в разделе Оператор разрешения области.

Обратите внимание, что вы можете использовать %undef директива на освобождение памяти, используемой глобальными переменными.

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

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

%assign fs1 = 1
%filescope
%assign fs2 = 3

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

Область действия функции (локальная).  Переменные, определенные в теле функции, имеют область действия функции. То есть они являются видимыми внутри и локальными по отношению к определяющей функции. Например, в следующем фрагменте кода переменная localv является локальным по отношению к функции foo. Переменная x является глобальным.

%assign x = 3

%function foo(arg)
   %assign localv = 1
   %return x + localv
%endfunction

Имя локальной переменной может совпадать с именем глобальной переменной. Чтобы обратиться в функции к аналогичным локальным и глобальным переменным, необходимо использовать оператор разрешения области (::), чтобы устранить неоднозначность ссылок на переменные. Примеры см. в разделе Оператор разрешения области.

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

Структура %with директива -

%with expression
%endwith

Например, директива

%with CompiledModel.System[sysidx]
   ...
%endwith

добавляет CompiledModel.System[sysidx] область к списку поиска. Поиск в этой области выполняется раньше всего. Затем можно сослаться на имя системы просто по

Name

вместо

CompiledModel.System[sysidx].Name

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

Функции, использующие область генерации, включают GENERATE, GENERATE_TYPE, GENERATE_FUNCTION_EXISTS, и GENERATE_TYPE_FUNCTION_EXISTS. См. разделы СОЗДАНИЕ и GENERATE_TYPE функций. В этом разделе рассматривается создание области с помощью GENERATE встроенная функция в качестве примера.

Синтаксис GENERATE функция -

GENERATE(blk,fn)

Первый аргумент (blkКому GENERATE является допустимым именем записи. Второй аргумент (fn) - имя отправляемой функции. Когда функция отправляется через GENERATE вызов, TLC автоматически добавляет blk в список областей, искомых при разрешении ссылок на переменные. Таким образом, запись (blk) виден для отправленной функции, как если бы неявный %with <blk>... %endwith директива существовала в отправленной функции.

В этом контексте запись с именем blk говорят, что он находится в области генерации.

Ниже перечислены три файла TLC, иллюстрирующие использование области генерации. Файл polymorph.tlc создает две записи, представляющие два гипотетических типа блоков, MyBlock и YourBlock. Каждый тип записи имеет связанную функцию с именем aFunc. Специфичные для блоков реализации aFunc содержатся в файлах MyBlock.tlc и YourBlock.tlc.

Используя GENERATE вызовы, polymorph.tlc отправляет функции для каждого типа блока. Обратите внимание, что aFunc реализации могут относиться к полям MyBlock и YourBlock, поскольку эти записи находятся в области генерации.

Вызов и вывод polymorph.tlc, как показано в окне команд MATLAB, ниже:

tlc -v polymorph.tlc

The value of MyRecord.data is: 123
The value of YourRecord.theStuff is: 666

Оператор разрешения объема

Оператор разрешения области (::) используется для указания на необходимость поиска глобальной области при поиске TLC-функцией ссылки на переменную. Оператор разрешения области действия часто используется для изменения значения глобальных переменных (или даже для создания глобальных переменных) из функций.

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

%assign foo = 3   %% this variable has global scope
.
.
.
%function myfunc(arg)
   %assign foo = 3   %% this variable has local scope
   %assign ::foo = arg   %% this changes the global variable foo
%endfunction

Оператор разрешения области также можно использовать в функции для создания глобальных переменных. Следующая функция создает и инициализирует глобальную переменную:

%function sideffect(arg)
   %assign ::theglobal = arg   %% this creates a global variable
%endfunction

Как TLC разрешает ссылки на переменные

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

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

% с областью . Список поиска и последовательность поиска можно изменить с помощью %with директива. Например, при добавлении следующей конструкции:

%with CompiledModel.System[sysidx]
   ...
%endwith

System[sysidx] область добавляется в список поиска. Сначала выполняется поиск в этой области, как показано на этом рисунке.

Этот метод упрощает доступ к встроенным определениям. Использование %with (как и в предыдущем примере), можно ссылаться на имя системы просто по

Name

вместо

CompiledModel.System[sysidx].Name

Область действия функции.  Функция имеет собственный объем. Эта область добавляется к ранее описанному списку поиска, как показано на этой схеме.

Например, в следующем фрагменте кода:

% with CompiledModel.System[sysidx]
...
   %assign a=foo(x,y)
...
%endwith
...
%function foo(a,b)
...
   assign myvar=Name
...
%endfunction
...
%<foo(1,2)>

Если Name не определен в foo, назначение использует значение Name из предыдущего объема, CompiledModel.System[SysIdx].Name.

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

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

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

Область действия переменных в рамках функций

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

Это поведение по умолчанию можно переопределить с помощью %assign с оператором разрешения области (::).

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

Если %with входит в состав функции, связанная с ней область действия переносится с вложенными вызовами функций, как показано на следующем рисунке.

Вернуть

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

%function foo(s)
    %with s
        %return(name)
    %endwith
%endfunction

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