NumericArrayQ [expr]
gives True if expr is a valid NumericArray object, and False otherwise.
NumericArrayQ [expr, tpatt]
requires additionally that NumericArrayType [expr] match the pattern tpatt.
NumericArrayQ [expr,tpatt,dpatt]
requires additionally that ArrayDepth [expr] match the pattern dpatt.
NumericArrayQ
NumericArrayQ [expr]
gives True if expr is a valid NumericArray object, and False otherwise.
NumericArrayQ [expr, tpatt]
requires additionally that NumericArrayType [expr] match the pattern tpatt.
NumericArrayQ [expr,tpatt,dpatt]
requires additionally that ArrayDepth [expr] match the pattern dpatt.
Examples
open all close allBasic Examples (2)
A valid NumericArray object:
NumericArrayQ[NumericArray[Range[16], "UnsignedInteger8"]]An expression with head NumericArray that is not a valid byte array object:
NumericArrayQ[NumericArray["abc", "Real32"]]Scope (7)
Include a test for the type:
NumericArrayQ[NumericArray[{1., 2.}, "Real64"], "Real64"]Check to see if the type is a real type:
NumericArrayQ[NumericArray[{1., 2.}, "Real64"], type_ /; StringMatchQ[type, "Real*"]]Check to see if the type is either a machine integer or real type:
NumericArrayQ[RawArray["Complex64", {{1. + 0.*I, 2. + 0.*I}, {3. + 0.*I, 4. + 0.*I}}], "MachineInteger" | "MachineReal"]Include a test for the array depth:
NumericArrayQ[NumericArray[{1., 2.}, "Real64"], _, 2]Allow depth up to 2:
NumericArrayQ[NumericArray[{1., 2.}, "Real64"], _, 1 | 2]Require depth greater than or equal to 2:
NumericArrayQ[NumericArray[{{1, 2}, {3, 4}}, "Integer8"], _, d_ /; d ≥ 2]Constrain both the depth and the number type:
NumericArrayQ[RawArray["Complex64", {{1. + 0.*I, 2. + 0.*I}, {3. + 0.*I, 4. + 0.*I}}], type_ /; StringMatchQ[type, "*Integer*"], d_ /; d ≥ 2]Possible Issues (1)
The default conversion method will fail when the input array contains numbers that are out of range for the specified type.
Try to store in an "Integer8" numeric array:
NumericArray[{-129}, "Integer8"]Use the "ClipAndCoerce" method to automatically clip to the smallest "Integer8" :
NumericArray[{-129}, "Integer8", "ClipAndCoerce"]Related Guides
History
Text
Wolfram Research (2019), NumericArrayQ, Wolfram Language function, https://reference.wolfram.com/language/ref/NumericArrayQ.html.
CMS
Wolfram Language. 2019. "NumericArrayQ." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/NumericArrayQ.html.
APA
Wolfram Language. (2019). NumericArrayQ. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/NumericArrayQ.html
BibTeX
@misc{reference.wolfram_2026_numericarrayq, author="Wolfram Research", title="{NumericArrayQ}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/NumericArrayQ.html}", note=[Accessed: 23-August-2026]}
BibLaTeX
@online{reference.wolfram_2026_numericarrayq, organization={Wolfram Research}, title={NumericArrayQ}, year={2019}, url={https://reference.wolfram.com/language/ref/NumericArrayQ.html}, note=[Accessed: 23-August-2026]}