# Inf

Create array of all `Inf` values

## Syntax

``X = Inf``
``X = Inf(n)``
``X = Inf(sz1,...,szN)``
``X = Inf(sz)``
``X = Inf(___,typename)``
``X = Inf(___,'like',p)``

## Description

````X = Inf` returns the scalar representation of positive infinity. Operations return `Inf` when their result is too large to represent as a floating point number, such as `1/0` or `log(0)`.For double-precision, `Inf` represents numbers larger than `realmax`. For single-precision, `Inf` represents numbers larger than `realmax('single')`.```

example

````X = Inf(n)` returns an `n`-by-`n` matrix of `Inf` values.```

example

````X = Inf(sz1,...,szN)` returns an `sz1`-by-...-by-`szN` array of `Inf` values, where `sz1,...,szN` indicate the size of each dimension. For example, `Inf(3,4)` returns a 3-by-4 matrix.```

example

````X = Inf(sz)` returns an array of `Inf` values, where the size vector `sz` defines `size(X)`. For example, `Inf([3 4])` returns a 3-by-4 matrix.```

example

````X = Inf(___,typename)` returns an array of `Inf` values of data type `typename`, which can be either `'single'` or `'double'`.```

example

````X = Inf(___,'like',p)` returns an array of `Inf` values of the same data type, sparsity, and complexity (real or complex) as `p`. You can specify `typename` or `'like'` but not both.```

## Examples

collapse all

Create a 3-by-3 matrix of `Inf` values.

`X = Inf(3)`
```X = 3×3 Inf Inf Inf Inf Inf Inf Inf Inf Inf ```

Create a 2-by-3-by-4 array of `Inf` values and display its size.

```X = Inf(2,3,4); size(X)```
```ans = 1×3 2 3 4 ```

Create an array of `Inf` values that is the same size as an existing array.

```A = [1 4; 2 5; 3 6]; sz = size(A); X = Inf(sz)```
```X = 3×2 Inf Inf Inf Inf Inf Inf ```

It is a common pattern to combine the previous two lines of code into a single line.

`X = Inf(size(A));`

Create a 1-by-3 vector of `Inf` values whose elements are of type `single`.

`X = Inf(1,3,'single')`
```X = 1x3 single row vector Inf Inf Inf ```

You can also specify the output type based on the type of another variable. Create a variable `p` of type `single`. Then, create a vector of `Inf` values with the same size and type as `p`.

```p = single([1 2 3]); X = Inf(size(p),'like',p)```
```X = 1x3 single row vector Inf Inf Inf ```

## Input Arguments

collapse all

Size of square matrix, specified as an integer.

• If `n` is 0, then `X` is an empty matrix.

• If `n` is negative, then it is treated as 0.

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

Size of each dimension in a list, specified as separate integer arguments.

• If the size of any dimension is 0, then `X` is an empty array.

• If the size of any dimension is negative, then it is treated as 0.

• Beyond the second dimension, `Inf` ignores trailing dimensions of length 1. For example, `Inf(3,1,1)` creates a 3-by-1 vector of `Inf` values.

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

Size of each dimension in a vector, specified as a row vector of integers.

• If the size of any dimension is 0, then `X` is an empty array.

• If the size of any dimension is negative, then it is treated as 0.

• Beyond the second dimension, `Inf` ignores trailing dimensions of length 1. For example, ```Inf([3 1])``` creates a 3-by-1 vector of `Inf` values.

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

Data type to create, specified as `'double'` or `'single'`.

Prototype of array to create, specified as an array.

Data Types: `double` | `single`
Complex Number Support: Yes