NET.convertArray

(Not recommended) Convert numeric MATLAB array to .NET array

NET.convertArray is not recommended. MATLAB^® automatically converts arrays to .NET types. For information, see Version History.

Syntax

arrObj = NET.convertArray(V,arrType,[m,n,p,...])

arrObj = NET.convertArray(V,arrType,m,n,p,...)

Description

arrObj = NET.convertArray(V,arrType,[m,n,p,...]) converts a MATLAB array to a .NET array of type arrType. If you do not specify arrType, then MATLAB converts the array according to the MATLAB Primitive Type Conversion Table. See Pass Primitive .NET Types. To convert a MATLAB vector to a two-dimensional .NET array (either 1-by-n or m-by-1), use optional values m,n,p,.... If V is a MATLAB vector and you do not specify the number of dimensions and their sizes, then arrObj is a one-dimensional .NET array.

arrObj = NET.convertArray(V,arrType,m,n,p,...) is an alternative syntax for converting an array.

Examples

Sort List of Random Integers

Create a list L of random System.Int32 integers using the System.Collections.Generic.List class, and then sort the results.

% Create array R of random integers
nInt = 5;
R = randi(100,1,nInt);
% Create .NET array A
A = NET.convertArray(R,'System.Int32');
% Put A into L, a generic collections list
L = NET.createGeneric('System.Collections.Generic.List',{'System.Int32'},A.Length);
L.AddRange(A)
% Sort the values in L
L.Sort

Input Arguments

V — MATLAB array

numeric MATLAB type

MATLAB array, specified as a valid numeric MATLAB type.

arrType — .NET array type

string | character vector

.NET array type, specified as a string or a character vector. The name includes a namespace.

Example: 'System.Int32'

m,n,p,... — Number of elements in each dimension

array of integers

Number of elements in each dimension, specified as an array of integers.

Output Arguments

arrObj — .NET array

numeric .NET type

Version History

Introduced in R2009a

R2011b: Support for Auto-Conversion of Multidimensional Arrays

You can pass MATLAB arrays directly to .NET without explicitly converting them into .NET arrays. MATLAB also converts an array of a lower dimensionality to a higher dimensionality .NET array. For more information, see Use Arrays with .NET Applications.

In most cases, you no longer need to use the NET.convertArray function. Review your MATLAB code to update the use of this function.

If you continue to use NET.convertArray, note the following change of behavior for empty matrices:

• If you call NET.convertArray with an N-D empty matrix and try to convert it to 1-D .NET array, MATLAB throws the following error:

  Source and destination array dimension sizes do not match.

• Different results for:

  NET.convertArray(rand(0,1,1))

  As of R2011a, MATLAB creates a System.Double[,]. In R2011b, MATLAB creates a System.Double[].