La traduzione di questa pagina non è aggiornata. Fai clic qui per vedere l'ultima versione in inglese.

size

Dimensione dell’array

Sintassi

sz = size(A)

szdim = size(A,dim)

szdim = size(A,dim1,dim2,...,dimN)

[sz1,...,szN] = size(___)

Descrizione

sz = size(A) restituisce un vettore riga i cui elementi sono le lunghezze delle dimensioni corrispondenti di A. Ad esempio, se A è una matrice 3x4, size(A) restituisce il vettore [3 4].

Se A è una tabella o un orario, size(A) restituisce un vettore riga a due elementi composto dal numero di righe e dal numero di variabili della tabella.

szdim = size(A,dim) restituisce la lunghezza della dimensione dim quando dim è uno scalare intero positivo. È inoltre possibile specificare dim come un vettore di numeri interi positivi per interrogare più dimensioni alla volta. Ad esempio, size(A,[2 3]) restituisce le lunghezze della seconda e della terza dimensione di A nel vettore riga 1x2 szdim.

szdim = size(A,dim1,dim2,...,dimN) restituisce le lunghezze delle dimensioni dim1,dim2,...,dimN nel vettore riga szdim.

[sz1,...,szN] = size(___) restituisce separatamente le lunghezze delle dimensioni interrogate di A.

Esempi

Dimensione dell’array quadridimensionale

Creare un array casuale quadridimensionale e restituirne la dimensione.

A = rand(2,3,4,5);
sz = size(A)

sz = 1×4

     2     3     4     5

Interrogare la lunghezza della seconda dimensione di A.

szdim2 = size(A,2)

szdim2 = 
3

Interrogare la lunghezza dell’ultima dimensione di A.

szdimlast = size(A,ndims(A))

szdimlast = 
5

È possibile interrogare più dimensioni alla volta specificando un argomento di dimensione del vettore. Ad esempio, trovare le lunghezze della prima e della terza dimensione di A.

szdim13 = size(A,[1 3])

szdim13 = 1×2

     2     4

Trovare le lunghezze delle dimensioni dalla seconda alla quarta di A.

szdim23 = size(A,2:4)

szdim23 = 1×3

     3     4     5

In alternativa, è possibile elencare le dimensioni interrogate come argomenti di input separati.

szdim23 = size(A,2,3,4);

Dimensione della tabella

Creare una tabella con 5 righe e 4 variabili.

LastName = {'Smith';'Johnson';'Williams';'Jones';'Brown'};
Age = [38;43;38;40;49];
Height = [71;69;64;67;64];
Weight = [176;163;131;133;119];
BloodPressure = [124 93; 109 77; 125 83; 117 75; 122 80];

A = table(Age,Height,Weight,BloodPressure,'RowNames',LastName)

A=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Smith       38       71       176       124     93  
    Johnson     43       69       163       109     77  
    Williams    38       64       131       125     83  
    Jones       40       67       133       117     75  
    Brown       49       64       119       122     80  

Trovare la dimensione della tabella. Sebbene la variabile BloodPressure contenga due colonne, size conta solo il numero di variabili.

sz = size(A)

sz = 1×2

     5     4

Lunghezze della dimensione come argomenti separati

Creare una matrice casuale e restituire il numero di righe e di colonne separatamente.

A = rand(4,3);
[numRows,numCols] = size(A)

numRows = 
4

numCols = 
3

Argomenti di input

A — Array di input

scalare | vettore | matrice | array multidimensionale

Array di input, specificato come scalare, vettore, matrice o array multidimensionale.

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | function_handle | cell | categorical | datetime | duration | calendarDuration | table | timetable

Supporto numeri complessi: Sì

dim — Dimensioni interrogate

scalare intero positivo | vettore di scalari interi positivi | array vuoto

Dimensioni interrogate, specificate come scalare intero positivo, vettore di scalari interi positivi o array vuoto di dimensioni 0x0, 0x1 o 1x0. Se un elemento di dim è maggiore di ndims(A), size restituisce 1 nell’elemento corrispondente di output. Se dim è un array vuoto, size restituisce un array vuoto di 1x0.

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

dim1,dim2,...,dimN — Elenco delle dimensioni interrogate

scalari interi positivi

Elenco delle dimensioni interrogate, specificato come scalari interi positivi separati da virgole. Se un elemento dell’elenco è maggiore di ndims(A), size restituisce 1 nell’elemento corrispondente di output.

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

Argomenti di output

sz — Dimensione dell’array

vettore riga di interi non negativi

Dimensione dell’array, restituita come un vettore riga di interi non negativi.

• Ciascun elemento di sz rappresenta la lunghezza della dimensione corrispondente di A. Se qualsiasi elemento di sz è uguale a 0, A è un array vuoto.

• Se A è uno scalare, sz è il vettore riga [1 1].

• Se A è una tabella o un orario, sz è un vettore riga a due elementi contenente il numero di righe e il numero di variabili. Le colonne multiple all'interno di una singola variabile non vengono conteggiate.

• Se A è un vettore di caratteri di tipo char, size restituisce il vettore riga [1 M] dove M è il numero di caratteri. Tuttavia, se A è uno scalare di stringa, size restituisce [1 1] poiché si tratta di un singolo elemento di un array di stringhe. Ad esempio, confrontare l’output di size per un vettore di caratteri e una stringa:

  szchar = size('mytext')

  szchar =
  
       1     6

  szstr = size("mytext")

  szstr =
  
       1     1
  

  Per trovare il numero di caratteri in una stringa, utilizzare la funzione strlength.

Tipi di dati: double

szdim — Lunghezze della dimensione

scalare intero non negativo | vettore di numeri scalari interi non negativi | array vuoto 1x0

Lunghezze della dimensione, restituite come uno scalare intero non negativo quando dim è uno scalare intero positivo, un vettore riga di scalari interi non negativi quando dim è un vettore di interi positivi o un array vuoto 1x0 quando dim è un array vuoto. Se un elemento dell'argomento di dimensione specificato è maggiore di ndims(A), size restituisce 1 nell’elemento corrispondente di szdim.

Tipi di dati: double

sz1,...,szN — Lunghezze della dimensione elencate separatamente

scalari interi non negativi

Lunghezze della dimensione elencate separatamente, restituite come scalari interi non negativi separati da virgole.

• Quando dim non è specificato e sono elencati meno di ndims(A) argomenti di output, tutte le lunghezze delle dimensioni rimanenti vengono compresse nell'ultimo argomento dell'elenco. Ad esempio, se A è un array tridimensionale di dimensione [3 4 5], [sz1,sz2] = size(A) restituisce sz1 = 3 e sz2 = 20.

• Quando dim viene specificato, il numero di argomenti di output deve essere uguale al numero di dimensioni interrogate.

• Se si specificano più di ndims(A) argomenti di output, gli ulteriori argomenti finali sono restituiti come 1.

Tipi di dati: double

Suggerimenti

• Per determinare se un array è vuoto, uno scalare o una matrice, utilizzare le funzioni isempty, isscalar e ismatrix. Inoltre, è possibile determinare l'orientamento di un vettore con le funzioni isrow e iscolumn.

Funzionalità estese

Tall array

Esegui calcoli con array che hanno più righe di quelle allocabili in memoria.

La funzione size supporta completamente i tall array. Per maggiori informazioni, vedere Tall Array.

Generazione di codice C/C++
Genera codice C e C++ con MATLAB® Coder™.

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

Generazione di codice HDL
Genera codice VHDL, Verilog e SystemVerilog per progetti FPGA e ASIC utilizzando HDL Coder™.

Ambiente basato su thread

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

Questa funzione 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 size supporta completamente gli array di GPU. Per eseguire la funzione su una GPU, specificare i dati di input come un gpuArray (Parallel Computing Toolbox). 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™.

Questa funzione supporta completamente gli array distribuiti. Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

R2019b: Specificare le dimensioni come vettore di numeri interi positivi o argomenti di input separati

È possibile specificare dim come un vettore di numeri interi positivi per interrogare più dimensioni alla volta. In alternativa, è possibile elencare le dimensioni interrogate come argomenti di input separati dim1,dim2,...,dimN. Per un esempio, vedere Dimensione dell’array quadridimensionale.

Vedi anche

length | strlength | ndims | numel | height | width