Exponenta Banner

coder.wref

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

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

Синтаксис

coder.wref(arg)

Описание

пример

coder.wref(arg) указывает на тот arg выражение только для записи или переменная, чтобы передать в отношении внешней функции C/C++. Использование coder.wref только внутри a 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

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

Поддержка