This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

isnumeric

Determine whether input is numeric array

Syntax

TF = isnumeric(A)

Description

example

TF = isnumeric(A) returns logical 1 (true) if A is an array of numeric data type. Otherwise, it returns logical 0 (false).

Numeric types in MATLAB® include: int8, int16, int32, int64, uint8, uint16, uint32, uint64, single, and double. For more information, see Integer Classes and Floating-Point Numbers.

Examples

collapse all

Determine if a real number is a numeric type.

TF = isnumeric(2)
TF = logical
   1

MATLAB® stores numeric data as a double-precision format by default, which is a numeric type.

Now create a signed 16-bit integer type using int16. Check if it is a numeric type.

TF = isnumeric(int16(-256))
TF = logical
   1

Determine if an array containing infinity or not-a-number values is a numeric type.

Create several calculations that return Inf and assign the results to an array. Check if the array is a numeric type.

A = [1/0 log(0) 1e1000]
A = 1×3

   Inf  -Inf   Inf

TF = isnumeric(A)
TF = logical
   1

MATLAB represents infinity by the special value Inf as a double type.

Create several calculations that return NaN and assign the results to an array. Check if the array is a numeric type.

A = [0/0 -Inf/Inf]
A = 1×2

   NaN   NaN

TF = isnumeric(A)
TF = logical
   1

MATLAB represents not-a-number by the special value NaN, as a double type.

Determine if an array containing floating-point numbers is a numeric type.

A = [-3.5e2 2.5; single(3) pi]
A = 2x2 single matrix

 -350.0000    2.5000
    3.0000    3.1416

TF = isnumeric(A)
TF = logical
   1

Now create a cell array that contains the array A and other numbers. Use class to identify the type of the cell array. Check if it is a numeric type.

B = {A -4; 2 1}
B = 2x2 cell array
    {2x2 single}    {[-4]}
    {[       2]}    {[ 1]}

type = class(B)
type = 
'cell'
TF = isnumeric(B)
TF = logical
   0

The cell array is not a numeric type since it is a cell type.

Input Arguments

collapse all

Input array, specified as a scalar, vector, matrix, or multidimensional array. MATLAB has the following numeric types.

Integer TypeDescription

single

single-precision floating-point

double

double-precision floating-point

int8

8-bit signed integer

int16

16-bit signed integer

int64

64-bit signed integer

int32

32-bit signed integer

uint8

8-bit unsigned integer

uint16

16-bit unsigned integer

uint32

32-bit unsigned integer

uint64

64-bit unsigned integer

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Introduced before R2006a