WOLFRAM

Wolfram Language & System Documentation Center

"NumericArray" (Compiled Type)

"NumericArray"::[type,rank]

represents a numeric array type with elements of specified type and rank.

Details

  • "NumericArray" can be used in Typed and related constructs to specify a type.
  • "NumericArray" objects are automatically memory managed.
  • "NumericArray" objects support the same element types as NumericArray.

Constructors

  • NumericArray[{…},type] creates a numeric array with the specified element type.
  • CreateTypeInstance["NumericArray"::[type,rank],array] constructs a copy of array.
  • CreateTypeInstance["NumericArray"::[type,1],carr,len] constructs a numeric array from a "CArray" carr with length len. carr can optionally be wrapped in "Managed".

Properties

  • Information[array,"ElementType"] for array of type "NumericArray"::[type,rank] gives type .

Conversions

    Expressions

  • "NumericArray" objects can be converted to and from NumericArray expressions.

    • "ListVector"

  • "NumericArray" objects can be converted to and from "ListVector" objects.

Runtime Errors

    ArrayPartError

  • Elements with types constructed from "NumericArray" can give a runtime error if used in an operation that extracts parts.

Examples

open all close all

Basic Examples  (2)

"NumericArray" can be used as an input and output from a CompiledCodeFunction.

Wolfram Language code: cf = FunctionCompile[Function[Typed[arg, TypeSpecifier["NumericArray"]["Integer64", 1]], arg]]
Wolfram Language code: cf[NumericArray[{1, 2, 3, 2}, "Integer64"]]

Compile a function that returns a "NumericArray":

Wolfram Language code: cf = FunctionCompile[Function[{}, NumericArray[{1, 2, 3, 4}, "Integer16"]]]
Wolfram Language code: cf[]

Use Normal to convert the "NumericArray" to a list:

Wolfram Language code: Normal[cf[]]

Possible Issues  (1)

Part access can cause an error while running the function. The computation is terminated, a message is issued and the Wolfram Engine is used to compute the result:

Wolfram Language code: cf = FunctionCompile[Function[Typed[arg, TypeSpecifier["NumericArray"]["Integer64", 1]], arg[[5]]]]; cf[NumericArray[{1, 2, 3, 2}, "Integer64"]]