Accelerating the pace of engineering and science

# Documentation Center

• Trial Software
• Product Updates

### Contents

라이선스가 부여된 사용자만 번역 문서를 볼 수 있습니다. 번역 문서를 보려면 로그인하십시오.

# any

Determine if any array elements are nonzero

## Description

example

B = any(A) tests along the first array dimension of A whose size does not equal 1, and determines if any element is a nonzero number or logical 1 (true). In practice, any is a natural extension of the logical OR operator.

• If A is a vector, then B = any(A) returns logical 1 (true) if any of the elements of A is a nonzero number or is logical 1, and returns logical 0 (false) if all the elements are zero.

• If A is a nonempty, nonvector matrix, then B = any(A) treats the columns of A as vectors, returning a row vector of logical 1s and 0s.

• If A is an empty 0-by-0 matrix, any(A) returns logical 0 (false).

• If A is a multidimensional array, any(A) acts along the first array dimension whose size does not equal 1 and returns an array of logical values. The size of this dimension becomes 1, while the sizes of all other dimensions remain the same.

example

B = any(A,dim) tests elements along dimension dim. The dim input is a positive integer scalar.

## Examples

expand all

### Test Matrix Columns

Create a 3-by-3 matrix.

```A = [0 0 3;0 0 3;0 0 3]
```
```A =

0     0     3
0     0     3
0     0     3```

Test each column for nonzero elements.

`B = any(A)`
```B =

0     0     1
```

### Reduce a Logical Vector to a Single Condition

Create a vector of decimal values and test which values are less than 0.5.

```A = [0.53 0.67 0.01 0.38 0.07 0.42 0.69];
B = (A < 0.5) ```
```B =

0   0   1   1   1   1   0```

The output is a vector of logical values. The any function reduces such a vector of logical values to a single condition. In this case, B = any(A < 0.5) yields logical 1.

This makes any particularly useful in if statements.

```if any(A < 0.5)
%do something
else
%do something else
end```

The code is executed depending on a single condition, rather than a vector of possibly conflicting conditions.

### Test Arrays of Any Dimension

Create a 3-by-7-by-5 multidimensional array and test to see if any of its elements are greater than 3.

```A = rand(3,7,5) * 5;
B = any(A(:) > 3)
```
```B =

1```

You can also test the array for elements that are less than zero.

```B = any(A(:) < 0)
```
```B =

0```

The syntax A(:) turns the elements of A into a single column vector, so you can use this type of statement on an array of any size.

### Test Matrix Rows

Create a 3-by-3 matrix.

```A = [0 0 3;0 0 3;0 0 3]
```
```A =

0     0     3
0     0     3
0     0     3```

Test the rows of A for nonzero elements by specifying dim = 2.

`B = any(A,2)`
```B =

1
1
1
```

## Input Arguments

expand all

### A — Input arrayscalar | vector | matrix | multidimensional array

Input array, specified as a scalar, vector, matrix, or multidimensional array. The any function ignores elements of A that are NaN (Not a Number).

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

### dim — Dimension to operate alongpositive integer scalar

Dimension to operate along, specified as a positive integer scalar. If no value is specified, the default is the first array dimension whose size does not equal 1.

Consider a two-dimensional input array, A:

• any(A,1) works on successive elements in the columns of A and returns a row vector of logical values.

• any(A,2) works on successive elements in the rows of A and returns a column vector of logical values.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

## Output Arguments

expand all

### B — Logical arrayscalar | vector | matrix | multidimensional array

Logical array, returned as a scalar, vector, matrix, or multidimensional array. The dimension of A acted on by any has size 1 in B.

## See Also

Was this topic helpful?