кодер. Класс CellType

Пакет: кодер
Суперклассы: coder.ArrayType

Представляйте набор массивов ячеек MATLAB

Описание

Задает набор массивов ячеек, которые принимает сгенерированный код. Используйте только с опцией -args fiaccel. Не передавайте как вход сгенерированной MEX-функции.

Конструкция

t = coder.typeof(cells) создает объект coder.CellType для массива ячеек, который имеет те же ячейки и типы ячейки как cells. Ячейки в cells являются значениями в качестве примера или текстовыми объектами.

t = coder.typeof(cells, sz, variable_dims) создает объект coder.CellType, которому задали верхние границы sz и переменные размерности, заданные variable_dims. Если sz задает inf для размерности, то размер размерности неограничен, и размерность является переменным размером. Когда sz является [], верхние границы не изменяются. Если вы не задаете параметр входа variable_dims, за исключением неограниченных размерностей, размерности типа фиксируются. Скалярный variable_dims применяется к ограниченным размерностям, которые не являются 1 или 0.

Когда cells задает массив ячеек, элементы которого имеют различные классы, вы не можете использовать coder.typeof, чтобы создать объект coder.CellType для массива ячеек переменного размера.

t = coder.newtype(cells) создает объект coder.CellType для массива ячеек, который имеет ячейки и типы ячейки, заданные cells. Ячейки в cells должны быть текстовыми объектами.

t = coder.newtype(cell_array, sz, variable_dims) создает coder.CellType, которому задали верхние границы sz и переменные размерности, заданные variable_dims. Если sz задает inf для размерности, то размер размерности неограничен, и размерность является переменным размером. Когда sz является [], верхние границы не изменяются. Если вы не задаете параметр входа variable_dims, за исключением неограниченных размерностей, размерности типа фиксируются. Скалярный variable_dims применяется к ограниченным размерностям, которые не являются 1 или 0.

Когда cells задает массив ячеек, элементы которого имеют различные классы, вы не можете использовать coder.newtype, чтобы создать объект coder.CellType для массива ячеек переменного размера.

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

развернуть все

Массив ячеек, который задает ячейки и типы ячейки для объекта вывода coder.CellType. Для coder.typeof cells может содержать значения в качестве примера или текстовые объекты. Для coder.newtype cells должен содержать текстовые объекты.

Задает верхнюю границу для каждой размерности текстового объекта массива ячеек. Для coder.newtype sz не может изменить количество ячеек для неоднородного массива ячеек.

Для coder.newtype значением по умолчанию является [1 1].

Задает, является ли каждая размерность переменным размером (TRUE) или (FALSE) фиксированный размер.

Для coder.newtype значением по умолчанию является true для размерностей, для которых sz задает верхнюю границу inf и false для всех других размерностей.

Когда cells задает массив ячеек, элементы которого имеют различные классы, вы не можете создать объект coder.CellType для массива ячеек переменного размера.

Свойства

развернуть все

Массив ячеек, который задает coder.Type каждой ячейки.

Класс значений в этом наборе.

Верхние границы размерностей массива ячеек.

Вектор, который задает, фиксируется ли каждая размерность массива или переменный размер. Если векторным элементом является true, соответствующая размерность является переменным размером.

Методы

isHeterogeneousОпределите, представляет ли тип массива ячеек неоднородный массив ячеек
isHomogeneousОпределите, представляет ли тип массива ячеек гомогенный массив ячеек
makeHeterogeneousСделайте неоднородную копию типа массива ячеек
makeHomogeneousСоздайте гомогенную копию типа массива ячеек

Копировать семантику

Значение. Чтобы изучить, как классы значения влияют на операции копии, смотрите Копирование Объектов (MATLAB).

Примеры

свернуть все

Создайте тип для массива ячеек, первый элемент которого имеет char класса и чей второй элемент имеет класс дважды.

t = coder.typeof({1 2 3})
t = 

coder.CellType
   1x3 homogeneous cell 
      base: 1x1 double

Тип является гомогенным.

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

t = makeHeterogeneous(coder.typeof({1 2 3}))
t = 

coder.CellType
   1×3 locked heterogeneous cell 
      f1: 1×1 double
      f2: 1×1 double
      f3: 1×1 double

Тип массива ячеек неоднороден. Это представлено как структура в сгенерированном коде.

Задайте переменные, которые являются значениями ячеек в качестве примера.

a = 'a';
b = 1;

Передайте значения ячеек в качестве примера coder.typeof.

t = coder.typeof({a, b})
t = 

coder.CellType
   1x2 heterogeneous cell 
      f0: 1x1 char
      f1: 1x1 double

Создайте тип для массива ячеек, который содержит два вектора символов, которые имеют различные размеры.

t = coder.typeof({'aa', 'bbb'})
t = 

coder.CellType
   1x2 heterogeneous cell 
      f0: 1x2 char
      f1: 1x3 char

Тип массива ячеек неоднороден.

Создайте тип с помощью того же входа массива ячеек. На этот раз укажите, что тип массива ячеек имеет размерности переменного размера.

t = coder.typeof({'aa','bbb'},[1,10],[0,1])
t = 

coder.CellType
   1×:10 locked homogeneous cell 
      base: 1×:3 char

Тип массива ячеек является гомогенным. coder.typeof решил, что базовый тип 1x:3 char может представлять 'aa' и 'bbb'.

Создайте тип для скалярного int8.

ta = coder.newtype('int8',[1 1]);

Создайте тип для:1x:2 двойной вектор - строка.

tb = coder.newtype('double',[1 2],[1 1]);

Создайте тип массива ячеек, ячейкам которого задали типы ta и ta.

t = coder.newtype('cell',{ta,tb})
t = 

coder.CellType
   1x2 heterogeneous cell 
      f0: 1x1 int8
      f1: :1x:2 double

Советы

  • В отображении объекта coder.CellType условия locked heterogeneous или locked homogeneous указывают, что классификация как гомогенная или неоднородная является постоянной. Вы не можете позже изменить классификацию при помощи методов makeHeterogeneous или makeHomogeneous.

  • coder.typeof определяет, является ли тип массива ячеек гомогенным или неоднородным. Если элементы массива ячеек имеют тот же класс и размер, coder.typeof возвращает гомогенный тип массива ячеек. Если элементы имеют различные классы, coder.typeof возвращает неоднородный тип массива ячеек. Для некоторых массивов ячеек классификация как гомогенная или неоднородная неоднозначна. Например, тип для {1 [2 3]} может быть 1x2 неоднородный тип. Первый элемент является двойным, и второй элемент 1x2 дважды. Тип может также быть 1x3 гомогенный тип, в котором элементы имеют класс дважды и размер 1x:2. Для этих неоднозначных случаев coder.typeof использует эвристику, чтобы классифицировать тип как гомогенный или неоднородный. Если вы хотите различную классификацию, используйте методы makeHeterogeneous или makeHomogeneous. Метод makeHomogeneous делает гомогенную копию типа. Метод makeHeterogeneous делает неоднородную копию типа.

    makeHomogeneous и методы makeHeterogeneous постоянно присваивают классификацию как гомогенную и неоднородную, соответственно. Вы не можете дальнейшее использование один из этих методов, чтобы создать копию, которая имеет различную классификацию.

Введенный в R2015b