Documentation

Inf

Create array of all Inf values

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