Inf

Crear un arreglo con solo valores Inf

Sintaxis

X = Inf

X = Inf(n)

X = Inf(sz1,...,szN)

X = Inf(sz)

X = Inf(___,typename)

X = Inf(___,like=p)

Descripción

X = Inf devuelve la representación escalar de un número infinito positivo. Las operaciones devuelven Inf cuando su resultado es demasiado grande para representarlo como un número de punto flotante, como 1/0 o log(0).

Para doble precisión, Inf representa números mayores que realmax. Para precisión simple, Inf representa números mayores que realmax("single").

X = Inf(n) devuelve una matriz de n por n de valores Inf.

X = Inf(sz1,...,szN) devuelve un arreglo de sz1 por ... por szN de valores Inf en el que sz1,...,szN indica el tamaño de cada dimensión. Por ejemplo, Inf(3,4) devuelve una matriz de 3 por 4.

X = Inf(sz) devuelve un arreglo de valores Inf, donde el vector de tamaño sz define size(X). Por ejemplo, Inf([3 4]) devuelve una matriz de 3 por 4.

X = Inf(___,typename) devuelve un arreglo de valores Inf del tipo de datos typename, que pueden ser "single" o "double".

X = Inf(___,like=p) devuelve un arreglo de valores Inf del mismo tipo de datos, dispersión y complejidad (real o compleja) que p. Puede especificar typename o like, pero no ambos.

Ejemplos

Matriz de valores Inf

Cree una matriz de 3 por 3 de valores Inf.

X = Inf(3)

X = 3×3

   Inf   Inf   Inf
   Inf   Inf   Inf
   Inf   Inf   Inf

Arreglo 3D de valores Inf

Cree un arreglo de 2 por 3 por 4 de valores Inf y muestre su tamaño.

X = Inf(2,3,4);
size(X)

ans = 1×3

     2     3     4

Clonar el tamaño de un arreglo existente

Cree un arreglo de valores Inf que tenga el mismo tamaño que un arreglo existente.

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

X = 3×2

   Inf   Inf
   Inf   Inf
   Inf   Inf

Es habitual combinar las dos líneas anteriores de código en una única línea.

X = Inf(size(A));

Especificar el tipo de datos de valores Inf

Cree un vector de 1 por 3 de valores Inf cuyos elementos sean del tipo single.

X = Inf(1,3,"single")

X = 1×3 single row vector

   Inf   Inf   Inf

También puede especificar el tipo de salida en función del tipo de otra variable. Cree una variable p del tipo single. A continuación, cree un vector de valores Inf con el mismo tamaño y tipo que p.

p = single([1 2 3]);
X = Inf(size(p),like=p)

X = 1×3 single row vector

   Inf   Inf   Inf

Argumentos de entrada

n — Tamaño de una matriz cuadrada

valor entero

Tamaño de una matriz cuadrada, especificado como valor entero.

• Si n es 0, X es una matriz vacía.

• Si n es negativo, se trata como 0.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — Tamaño de cada dimensión de una lista

valores enteros

Tamaño de cada dimensión de una lista, especificado como argumentos de enteros separados.

• Si el tamaño de una dimensión cualquiera es 0, X es un arreglo vacío.

• Si el tamaño de una dimensión cualquiera es negativo, se trata como 0.

• Más allá de la segunda dimensión, Inf ignora las dimensiones finales de longitud 1. Por ejemplo, Inf(3,1,1) crea un vector de 3 por 1 de valores Inf.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Tamaño de cada dimensión de un vector

vector fila de enteros

Tamaño de cada dimensión de un vector, especificado como vector fila de valores enteros.

• Si el tamaño de una dimensión cualquiera es 0, X es un arreglo vacío.

• Si el tamaño de una dimensión cualquiera es negativo, se trata como 0.

• Más allá de la segunda dimensión, Inf ignora las dimensiones finales de longitud 1. Por ejemplo, Inf([3 1]) crea un vector de 3 por 1 de valores Inf.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — Tipo de datos

"double" (predeterminado) | "single"

Tipo de datos que se desea crear, especificado como "double" o "single".

p — Prototipo del arreglo

arreglo

Prototipo del arreglo que crear, especificado como arreglo.

Tipos de datos: double | single
Soporte de números complejos: Sí

Argumentos de salida

X — Arreglo de valores Inf

escalar | vector | matriz | arreglo multidimensional

Arreglo de valores Inf, devuelto como escalar, vector, matriz o arreglo multidimensional.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Las dimensiones deben ser enteros reales no negativos.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función Inf es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• Puede especificar typename como 'gpuArray'. Si especifica typename como 'gpuArray', el tipo subyacente predeterminado del arreglo es double.

  Para crear un arreglo de GPU con el tipo subyacente datatype, especifique el tipo subyacente como argumento adicional antes de typename. Por ejemplo, X = Inf(3,datatype,'gpuArray') crea un arreglo de GPU de 3 por 3 de todos los valores Inf con el tipo subyacente datatype.

  Puede especificar el tipo subyacente datatype como una de estas opciones:

  • 'double'

  • 'single'

• También puede especificar la variable numérica p como gpuArray.

  Si especifica p como gpuArray, el tipo subyacente del arreglo devuelto es el mismo que p.

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• Puede especificar typename como 'codistributed' o 'distributed'. Si especifica typename como 'codistributed' o 'distributed', el tipo subyacente predeterminado del arreglo devuelto es double.

  Para crear un arreglo distribuido o codistribuido con el tipo subyacente datatype, especifique el tipo subyacente como argumento adicional antes de typename. Por ejemplo, X = Inf(3,datatype,'distributed') crea un arreglo distribuido de 3 por 3 de todos los valores Inf con el tipo subyacente datatype.

  Puede especificar el tipo subyacente datatype como una de estas opciones:

  • 'double'

  • 'single'

• También puede especificar p como arreglo codistributed o distributed.

  Si especifica p como arreglo codistributed o distributed, el tipo subyacente del arreglo devuelto es el mismo que p.

• Para ver sintaxis codistributed adicionales, consulte Inf (codistributed) (Parallel Computing Toolbox).

Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

isinf | isfinite | NaN | realmax