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

Тип параметра (см. Параметр Специфичные для типа Аргументы).

paramName

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

stringInfo

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

...

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

Возвращается

int_T (1 или 0) или boolean_T (true или false) указание на успешность или неуспешность функции.

Описание

Используйте эту функцию в mdlRTW, чтобы записать информацию о настраиваемом параметре в файл model.rtw этой S-функции. Ваша 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) заданный в simstuc_types.h. Аргументом isComplex является или 0 или 1.

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

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

Языки

C, C++

Смотрите также

mdlRTW

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