This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

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