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

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

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

Примечание

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

Внимание

Следует иметь в виду, что IIS (интернет-Информационная служба) обычно предотвращает большую часть автоматизации COM на основании, что это может изложить угрозу безопасности. Поэтому XLSREAD и другие услуги по Автоматизации могут перестать работать, когда подается IIS, ведя к ошибкам, таким как object reference not set.

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

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

Win32 API обеспечивает много функций для создания и управления VARIANTs на C/C++ и Microsoft^® Visual Basic^® оказывает поддержку родного языка для этого типа. См. документацию Microsoft Visual Studio^® для определений и поддержку API VARIANT COMs. VARIANT переменные являются сам описание и хранят свой код типа как внутреннее поле структуры.

Примечание

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

См. Коды Типа ВАРИАНТА, Поддержанные для списка VARIANT введите коды, поддержанные компонентами компилятора.

Смотрите MATLAB к Правилам Преобразования ВАРИАНТА COM и ВАРИАНТУ COM к Правилам Преобразования MATLAB для правил преобразования между VARIANT COMs и массивы MATLAB.

Поддерживаемые коды типа ВАРИАНТА

Код типа ВАРИАНТА (C/C++)	Тип C/C++	Различный код типа (Visual Basic)	Тип Visual Basic	Определение
`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	Тип ВАРИАНТА для скалярных данных	Тип ВАРИАНТА для данных массива	Комментарии
`cell`	Массив ячеек 1 на 1 преобразует в один `VARIANT` с типом, соответствующим преобразованию, управляют для типа данных MATLAB содержимого ячейки.	Многомерный массив ячеек преобразует в `VARIANT` из типа `VT_VARIANT\|VT_ARRAY` с типом каждого члена массивов, соответствующего преобразованию, управляют для типа данных MATLAB соответствующей ячейки.
`structure`	`VT_DISPATCH`	`VT_DISPATCH`	`struct` MATLAB массив преобразован в `MWStruct` объект. (См. Класс MWStruct.) Этот объект передается как `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.) Этот объект передается как `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` класс.
`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` класс.
`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` класс.
`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` класс.
`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` класс.
`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` класс.
`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` класс.
Указатель на функцию	`VT_EMPTY`	`VT_EMPTY`	Не поддерживаемый
Класс Java^®	`VT_EMPTY`	`VT_EMPTY`	Не поддерживаемый
Пользовательский класс	`VT_EMPTY`	`VT_EMPTY`	Не поддерживаемый
логический	`VT_Bool`	`VT_Bool\|VT_ARRAY`

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

Тип ВАРИАНТА	Тип данных 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`	`VARIANT` даты хранятся, как удваивает запуск в полночь 31 декабря 1899. Даты MATLAB хранятся, как удваивает запуск в 0/0/00 0:00:00. Поэтому `VARIANT` дата 0,0 карт к MATLAB числовая дата 693 960,0. `VARIANT` даты преобразованы в MATLAB двойные типы и постепенно увеличены 693 960,0. `VARIANT` даты могут быть опционально преобразованы в строки. Смотрите Флаги Преобразования Данных для получения дополнительной информации о приведении типа.
`VT_INT`	`int32`
`VT_UINT`	`uint32`
`VT_DECIMAL`	`double`
`VT_BOOL`	`logical`
`VT_DISPATCH`	`Varies`	`IDispatch*` указатели обработаны в контексте того, на что они указывают. Объекты должны поддерживаться типы с известной экстракцией данных и правилами преобразования, или отсоединить типовой `Value` свойство, которое указывает на один `VARIANT` ввод. Данные, извлеченные из объекта, преобразованы на основе правил для конкретного `VARIANT` полученный. В настоящее время поддержка существует для Excel^® `Range` объекты, а также типы `MWStruct`, `MWComplex`, `MWSparse`, и `MWArg`. Смотрите Ссылочные Служебные Классы для получения информации о типах, чтобы использовать с COM-компонентами.
`anything``\|VT_BYREF`	`Varies`	Указатели на любой из основных типов обрабатываются согласно правилам для того, на что они указывают. Получившийся массив MATLAB содержит глубокую копию значений.
`anything``\|VT_ARRAY`	`Varies`	Многомерный `VARIANT` массивы преобразуют в многомерные массивы MATLAB, каждый элемент, преобразованный согласно правилам для основных типов. Многомерный `VARIANT` массивы типа `VT_VARIANT\|VT_ARRAY` преобразуйте в многомерные массивы ячеек, каждая ячейка, преобразованная согласно правилам для того определенного типа.

Флаги форматирования массивов

Компоненты имеют флаги, которые управляют, как данные массива отформатированы в обоих направлениях. Обычно необходимо разработать клиентский код, который совпадает с намеченными вводами и выводами функций MATLAB с соответствующими методами на скомпилированных COM-объектах, в соответствии с правилами, перечисленными в MATLAB к Правилам Преобразования ВАРИАНТА COM и ВАРИАНТУ COM к Правилам Преобразования MATLAB. В некоторых случаях это не возможно, например, когда существующий код MATLAB используется в сочетании со сторонним продуктом как Excel.

Следующая таблица показывает флаги форматирования массивов.

Флаги форматирования массивов

Флаг	Описание
`InputArrayFormat`	Задает правило форматирования массивов, использованное на входных массивах. Входным массивом является `VARIANT` массив, созданный клиентом, отправленным как входной параметр в вызов метода на скомпилированном COM-объекте. Допустимыми значениями для этого флага является `mwArrayFormatAsIs`, `mwArrayFormatMatrix`, и `mwArrayFormatCell`. `mwArrayFormatAsIs` передает неизменный массив. `mwArrayFormatMatrix` форматы (по умолчанию) все массивы как матрицы. Когда вход `VARIANT` имеет тип `VT_ARRAY`\| `type`, где `type` любой числовой тип, этот флаг не оказывает влияния. Когда вход `VARIANT` имеет тип `VT_VARIANT\|VT_ARRAY`, `VARIANT`s в массиве исследованы. Если они являются однозначными и гомогенными в типе, матрица MATLAB соответствующего типа производится вместо массива ячеек. `mwArrayFormatCell` интерпретирует все массивы как массивы ячеек MATLAB.
`InputArrayIndFlag`	Устанавливает косвенный уровень входного массива, используемый с `InputArrayFormat` флаг (применимый только к вложенным массивам, т.е. `VARIANT` массивы `VARIANT`s, которые самостоятельно являются массивами). Значением по умолчанию для этого флага является нуль, который применяет `InputArrayFormat` отметьте к наиболее удаленному массиву. Когда этот флаг больше нуля, e.g., равный N, правило форматирования пытается применить себя к Энному уровню вложения.
`OutputArrayFormat`	Задает правило форматирования массивов, использованное на выходных массивах. Выходной массив является массивом MATLAB, созданным скомпилированным COM-объектом, отправленным как выходной параметр от вызова метода до клиента. Значения для этого флага, `mwArrayFormatAsIs`, `mwArrayFormatMatrix`, и `mwArrayFormatCell`, вызовите то же поведение как соответствующий `InputArrayFormat` флаговые значения.
`OutputArrayIndFlag`	(Применяется к вложенным массивам ячеек только.) Косвенный уровень выходного массива используется с `OutputArrayFormat` флаг. Этот флаг работает точно как `InputArrayIndFlag`.
`AutoResizeOutput`	(Применяется к областям значений Excel только.), Когда целевой выход от вызова метода является областью значений ячеек в рабочем листе Excel и размере выходного массива и форме, не известен во время вызова, установите этот флаг на `True` изменить размер каждой области значений Excel, чтобы соответствовать выходному массиву.
`TransposeOutput`	Установите этот флаг на `True` транспонировать выходные аргументы. Полезный при вызове компонента от Excel, где функция MATLAB возвращает выходные параметры как векторы-строки, и вы хотите данные в столбцах.

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

Компоненты MATLAB Compiler SDK содержат флаги, чтобы управлять преобразованием определенного VARIANT типы к типам MATLAB. Эти флаги следующие:

CoerceNumericToType
InputDateFormat
OutputAsDate как булевская переменная
DateBias как долго

CoerceNumericToType

Этот флаг говорит преобразователю данных преобразовывать весь числовой VARIANT данные к одному определенному типу MATLAB. VARIANT кодами типа, затронутыми этим флагом, является VT_I1, VT_UI1, VT_I2, VT_UI2, VT_I4, VT_UI4, VT_R4, VT_R8, VT_CY, VT_DECIMAL, VT_INT, VT_UINT, VT_ERROR, VT_BOOL, и VT_DATE. Допустимыми значениями для этого флага является mwTypeDefault, mwTypeChar, mwTypeDouble, mwTypeSingle, mwTypeLogical, mwTypeInt8, mwTypeUint8, mwTypeInt16, mwTypeUint16, mwTypeInt32, и mwTypeUint32.

Значение по умолчанию для этого флага, mwTypeDefault, преобразует числовые данные согласно правилам, перечисленным в Преобразовании Данных.

InputDateFormat

Этот флаг говорит преобразователь данных, как преобразовать VARIANT даты на даты MATLAB. Допустимыми значениями для этого флага является mwDateFormatNumeric (значение по умолчанию) и mwDateFormatString. Значение по умолчанию преобразует VARIANT даты согласно правилу, перечисленному в Поддерживаемых Кодах Типа ВАРИАНТА. mwDateFormatString отметьте преобразует VARIANT дата к ее строковому представлению. Этот флаг только влияет на VARIANT введите код VT_DATE.

OutputAsDate как булевская переменная

Этот флаг дает преобразователю данных команду обрабатывать выходной аргумент как дату. По умолчанию числовые даты, которые являются выходными параметрами от скомпилированных функций MATLAB, передаются как Doubles, который должен быть постепенно уменьшен смещением даты COM (693960), а также принужден на даты COM. Установите этот флаг на True преобразовывать все выходные значения типа Double.

DateBias как долго

Этот флаг устанавливает смещение даты для выполнения COM к MATLAB числовые преобразования даты. Значение по умолчанию этого свойства 693960, который представляет различие между Date COM тип и MATLAB числовые даты. Этот флаг позволяет существующий код MATLAB, который уже выполняет шаг числовых дат 693 960, чтобы использоваться неизменный с компонентами. На даты процесса с таким кодом, набор это свойство к 0.

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