La traduzione di questa pagina non è aggiornata. Fai clic qui per vedere l'ultima versione in inglese.

API Matrix C

Utilizzare l’API Matrix C per creare programmi C che utilizzano il tipo mxArray per rappresentare i dati di MATLAB

Per scrivere programmi C che lavorano con MATLAB^® R2017b, o release precedenti, utilizzare le funzioni nell’API Matrix C. Queste funzioni lavorano con la struttura di dati mxArray e sono utilizzate per costruire funzioni MEX C o applicazioni engine C.

Nota

Quando possibile, scegliere C++ rispetto alle applicazioni in C.

Esistono due versioni dell'API Matrix C.

L’API complessa interlacciata include le funzionalità dell’API Matrix C a partire da MATLAB R2018a. Per maggiori informazioni, vedere MATLAB Support for Interleaved Complex API in MEX Functions.
L’API complessa separata include le funzionalità dell’API Matrix C a partire da MATLAB R2017b.

Per esempi di utilizzo di queste funzioni di libreria, vedere:

Tables of MEX Function Source Code Examples
Table of MAT-File Source Code Files
Per informazioni esemplificative vedere le singole funzioni. Ad esempio, vedere mxIsChar.

Attenzione

L’API Matrix C non è compatibile con API dei dati di MATLAB per C++, che supporta le feature moderne di C++. Non è possibile utilizzare le funzioni dell’API Matrix C con le funzioni delle API di MATLAB descritte in Scrittura di funzioni C++ chiamabili da MATLAB (file MEX) o Chiamata di MATLAB da C++.

Tipi di dati C

`mxArray`	C type for MATLAB array
`mwSize`	C type for mxArray size values
`mwIndex`	C type for mxArray index values
`mwSignedIndex`	Signed integer C type for mxArray size values
`mxChar`	Type for string array
`mxLogical`	Type for logical array
`mxComplexity`	Flag specifying whether array has imaginary components

Attributi di mxArray

`mxIsNumeric`	Determine whether mxArray is numeric
`mxIsComplex`	Determine whether data is complex
`mxGetNumberOfDimensions`	Number of dimensions in mxArray
`mxGetElementSize`	Number of bytes required to store each data element
`mxGetDimensions`	Pointer to dimensions array
`mxSetDimensions`	Modify number of dimensions and size of each dimension
`mxGetNumberOfElements`	Number of elements in numeric mxArray
`mxCalcSingleSubscript`	Offset from first element to desired element
`mxGetM`	Number of rows in mxArray
`mxSetM`	Set number of rows in mxArray
`mxGetN`	Number of columns in mxArray
`mxSetN`	Set number of columns in mxArray
`mxIsEmpty`	Determine whether mxArray is empty
`mxIsFromGlobalWS`	Determine whether mxArray was copied from MATLAB global workspace

Creazione, query e accesso ai tipi di dati

espandi tutto

Tipi numerici

`mxCreateDoubleMatrix`	2-D, double-precision, floating-point array
`mxCreateDoubleScalar`	Scalar, double-precision array initialized to specified value
`mxCreateNumericMatrix`	2-D numeric matrix
`mxCreateNumericArray`	N-D numeric array
`mxCreateUninitNumericMatrix`	Uninitialized 2-D numeric matrix
`mxCreateUninitNumericArray`	Uninitialized N-D numeric array

In virgola mobile non complessi

`mxIsScalar`	Determine whether array is scalar array
`mxGetScalar`	Real component of first data element in array
`mxIsDouble`	Determine whether mxArray represents data as double-precision, floating-point numbers
`mxGetDoubles`	Real data elements in `mxDOUBLE_CLASS` array
`mxSetDoubles`	Set real data elements in `mxDOUBLE_CLASS` array
`mxIsSingle`	Determine whether mxArray represents data as single-precision, floating-point numbers
`mxGetSingles`	Real data elements in `mxSINGLE_CLASS` array
`mxSetSingles`	Set real data elements in `mxSINGLE_CLASS` array
`mxGetPr`	(Not recommended) Real data elements in `mxDOUBLE_CLASS` array
`mxSetPr`	(Not recommended) Set real data elements in `mxDOUBLE_CLASS` array

Interi non complessi

`mxIsInt8`	Determine whether mxArray represents data as signed 8-bit integers
`mxGetInt8s`	Real data elements in `mxINT8_CLASS` array
`mxSetInt8s`	Set real data elements in `mxINT8_CLASS` array
`mxIsUint8`	Determine whether mxArray represents data as unsigned 8-bit integers
`mxGetUint8s`	Real data elements in `mxUINT8_CLASS` array
`mxSetUint8s`	Set real data elements in `mxUINT8_CLASS` array
`mxIsInt16`	Determine whether mxArray represents data as signed 16-bit integers
`mxGetInt16s`	Real data elements in `mxINT16_CLASS` array
`mxSetInt16s`	Set real data elements in `mxINT16_CLASS` array
`mxIsUint16`	Determine whether mxArray represents data as unsigned 16-bit integers
`mxGetUint16s`	Real data elements in `mxUINT16_CLASS` array
`mxSetUint16s`	Set real data elements in `mxUINT16_CLASS` array
`mxIsInt32`	Determine whether mxArray represents data as signed 32-bit integers
`mxGetInt32s`	Real data elements in `mxINT32_CLASS` array
`mxSetInt32s`	Set real data elements in `mxINT32_CLASS` array
`mxIsUint32`	Determine whether mxArray represents data as unsigned 32-bit integers
`mxGetUint32s`	Real data elements in `mxUINT32_CLASS` array
`mxSetUint32s`	Set real data elements in `mxUINT32_CLASS` array
`mxIsInt64`	Determine whether mxArray represents data as signed 64-bit integers
`mxGetInt64s`	Real data elements in `mxINT64_CLASS` array
`mxSetInt64s`	Set data elements in `mxINT64_CLASS` array
`mxIsUint64`	Determine whether mxArray represents data as unsigned 64-bit integers
`mxGetUint64s`	Real data elements in `mxUINT64_CLASS` array
`mxSetUint64s`	Set real data elements in `mxUINT64_CLASS` array

In virgola mobile complessi

`mxGetComplexDoubles`	Complex data elements in `mxDOUBLE_CLASS` array
`mxSetComplexDoubles`	Set complex data elements in `mxDOUBLE_CLASS` array
`mxGetComplexSingles`	Complex data elements in `mxSINGLE_CLASS` array
`mxSetComplexSingles`	Set complex data elements in `mxSINGLE_CLASS` array
`mxGetImagData`	Imaginary data elements in numeric `mxArray`
`mxSetImagData`	Set imaginary data elements in numeric `mxArray`
`mxGetPi`	(Not recommended) Imaginary data elements in `mxDOUBLE_CLASS` array
`mxSetPi`	(Not recommended) Set imaginary data elements in `mxDOUBLE_CLASS` array

Interi complessi

`mxGetComplexInt8s`	Complex data elements in `mxINT8_CLASS` array
`mxSetComplexInt8s`	Set complex data elements in `mxINT8_CLASS` array
`mxGetComplexUint8s`	Complex data elements in `mxUINT8_CLASS` array
`mxSetComplexUint8s`	Set complex data elements in `mxUINT8_CLASS` array
`mxGetComplexInt16s`	Complex data elements in `mxINT16_CLASS` array
`mxSetComplexInt16s`	Set complex data elements in `mxINT16_CLASS` array
`mxGetComplexUint16s`	Complex data elements in `mxUINT16_CLASS` array
`mxSetComplexUint16s`	Set complex data elements in `mxUINT16_CLASS` array
`mxGetComplexInt32s`	Complex data elements in `mxINT32_CLASS` array
`mxSetComplexInt32s`	Set complex data elements in `mxINT32_CLASS` array
`mxGetComplexUint32s`	Complex data elements in `mxUINT32_CLASS` array
`mxSetComplexUint32s`	Set complex data elements in `mxUINT32_CLASS` array
`mxGetComplexInt64s`	Complex data elements in `mxINT64_CLASS` array
`mxSetComplexInt64s`	Set complex data elements in `mxINT64_CLASS` array
`mxGetComplexUint64s`	Complex data elements in `mxUINT64_CLASS` array
`mxSetComplexUint64s`	Set complex data elements in `mxUINT64_CLASS` array
`mxGetPi`	(Not recommended) Imaginary data elements in `mxDOUBLE_CLASS` array
`mxSetPi`	(Not recommended) Set imaginary data elements in `mxDOUBLE_CLASS` array

Rado

`mxCreateSparse`	2-D sparse array
`mxCreateSparseLogicalMatrix`	2-D, sparse, logical array
`mxIsSparse`	Determine whether input is sparse mxArray
`mxGetNzmax`	Number of elements in IR, PR, and PI arrays
`mxSetNzmax`	Set storage space for nonzero elements
`mxGetIr`	Sparse matrix IR array
`mxSetIr`	IR array of sparse array
`mxGetJc`	Sparse matrix JC array
`mxSetJc`	JC array of sparse array

Tipi non numerici

`mxGetData`	Data elements in nonnumeric `mxArray`
`mxSetData`	Set pointer to data elements in nonnumeric `mxArray`

Carattere

`mxCreateString`	1-D array initialized to specified string
`mxCreateCharMatrixFromStrings`	2-D `mxChar` array initialized to specified value
`mxCreateCharArray`	N-D `mxChar` array
`mxIsChar`	Determine whether input is `mxChar` array
`mxGetChars`	Pointer to character array data

Logico

`mxIsLogical`	Determine whether mxArray is of type `mxLogical`
`mxIsLogicalScalar`	Determine whether scalar array is of type mxLogical
`mxIsLogicalScalarTrue`	Determine whether scalar array of type mxLogical is true
`mxClassID`	Enumerated value identifying class of array
`mxCreateLogicalArray`	N-D logical array
`mxCreateLogicalMatrix`	2-D logical array
`mxCreateLogicalScalar`	Scalar, logical array
`mxGetLogicals`	Pointer to logical array data

Oggetto

`mxIsClass`	Determine whether mxArray is object of specified class
`mxGetClassID`	Class of mxArray
`mxGetClassName`	Class of mxArray as string
`mxSetClassName`	Structure array to MATLAB object array
`mxGetProperty`	Value of public property of MATLAB object
`mxSetProperty`	Set value of public property of MATLAB object

Struttura

`mxCreateStructMatrix`	2-D structure array
`mxCreateStructArray`	N-D structure array
`mxIsStruct`	Determine whether mxArray is structure
`mxGetField`	Pointer to field value from structure array, given index and field name
`mxSetField`	Set field value in structure array, given index and field name
`mxGetNumberOfFields`	Number of fields in structure array
`mxGetFieldNameByNumber`	Pointer to field name from structure array, given field number
`mxGetFieldNumber`	Field number from structure array, given field name
`mxGetFieldByNumber`	Pointer to field value from structure array, given index and field number
`mxSetFieldByNumber`	Set field value in structure array, given index and field number
`mxAddField`	Add field to structure array
`mxRemoveField`	Remove field from structure array

Cella

`mxCreateCellMatrix`	2-D cell array
`mxCreateCellArray`	N-D cell array
`mxIsCell`	Determine whether mxArray is cell array
`mxGetCell`	Pointer to element in cell array
`mxSetCell`	Set contents of cell array

Eliminazione e duplicazione di mxArray

`mxDestroyArray`	Free dynamic memory allocated by MXCREATE* functions
`mxDuplicateArray`	Make deep copy of array

Conversione di mxArray

espandi tutto

Numerico

`mxMakeArrayComplex`	Convert real `mxArray` to complex, preserving real data
`mxMakeArrayReal`	Convert complex `mxArray` to real, preserving real data

Carattere

`mxArrayToString`	Array to string
`mxArrayToUTF8String`	Array to string in UTF-8 encoding
`mxGetString`	`mxChar` array to C-style string or Fortran `character` array

Struttura

mxSetClassName Structure array to MATLAB object array

Gestione della memoria dati

`mxCalloc`	Allocate dynamic memory for array, initialized to 0, using MATLAB memory manager
`mxMalloc`	Allocate uninitialized dynamic memory using MATLAB memory manager
`mxRealloc`	Reallocate dynamic memory using MATLAB memory manager
`mxFree`	Free dynamic memory allocated by mxCalloc, mxMalloc, mxRealloc, mxArrayToString, or mxArrayToUTF8String functions

Asserzioni

`mxAssert`	Check assertion value for debugging purposes
`mxAssertS`	Check assertion value without printing assertion text

Costanti

`mxIsInf`	Determine whether input is infinite
`mxIsFinite`	Determine whether input is finite
`mxIsNaN`	Determine whether input is NaN (Not-a-Number)

Argomenti

Pass Strings in C MEX File
This example shows how to pass strings to a MEX function built with the C Matrix API.
Pass Scalar Values in C MEX File
This example shows how to write a MEX file that passes scalar values.
Handle Sparse Arrays in C MEX File
This example shows how to populate a sparse matrix using the C Matrix API.
Handle 8-, 16-, 32-, and 64-Bit Data in C MEX File
This example shows how to use unsigned 16-bit integers in a MEX file using the C Matrix API.
Pass Structures and Cell Arrays in C MEX File
This example shows how to pass structures and cell arrays to MEX files built with the C Matrix API.
Manipulate Multidimensional Numerical Arrays in C MEX Files
You can manipulate multidimensional numerical arrays by using typed data access functions like mxGetDoubles and mxGetComplexDoubles.

API Matrix C

Tipi di dati C

Attributi di mxArray

Creazione, query e accesso ai tipi di dati

Tipi numerici

In virgola mobile non complessi

Interi non complessi

In virgola mobile complessi

Interi complessi

Rado

Tipi non numerici

Carattere

Logico

Oggetto

Struttura

Cella

Eliminazione e duplicazione di mxArray

Conversione di mxArray

Numerico

Carattere

Struttura

Gestione della memoria dati

Asserzioni

Costanti

Argomenti

Informazioni complementari