Правила преобразования данных

Эта тема описывает правила преобразования данных для компонентов MATLAB^® Compiler™. Этими компонентами являются двойные интерфейсные COM-объекты Microsoft^®, которые поддерживают типы данных, совместимые с Автоматизацией.

Примечание

Automation (раньше названная Автоматизация OLE) является технологией, которая позволяет пакетам программного обеспечения представлять свои уникальные функции сценариям инструментов и других приложений. Автоматизация использует Объектную модель программных компонентов (COM), но может быть реализована независимо от других функций OLE, таких как активизация "на месте".

Когда метод вызывается на компонент MATLAB Compiler, входные параметры преобразованы в формат внутреннего массива MATLAB и переданы скомпилированной функции MATLAB. Когда функция выходит, выходные параметры преобразованы от формата внутреннего массива MATLAB до типов Автоматизации COM.

COM-клиент передает все аргументы ввода и вывода в скомпилированных функциях MATLAB как тип VARIANT. Тип VARIANT COM является объединением нескольких простых типов данных. Переменная VARIANT типа может сохранить переменную любого из простых типов, а также массивов любого из этих значений.

Прикладной программный интерфейс (API) Win32 обеспечивает много функций для создания и управления VARIANT s на C/C++, и Визуальный Basic^® оказывает поддержку родного языка для этого типа.

Примечание

Это обсуждение данных относится к VARIANT и к типам данных Variant. VARIANT является именем C++, и Variant является соответствующим типом данных в Visual Basic.

См. Визуальную документацию Studio^® для определений и поддержку API VARIANT COM s. переменные VARIANT являются сам описание и хранят свой код типа как внутреннее поле структуры.

В следующей таблице перечислены коды типа VARIANT, поддержанные компонентами MATLAB Compiler.

Поддерживаемые коды типа VARIANT

Код типа `VARIANT` (C/C++)	Тип C/C++	Код типа `Variant` (Visual Basic)	Визуальный BasicType	Определение
`VT_EMPTY`	`—`	`vbEmpty`	`—`	Неинициализированный `VARIANT`
`VT_I1`	`char`	`—`	`—`	Однобайтовый символ со знаком
`VT_UI1`	`char` без знака	`vbByte`	`Byte`	Однобайтовый символ без знака
`VT_I2`	`short`	`vbInteger`	`Integer`	Целое число 2D байта со знаком
`VT_UI2`	`unsigned short`	—	—	Целое число 2D байта без знака
`VT_I4`	`long`	`vbLong`	`Long`	Четырехбайтовое целое число со знаком
`VT_UI4`	`unsigned long`	—	—	Четырехбайтовое целое число без знака
`VT_R4`	`float`	`vbSingle`	`Single`	IEEE^® четырехбайтовое значение с плавающей точкой
`VT_R8`	`double`	`vbDouble`	`Double`	IEEE восьмибайтовое значение с плавающей точкой
`VT_CY`	`CY` ⁺	`vbCurrency`	`Currency`	Значение валюты (64-битное целое число, масштабируемое 10 000)
`VT_BSTR`	`BSTR` ⁺	`vbString`	`String`	Представьте значение в виде строки
`VT_ERROR`	`SCODE` ⁺	`vbError`	—	`HRESULT` (подписал четырехбайтовое целое число, представляющее код ошибки COM),
`VT_DATE`	`DATE` ⁺	`vbDate`	`Date`	Восьмибайтовое значение с плавающей точкой, представляющее дату и время
`VT_INT`	`int`	—	—	Целое число со знаком; эквивалентный, чтобы ввести `int`
`VT_UINT`	`unsigned int`	—	—	Беззнаковое целое; эквивалентный, чтобы ввести `unsigned int`
`VT_DECIMAL`	`DECIMAL` ⁺	`vbDecimal`	—	96-битное (12-байтовое) беззнаковое целое, масштабируемое переменной мощностью 10
`VT_BOOL`	`VARIANT_BOOL` ⁺	`vbBoolean`	`Boolean`	Булево значение 2D байта (0xFFFF = Верный; 0x0000 = Ложь)
`VT_DISPATCH`	`IDispatch*`	`vbObject`	`Object`	Указатель `IDispatch*` на объект
`VT_VARIANT`	`VARIANT` ⁺	`vbVariant`	`Variant`	`VARIANT` (может только быть задан, если объединено с `VT_BYREF` или `VT_ARRAY`),
<anything`>\|VT_ARRAY`	—	—	—	Поразрядно объедините `VT_ARRAY` с любым основным типом, чтобы объявить как массив
<anything`>\|VT_BYREF`	—	—	—	Поразрядно объедините `VT_BYREF` с любым основным типом, чтобы объявить как ссылка на значение
⁺Обозначает специфичный для Windows тип. Не часть стандартного C/C++.

В следующей таблице перечислены правила для преобразования от MATLAB до COM.

MATLAB к правилам преобразования COM VARIANT

Тип данных MATLAB	Тип `VARIANT` для скалярных данных	Тип `VARIANT` для данных массива	Комментарии
`cell`	Массив ячеек 1 на 1 преобразовывает в один `VARIANT` с типом, соответствующим правилу преобразования для типа данных MATLAB содержимого ячейки.	Многомерный массив ячеек преобразовывает в `VARIANT` типа `VT_VARIANT\|VT_ARRAY` с типом каждого участника массивов, соответствующего правилу преобразования для типа данных MATLAB соответствующей ячейки.
`structure`	`VT_DISPATCH`	`VT_DISPATCH`	Массив `struct` MATLAB преобразован в объект `MWStruct`. (См. Класс MWStruct (MATLAB Compiler SDK)), Этот объект передается как тип `VT_DISPATCH`.
`char`	Матрица `char` 1 на 1 преобразовывает в `VARIANT` типа `VT_BSTR` с длиной строки = 1.	1 L матрицей `char` принят, чтобы представлять вектор символов длины L в MATLAB. Этот случай преобразовывает в `VARIANT` типа `VT_BSTR` с длиной строки = L. матрицы `char` больше чем одной строки, или более высокой размерности преобразовывают в `VARIANT` типа `VT_BSTR\|VT_ARRAY`. Каждая строка в конвертированном массиве имеет длину 1 и соответствует каждому символу в исходной матрице.	Массивы векторов символов не поддержаны как матрицы `char`. Чтобы передать массив векторов символов, используйте массив ячеек 1 L матрицами `char`.
`sparse`	`VT_DISPATCH`	`VT_DISPATCH`	Разреженный массив MATLAB преобразован в объект `MWSparse`. (См. Класс MWSparse (MATLAB Compiler SDK)), Этот объект передается как тип `VT_DISPATCH`.
`double`	Действительная двойная матрица 1 на 1 преобразовывает в `VARIANT` типа `VT_R8`. Комплекс 1 на 1 удваивается, матрица преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Действительная многомерная двойная матрица преобразовывает в `VARIANT` типа `VT_R8\|VT_ARRAY`. Комплексная многомерная двойная матрица преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Комплексные массивы передаются и от скомпилированных функций MATLAB с помощью класса `MWComplex`. (См. Класс MWComplex),
`single`	Действительная одна матрица 1 на 1 преобразовывает в `VARIANT` типа `VT_R4`. Комплекс 1 на 1 одна матрица преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Действительная многомерная одна матрица преобразовывает в `VARIANT` типа `VT_R4\|VT_ARRAY`. Комплексная многомерная одна матрица преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Комплексные массивы передаются и от скомпилированных функций MATLAB с помощью класса `MWComplex`. (См. Класс MWComplex),
`int8`	Действительная матрица `int8` 1 на 1 преобразовывает в `VARIANT` типа `VT_I1`. Комплексная матрица `int8` 1 на 1 преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Действительная многомерная матрица `int8` преобразовывает в `VARIANT` типа V`T_I1\|VT_ARRAY`. Комплексная многомерная матрица `int8` преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Комплексные массивы передаются и от скомпилированных функций MATLAB с помощью класса `MWComplex`. (См. Класс MWComplex),
`uint8`	Действительная матрица `uint8` 1 на 1 преобразовывает в `VARIANT` типа `VT_UI1`. Комплексная матрица `uint8` 1 на 1 преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Действительная многомерная матрица `uint8` преобразовывает в `VARIANT` типа`, VT_UI1\|VT_ARRAY`.A объединяет многомерную матрицу `uint8`, преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Комплексные массивы передаются и от скомпилированных функций MATLAB с помощью класса `MWComplex`. (См. Класс MWComplex),
`int16`	Действительная матрица `int16` 1 на 1 преобразовывает в `VARIANT` типа `VT_I2`. Комплексная матрица `int16` 1 на 1 преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Действительная многомерная матрица `int16` преобразовывает в `VARIANT` типа `VT_I2\|VT_ARRAY`. Комплексная многомерная матрица `int16` преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Комплексные массивы передаются и от скомпилированных функций MATLAB с помощью класса `MWComplex`. (См. Класс MWComplex),
`uint16`	Действительная матрица `uint16` 1 на 1 преобразовывает в `VARIANT` типа `VT_UI2`. Комплексная матрица `uint16` 1 на 1 преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Действительная многомерная матрица `uint16` преобразовывает в `VARIANT` типа `VT_UI2\|VT_ARRAY`. Комплексная многомерная матрица `uint16` преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Комплексные массивы передаются и от скомпилированных функций MATLAB с помощью класса `MWComplex`. (См. Класс MWComplex),
`int32`	Матрица `int32` 1 на 1 преобразовывает в `VARIANT` типа `VT_I4`. Комплексная матрица `int32` 1 на 1 преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Многомерная матрица `int32` преобразовывает в `VARIANT` типа `VT_I4\|VT_ARRAY`. Комплексная многомерная матрица `int32` преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Комплексные массивы передаются и от скомпилированных функций MATLAB с помощью класса `MWComplex`. (См. Класс MWComplex),
`uint32`	Матрица `uint32` 1 на 1 преобразовывает в `VARIANT` типа `VT_UI4`. Комплексная матрица `uint32` 1 на 1 преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Многомерная матрица `uint32` преобразовывает в `VARIANT` типа `VT_UI4\|VT_ARRAY`. Комплексная многомерная матрица `uint32` преобразовывает в `VARIANT` типа `VT_DISPATCH`.	Комплексные массивы передаются и от скомпилированных функций MATLAB с помощью класса `MWComplex`. (См. Класс MWComplex),
Указатель на функцию	`VT_EMPTY`	`VT_EMPTY`	Не поддерживаемый
Класс Java^®	`VT_EMPTY`	`VT_EMPTY`	Не поддерживаемый
Пользовательский класс	`VT_EMPTY`	`VT_EMPTY`	Не поддерживаемый
логический	`VT_Bool`	`VT_Bool\|VT_ARRAY`

В следующей таблице перечислены правила для преобразования от COM до MATLAB.

ВАРИАНТ COM к правилам преобразования MATLAB

Тип `VARIANT`	Тип данных MATLAB (скалярные или данные массива)	Комментарии
`VT_EMPTY`	Не применяется	Пустой массив создается.
`VT_I1`	`int8`
`VT_UI1`	`uint8`
`VT_I2`	`int16`
`VT_UI2`	`uint16`
`VT_I4`	`int32`
`VT_UI4`	`uint32`
`VT_R4`	`single`
`VT_R8`	`double`
`VT_CY`	`double`
`VT_BSTR`	`char`	`VARIANT` типа `VT_BSTR` преобразовывает в 1 L MATLAB массив `char`, где L = длина вектора символов, который будет преобразован. `VARIANT` типа `VT_BSTR\|VT_ARRAY` преобразовывает в массив ячеек MATLAB 1 L массивами `char`.
`VT_ERROR`	`int32`
`VT_DATE`	`double`	1. даты `VARIANT` хранятся, как удваивает запуск в полночь 31 декабря 1899. Даты MATLAB хранятся, как удваивает запуск в 0/0/00 0:00:00. Поэтому дата `VARIANT` 0,0 карт к MATLAB числовая дата 693 960,0. даты `VARIANT` преобразованы в MATLAB двойные типы и постепенно увеличены 693 960,0. 2. даты `VARIANT` могут быть опционально преобразованы в векторы символов. Смотрите Флаги Преобразования Данных для получения дополнительной информации о приведении типа.
`VT_INT`	`int32`
`VT_UINT`	`uint32`
`VT_DECIMAL`	`double`
`VT_BOOL`	`logical`
`VT_DISPATCH`	(отличается)	Указатели `IDispatch*` обработаны в контексте того, на что они указывают. Объекты должны поддерживаться типы с известной экстракцией данных и правилами преобразования, или представить типичное свойство `Value`, которое указывает на один тип `VARIANT`. Данные, извлеченные от объекта, преобразованы основанные на правилах для конкретного полученного `VARIANT`. В настоящее время поддержка существует для объектов Excel^® `Range`, а также MATLAB Compiler вводит `MWStruct`, `MWComplex`, `MWSparse` и `MWArg`.
<anything`>\|VT_BYREF`	(отличается)	Указатели на любой из основных типов обрабатываются согласно правилам для того, на что они указывают. Получившийся массив MATLAB содержит глубокую копию значений.
<anything`>\|VT_ARRAY`	(отличается)	Многомерные массивы `VARIANT` преобразовывают в многомерные массивы MATLAB, каждый элемент, преобразованный согласно правилам для основных типов. Многомерные массивы `VARIANT` типа `VT_VARIANT\|VT_ARRAY` преобразовывают в многомерные массивы ячеек, каждая ячейка, преобразованная согласно правилам для того определенного типа.

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