setTflCFunctionEntryParameters

Установите заданные параметры для функциональной записи в заменяющей таблице кода

Синтаксис

setTflCFunctionEntryParameters(hEntry,varargin)

Описание

пример

setTflCFunctionEntryParameters(hEntry,varargin) устанавливает заданные параметры для функциональной записи в заменяющей таблице кода.

Примеры

свернуть все

Этот пример показывает, как использовать функцию setTflCFunctionEntryParameters, чтобы установить заданные параметры для заменяющей записи функции кода для sqrt.

fcn_entry = RTW.TflCFunctionEntry;
fcn_entry.setTflCFunctionEntryParameters( ...
                               'Key',                      'sqrt', ...
                               'Priority',                 100, ...
                               'ImplementationName',       'sqrt', ...
                               'ImplementationHeaderFile', '<math.h>' );

Входные параметры

свернуть все

hEntry является указателем на заменяющую запись функции кода, ранее возвращенную hEntry = RTW.TflCFunctionEntry или hEntry = MyCustomFunctionEntry, где MyCustomFunctionEntry является классом, выведенным от RTW.TflCFunctionEntry.

Пример: fcn_entry

Пример: 'Key','sqrt'

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Key','sqrt'

Значение AcceptExprInput отмечает генератор кода, что функция реализации, описанная этой записью, принимает входные параметры выражения. Значением по умолчанию является true, если ImplType равняется FCN_IMPL_FUNCT и false, если ImplType равняется FCN_IMPL_MACRO.

Если значением является true, входные параметры выражения интегрированы в сгенерированный код в форме, подобной этой форме:

 rtY.Out1 = mySin(rtU.In1 + rtU.In2);

Если значением является false, временная переменная сгенерирована для входа выражения:

real_T rtb_Sum;

rtb_Sum = rtU.In1 + rtU.In2;
rtY.Out1 = mySin(rtb_Sum);

Пример: 'AcceptExprInput',true

Значение AdditionalHeaderFiles задает дополнительные заголовочные файлы для заменяющей записи таблицы кода. Векторы могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочей области MATLAB® или как функция MATLAB на пути поиска файлов, который возвращает вектор символов.

Пример: 'AdditionalHeaderFiles',{}

Значение AdditionalIncludePaths указывает, что полный путь дополнительных включает пути для заменяющей записи кода. Векторы символов или массив строк могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочем пространстве MATLAB или как функция MATLAB на пути поиска файлов, который возвращает вектор символов.

Пример: 'AdditionalIncludePaths',{}

Значение AdditionalLinkObjs задает дополнительные объекты ссылки для заменяющей записи таблицы кода. Векторы символов или массив строк могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочем пространстве MATLAB или как функция MATLAB на пути поиска файлов, который возвращает вектор символов.

Пример: 'AdditionalLinkObjs',{}

Значение AdditionalLinkObjsPaths задает полный путь дополнительных путей к объекту ссылки для заменяющей записи кода. Векторы символов или массив строк могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочем пространстве MATLAB или как функция MATLAB на пути поиска файлов, который возвращает вектор символов. Значением по умолчанию является {}.

Пример: 'AdditionalLinkObjsPaths',{}

Значение AdditionalSourceFiles задает дополнительные исходные файлы для заменяющей записи таблицы кода. Векторы символов или массив строк могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочем пространстве MATLAB или как функция MATLAB на пути поиска файлов, который возвращает вектор символов.

Пример: 'AdditionalSourceFiles',{}

Значение AdditionalSourcePaths задает полный путь дополнительных исходных путей для заменяющей записи кода. Векторы символов или массив строк могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочем пространстве MATLAB или как функция MATLAB на пути поиска файлов, который возвращает вектор символов.

Пример: 'AdditionalSourcePaths',{}

Значение AdditionalCompileFlags задает дополнительные флаги, требуемые скомпилировать исходные файлы, заданные для заменяющей записи таблицы кода. Значением по умолчанию является {}.

Пример: 'AdditionalCompileFlags',{}

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

Пример: 'AdditionalLinkFlags',{}

Значение ArrayLayout задает порядок элементов массива в памяти, поддержанной заменяющей реализацией. По умолчанию, заменяющая поддержка внедрения главный столбцом формат данных. Для ROW-MAJOR, заменяющая поддержка внедрения главный строкой формат данных. Для COLUMN_AND_ROW, заменяющая поддержка внедрения главные столбцом и главные строкой форматы данных.

Пример: 'ArrayLayout','ROW_MAJOR'

Значение EntryInfoAlgorithm задает метод вычисления или приближения, сконфигурированный для заданной математической функции, которая должна быть соответствующей для функциональной замены, чтобы произойти. Заменяющая замена функции поддержки библиотек кода на основе метода вычисления или приближения для математических функций rSqrt, sin, cos и sincos. Допустимые аргументы для каждой поддерживаемой функции перечислены в таблице.

ФункцияАргументЗначение

rSqrt

RTW_DEFAULT

Совпадайте с методом вычисления по умолчанию, Exact

RTW_NEWTON_RAPHSON

Совпадайте с методом вычисления Newton-Raphson

RTW_UNSPECIFIED

Совпадайте с методом вычисления

sin

cos

sincos

RTW_CORDIC

Совпадайте с методом приближения CORDIC

RTW_DEFAULT

Совпадайте с методом приближения по умолчанию, None

RTW_UNSPECIFIED

Совпадайте с методом приближения

Пример: 'EntryInfoAlgorithm','RTW_DEFAULT'

GenCallback задает коллбэк, который следует за генерацией кода. Если вы задаете 'RTW.copyFileToBuildDir', и если эта функциональная запись является соответствующей и используется, функция вызовов генератора кода RTW.copyFileToBuildDir после генерации кода. Эта функция обратного вызова копирует дополнительный заголовок, источник или объектные файлы, которые вы задали для этой функциональной записи в папку сборки. Для получения дополнительной информации смотрите, Указывают информацию Сборки для Заменяющего Кода.

Пример: 'GenCallback',''

Значение ImplementationHeaderFile задает имя заголовочного файла, который объявляет функцию реализации, например, '<math.h>'. Вектор символов или скаляр строки могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочем пространстве MATLAB или как функция MATLAB на пути поиска файлов, который возвращает вектор символов.

Пример: 'ImplementationHeaderFile',''

Значение ImplementationHeaderPath задает полный путь к заголовочному файлу реализации. Вектор символов или скаляр строки могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочем пространстве MATLAB или как функция MATLAB на пути поиска файлов, который возвращает вектор символов.

Пример: 'ImplementationHeaderPath',''

Значение ImplementationName задает имя функции реализации, например, 'sqrt', который может соответствовать или отличаться от имени Key.

Пример: 'ImplementationName',''

Значение ImplementationSourceFile задает имя исходного файла реализации. Вектор символов или скаляр строки могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочем пространстве MATLAB или как функция MATLAB на пути поиска файлов, который возвращает вектор символов.

Пример: 'ImplementationSourceFile',''

Значение ImplementationSourcePath задает полный путь к исходному файлу реализации. Вектор символов или скаляр строки могут включать лексемы. Например, в маркерном $mytoken$, mytoken является переменной, заданной как вектор символов или скаляр строки в рабочем пространстве MATLAB или как функция MATLAB на пути поиска файлов, который возвращает вектор символов.

Пример: 'ImplementationSourcePath',''

Используйте FCN_IMPL_FUNCT для функции или FCN_IMPL_MACRO для макроса.

Пример: 'ImplType','FCN_IMPL_FUNCT'

Значение ключа задает имя функции, чтобы заменить. Имя должно совпадать с именем функции, перечисленным в Коде, который Можно Заменить из кода MATLAB или Кода, который Можно Заменить Из Моделей Simulink.

Пример: 'Key','sqrt'

Значение Priority задает поисковый приоритет для функциональной записи относительно других записей того же имени функции и концептуального списка аргументов в рамках этой таблицы. Самый высокий приоритет 0, и самый низкий приоритет равняется 100. Если таблица обеспечивает две реализации для функции, реализацию с более высокими приоритетными тенями та с более низким приоритетом.

Пример: 'Priority',100

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

Пример: 'RoundingModes',{'RTW_ROUND_UNSPECIFIED'}

Значение SaturationMode задает режим насыщения, поддержанный функцией реализации.

Пример: 'SaturationMode','RTW_SATURATE_UNSPECIFIED'

Значение SideEffects отмечает генератор кода, чтобы не оптимизировать далеко функцию реализации, описанную этой записью. Этот параметр применяется к функциям реализации, которые возвращают void, но не должны быть оптимизированы далеко, такие как реализация memcpy или функция реализации та глобальная память доступов значения. Для тех реализация функционирует только, необходимо включать этот параметр и задать значение true.

Пример: 'SideEffects',false

Значение StoreFcnReturnInLocalVar отмечает генератор кода, что возвращаемое значение функции реализации, описанной этой записью, должно храниться в локальной переменной независимо от других настроек сворачивания выражения. Если значением является false, другие настройки сворачивания выражения определяют, свернуто ли возвращаемое значение. Хранение функции возвращается в локальной переменной, может увеличить ясность сгенерированного кода. Этот пример показывает код, сгенерированный со сворачиванием выражения:

void sw_step(void)
{
    if (ssub(sadd(sw_U.In1, sw_U.In2), sw_U.In3) <= 
        smul(ssub(sw_U.In4, sw_U.In5),sw_U.In6)) {  
      sw_Y.Out1 = sw_U.In7;  
    } else {
       sw_Y.Out1 = sw_U.In8;  
    }
}

С набором StoreFcnReturnInLocalVar к true сгенерированный код потенциально легче понять и отладить:

void sw_step(void)
{  
    real32_T rtb_Switch;  
    real32_T hoistedExpr;
    ......  
    rtb_Switch = sadd(sw_U.In1, sw_U.In2);
    rtb_Switch = ssub(rtb_Switch, sw_U.In3);
    hoistedExpr = ssub(sw_U.In4, sw_U.In5); 
    hoistedExpr = smul(hoistedExpr, sw_U.In6);  
    if (rtb_Switch <= hoistedExpr) {
       sw_Y.Out1 = sw_U.In7;  
    } else { 
       sw_Y.Out1 = sw_U.In8;  
    }
}

Пример: 'StoreFcnReturnInLocalVar',false

Представленный в R2007b