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. Inf results from operations that return values too large to represent as floating-point numbers, 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 like p; that is, 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.

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

Extended Capabilities

See Also

| | |

Introduced before R2006a