ssWriteRTWParameters

Запись настраиваемого параметра информации в model.rtw файл

Синтаксис

int_T ssWriteRTWParameters(SimStruct *S,  int_T nParams, int_T
  paramType, const char_T *paramName, const char_T *stringInfo,
  ...)

Аргументы

S

SimStruct, представляющий блок S-Function.

nParams

Количество настраиваемых параметров.

paramType

Тип параметра (см. Parameter Type-Specific Аргументов).

paramName

Имя параметра.

stringInfo

Общая информация о параметре, например, как он был выведен.

...

Остальные аргументы зависят от типа параметра (см. «Аргументы типа параметра»).

Возвраты

Система координат int_T (1 или 0) или boolean_T (true или false), указывающий на успех или отказ функции.

Описание

Используйте эту функцию в mdlRTW чтобы записать настраиваемый параметр информацию в model этой S-функции.rtw файл. Ваша S-функция должна записать параметры в том же порядке, в котором они объявлены в начале S-функции.

Примечание

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

Аргументы, относящиеся к типу параметра

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

  • SSWRITE_VALUE_VECT (векторный параметр)

    АргументОписание
    const real_T *valueVectУказатель на массив вектора значений
    int_T vectLenДлина вектора
  • SSWRITE_VALUE_2DMAT (матричный параметр)

    АргументОписание
    const real_T *valueMatУказатель на массив элементов матрицы
    int_T nRowsКоличество строк в матрице
    int_T nColsКоличество столбцов в матрице
  • SSWRITE_VALUE_DTYPE_2DMAT

    АргументОписание
    const real_T *valueMatУказатель на массив элементов матрицы
    int_T nRowsКоличество строк в матрице
    int_T nColsКоличество столбцов в матрице
    int_T dtInfoТип данных элементов матрицы (см. «Определение типа данных» «Информация»)
  • SSWRITE_VALUE_DTYPE_ML_VECT

    АргументОписание
    const void *rValueVectДействительный компонент комплексного вектора
    const void *iValueVectМнимый компонент комплексного вектора
    int_T vectLenДлина вектора
    int_T dtInfoТип данных вектора (см. «Определение типа данных»)
  • SSWRITE_VALUE_DTYPE_ML_2DMAT

    АргументОписание
    const void *rValueMatX
    const void *iValueMatМнимый компонент комплексной матрицы
    int_T nRowsКоличество строк в матрице
    int_T nColsКоличество столбцов в матрице
    int_T dtInfoТип данных матрицы

Определение информации о типе данных

Вы получаете тип данных аргумента значения, переданного в ssWriteRTW макросы с использованием

DTINFO(dTypeId, isComplex)

где dTypeId может быть любым из enum значения в DTypeID (SS_DOUBLE, SS_SINGLE, SS_INT8, SS_UINT8, SS_INT16, SS_UINT16, SS_INT32, SS_UINT32, SS_BOOLEAN), заданный в sl_types_def.h. The isComplex аргумент либо 0 или 1.

Для примера, DTINFO(SS_INT32,0) является некомплексным 32-битным целым числом со знаком.

Если isComplex==1массив значений принято таким образом, чтобы действительная и мнимая части были расположены чередующимся образом (т.е. Simulink® формат). Если вы предпочитаете передавать действительную и мнимую части как два отдельных массива, следует использовать макрос ssWriteRTWMxVectParam или ssWriteRTWMx2dMatParam.

Языки

C, C++

См. также

mdlRTW

Представлено до R2006a