Main Content

allfinite

Determine if all array elements are finite

Since R2022a

Description

example

TF = allfinite(A) returns logical 1 (true) if all elements of A are finite. It returns 0 (false) if any element is not finite.

If A contains complex numbers, allfinite(A) returns 1 if all elements have finite real and imaginary parts, and 0 otherwise.

Examples

collapse all

Create a row vector and determine if all elements are finite.

A = 1./[-2 -1 1e-23 0.1]
A = 1×4
1023 ×

   -0.0000   -0.0000    1.0000    0.0000

TF = allfinite(A)
TF = logical
   1

Create another row vector and determine if all elements are finite.

B = 0./[-2 -1 0 0.1]
B = 1×4

     0     0   NaN     0

TF = allfinite(B)
TF = logical
   0

Create a matrix and determine if all elements are finite.

A = [0 0 3;0 0 3;0 0 NaN]
A = 3×3

     0     0     3
     0     0     3
     0     0   NaN

TF = allfinite(A)
TF = logical
   0

Create a 3-D array and determine if all elements are finite.

A(:,:,1) = [2 1; 3 5];
A(:,:,2) = [0 0; 0 Inf];
A(:,:,3) = [-2 9; 4 1]
A = 
A(:,:,1) =

     2     1
     3     5


A(:,:,2) =

     0     0
     0   Inf


A(:,:,3) =

    -2     9
     4     1

TF = allfinite(A)
TF = logical
   0

Create a vector of complex numbers. Determine if all elements are finite.

A = [2+3i 3/0+1i -2i]
A = 1×3 complex

   2.0000 + 3.0000i      Inf + 1.0000i   0.0000 - 2.0000i

TF = allfinite(A)
TF = logical
   0

allfinite(A) returns 0 because the second element of A has a real part that is infinite.

Input Arguments

collapse all

Input array, specified as a scalar, vector, matrix, or multidimensional array.

Example: [pi NaN Inf -Inf]

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | datetime | duration | calendarDuration
Complex Number Support: Yes

Extended Capabilities

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

Version History

Introduced in R2022a

See Also

| | |