Exponenta Banner

coder.wref

Укажите на данные только для записи, чтобы передать ссылкой

свернуть все на странице

Синтаксис

coder.wref(arg)

Описание

пример

coder.wref(arg) указывает, что arg является выражением только для записи или переменной, чтобы передать в отношении внешней функции C/C++. Используйте coder.wref только в вызове coder.ceval. Эта функция позволяет генератору кода оптимизировать сгенерированный код путем игнорирования предшествующих присвоений на arg в коде MATLAB®, потому что внешняя функция принята, чтобы не читать из данных. Запишите во все элементы arg в вашем внешнем коде, чтобы полностью инициализировать память.

Примечание

Функция C/C++ должна полностью инициализировать память, на которую ссылается coder.wref(arg). Инициализируйте память путем присвоения значений каждому элементу arg в коде C/C++. Если сгенерированный код пытается читать из неинициализированной памяти, он может вызвать неопределенное поведение во время выполнения.

См. также coder.ref и coder.rref.

Примеры

Передайте массив ссылкой как только для записи

Предположим, что у вас есть функция C init_array. 

void init_array(double* array, int numel) {
  for(int i = 0; i < numel; i++) {
    array[i] = 42;
  }
}

Функция C задает входную переменную array как указатель на двойное.

Вызовите функцию C init_array, чтобы инициализировать все элементы y к 42:

...
Y = zeros(5, 10);
coder.ceval('init_array', coder.wref(Y), int32(numel(Y)));
...

Передайте несколько аргументов как ссылку только для записи

...
U = zeros(5, 10);
V = zeros(5, 10); 
coder.ceval('my_fcn', coder.wref(U), int32(numel(U)), coder.wref(V), int32(numel(V)));
...

Передайте свойство класса как ссылку только для записи

...
x = myClass;
x.prop = 1;
coder.ceval('foo', coder.wref(x.prop));
...

Передайте структуру как ссылку только для записи

Чтобы указать, что тип структуры задан в заголовочном файле C, используйте coder.cstructname.

Предположим, что у вас есть функция C init_struct. Эта функция пишет во входной параметр, но не читает из него.

#include "MyStruct.h"

void init_struct(struct MyStruct *my_struct)
{
   my_struct->f1 = 1; 
   my_struct->f2 = 2;
}

Заголовочный файл C, MyStruct.h, задает тип структуры, названный MyStruct:

#ifndef MYSTRUCT
#define MYSTRUCT

typedef struct MyStruct
{
    double f1;
    double f2;
} MyStruct;

void init_struct(struct MyStruct *my_struct);

#endif

В вашей функции MATLAB передайте структуру как ссылку только для записи на init_struct. Используйте coder.cstructname, чтобы указать, что тип структуры для s имеет имя MyStruct, который задан в заголовочном файле C MyStruct.h.

function y = foo
%#codegen
y = 0;
coder.updateBuildInfo('addSourceFiles','init_struct.c');

s = struct('f1',1,'f2',2);
coder.cstructname(s,'MyStruct','extern','HeaderFile','MyStruct.h');
coder.ceval('init_struct', coder.wref(s));

Сгенерировать автономный код библиотеки, введите:

codegen -config:lib foo -report

Передайте поле структуры как ссылку только для записи

...
s = struct('s1', struct('a', [0 1]));
coder.ceval('foo', coder.wref(s.s1.a));
...

Можно также передать элемент массива структур:

...
c = repmat(struct('u',magic(2)),1,10);
b = repmat(struct('c',c),3,6);
a = struct('b',b);
coder.ceval('foo', coder.wref(a.b(3,4).c(2).u));
...

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

свернуть все

Аргумент, чтобы передать в отношении внешней функции C/C++. Аргумент не может быть классом, Система object™, массив ячеек или индекс в массив ячеек.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | struct
Поддержка комплексного числа: Да

Ограничения

  • Вы не можете передать эти типы данных ссылкой:

    • Объект класса или Системный объект

    • Массив ячеек или индекс в массив ячеек

  • Если свойство имеет получить метод, метод установки или блоки проверки допустимости, или является свойством Системного объекта с определенными атрибутами, то вы не можете передать свойство в отношении внешней функции. Смотрите Передачу Ссылкой, Не Поддержанной для Некоторых Свойств.

Советы

  • Если arg является массивом, то coder.wref(arg) обеспечивает адрес первого элемента массива. Функция coder.wref(arg) не содержит информацию о размере массива. Если функция C должна знать число элементов ваших данных, передайте ту информацию в качестве отдельного аргумента. Например:

    coder.ceval('myFun',coder.wref(arg),int32(numel(arg));

  • Когда вы передаете структуру в отношении внешней функции C/C++, используйте coder.cstructname, чтобы обеспечить имя типа структуры C, который задан в заголовочном файле C.

  • В MATLAB coder.wref приводит к ошибке. Чтобы параметризовать ваш код MATLAB так, чтобы это могло запуститься в MATLAB и в сгенерированном коде, используйте coder.target.

  • Можно использовать coder.opaque, чтобы объявить переменные, которые вы передаете и от внешней функции C/C++.

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

| | | |

Темы

Введенный в R2011a

Документация Simulink
Поддержка