Inf

R2026b

Creare un array di tutti i valori Inf

Sintassi

X = Inf

X = Inf(n)

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

X = Inf(sz)

X = Inf(___,typename)

X = Inf(___,like=p)

Descrizione

X = Inf restituisce la rappresentazione scalare dell'infinito positivo. Le operazioni restituiscono Inf quando il loro risultato è troppo grande per essere rappresentato come numero in virgola mobile, come 1/0 o log(0).

Per la doppia precisione, Inf rappresenta numeri maggiori di realmax. Per la singola precisione, Inf rappresenta numeri maggiori di realmax("single").

X = Inf(n) restituisce una matrice n x n di valori Inf.

X = Inf(sz1,...,szN) restituisce un array sz1 x...x szN di valori Inf, dove sz1,...,szN indicano la grandezza di ciascuna dimensione. Ad esempio, Inf(3,4) restituisce una matrice 3x4.

X = Inf(sz) restituisce un array di valori Inf, dove il vettore di dimensione sz definisce size(X). Ad esempio, Inf([3 4]) restituisce una matrice 3x4.

X = Inf(___,typename) restituisce un array di valori Inf del tipo di dato typename, che può essere "single" o "double".

X = Inf(___,like=p) restituisce un array di valori Inf dello stesso tipo di dato, sparsità e complessità (reale o complessa) di p. È possibile specificare typename o like, ma non entrambi.

Esempi

Matrice di valori Inf

Creare una matrice 3x3 di valori Inf.

X = Inf(3)

X = 3×3

   Inf   Inf   Inf
   Inf   Inf   Inf
   Inf   Inf   Inf

Array tridimensionale di valori Inf

Creare un array 2×3×4 di valori Inf e visualizzarne le dimensioni.

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

ans = 1×3

     2     3     4

Riproduzione della dimensione da un array esistente

Creare un array di valori Inf della stessa dimensione di un array esistente.

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

X = 3×2

   Inf   Inf
   Inf   Inf
   Inf   Inf

È prassi comune combinare le due righe di codice precedenti in un'unica riga.

X = Inf(size(A));

Specifica del tipo di dato dei valori Inf

Creare un vettore 1×3 di valori Inf i cui elementi sono di tipo single.

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

X = 1×3 single row vector

   Inf   Inf   Inf

È inoltre possibile specificare il tipo di output in base al tipo di un'altra variabile. Creare una variabile p di tipo single. Quindi, creare un vettore di valori Inf delle stesse dimensioni e dello stesso tipo di p.

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

X = 1×3 single row vector

   Inf   Inf   Inf

Argomenti di input

n — Dimensione della matrice quadrata

intero

Dimensione della matrice quadrata, specificata come intero.

• Se n è 0, X è una matrice vuota.

• Se n è negativo, viene trattato come 0.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — Grandezza di ciascuna dimensione in un elenco

interi

Grandezza di ciascuna dimensione in un elenco, specificata come argomenti interi separati.

• Se la grandezza di qualsiasi dimensione è 0, X è un array vuoto.

• Se la grandezza di qualsiasi dimensione è negativa, viene trattata come 0.

• Oltre la seconda dimensione, Inf ignora le dimensioni finali con lunghezza pari a 1. Ad esempio, Inf(3,1,1) crea un vettore 3x1 di valori Inf.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Grandezza di ciascuna dimensione in un vettore

vettore riga di numeri interi

Grandezza di ciascuna dimensione in un vettore, specificata come vettore riga di numeri interi.

• Se la grandezza di qualsiasi dimensione è 0, X è un array vuoto.

• Se la grandezza di qualsiasi dimensione è negativa, viene trattata come 0.

• Oltre la seconda dimensione, Inf ignora le dimensioni finali con lunghezza pari a 1. Ad esempio, Inf([3 1]) crea un vettore 3x1 di valori Inf.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — Tipo di dato

"double" (predefinito) | "single"

Tipo di dato da creare, specificato come "double" o "single".

p — Prototipo di array

array

Prototipo di array da creare, specificato come array.

Tipi di dati: double | single
Supporto numeri complessi: Sì

Argomenti di output

X — Array di valori Inf

scalare | vettore | matrice | array multidimensionale

Array di valori Inf, restituito come scalare, vettore, matrice o array multidimensionale.

Funzionalità estese

Generazione di codice C/C++

Genera codice C e C++ con MATLAB® Coder™.

Note su utilizzo e limitazioni:

• Le dimensioni devono essere numeri interi reali e non negativi.

Generazione di codice GPU

Genera codice CUDA® per GPU NVIDIA® con GPU Coder™.

Consultare le note su utilizzo e limitazioni nella sezione Generazione di codice C/C++. Le stesse note su utilizzo e limitazioni si applicano alla generazione di codice GPU.

Ambiente basato su thread

Esegui il codice in background usando MATLAB® backgroundPool oppure accelera il codice con Parallel Computing Toolbox™ ThreadPool.

La funzione Inf supporta completamente gli ambienti basati su thread. Per maggiori informazioni, vedere Run MATLAB Functions in Thread-Based Environment.

Array GPU

Accelera il codice mediante esecuzione su un’unità di elaborazione grafica (GPU) con Parallel Computing Toolbox™.

La funzione Inf supporta l'input di array GPU con queste note su utilizzo e limitazioni:

• È possibile specificare typename come 'gpuArray'. Se typename è specificato come 'gpuArray', il tipo sottostante predefinito dell'array è double.

  Per creare un array di GPU con tipo sottostante datatype, specificare il tipo sottostante come ulteriore argomento prima di typename. Ad esempio, X = Inf(3,datatype,'gpuArray') crea un array GPU 3x3 di tutti i valori Inf con tipo sottostante datatype.

  È possibile specificare il tipo sottostante datatype come una di queste opzioni:

  • 'double'

  • 'single'

• È inoltre possibile specificare la variabile numerica p come un gpuArray.

  Se p è specificato come un gpuArray, il tipo sottostante dell’array restituito è lo stesso di p.

Per maggiori informazioni, vedere Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Array distribuiti

Partiziona array di grandi dimensioni nella memoria combinata del cluster con Parallel Computing Toolbox™.

La funzione Inf supporta array distribuiti con le seguenti note su utilizzo e limitazioni:

• È possibile specificare typename come 'codistributed' o 'distributed'. Se typename è specificato come 'codistributed' o 'distributed', il tipo sottostante predefinito dell'array restituito è double.

  Per creare un array distribuito o co-distribuito con tipo sottostante datatype, specificare il tipo sottostante come ulteriore argomento prima di typename. Ad esempio, X = Inf(3,datatype,'distributed') crea un array distribuito 3x3 di tutti i valori Inf con tipo sottostante datatype.

  È possibile specificare il tipo sottostante datatype come una di queste opzioni:

  • 'double'

  • 'single'

• È inoltre possibile specificare p come un array codistributed o distributed.

  Se p è specificato come un array codistributed o distributed, il tipo sottostante dell'array restituito è lo stesso di p.

• Per ulteriori sintassi codistributed, vedere Inf (codistributed) (Parallel Computing Toolbox).

Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

Vedi anche

isinf | isfinite | NaN | realmax