cell

Array di celle

Descrizione

Un array di celle è un tipo di dati con contenitori di dati indicizzati chiamati celle, dove ciascuna cella può contenere qualsiasi tipo di dati. Gli array di celle contengono comunemente elenchi di testo, combinazioni di testo e numeri o array numerici di grandezze diverse. Il riferimento agli insiemi di celle si esegue racchiudendo gli indici tra parentesi tonde (). L'accesso ai contenuti delle celle si esegue tramite l'indicizzazione con parentesi graffe {}.

Creazione

Quando si dispone di dati da inserire in un array di celle, creare l'array utilizzando l'operatore di costruzione dell'array di celle {}.

C = {1,2,3;
     'text',rand(5,10,2),{11; 22; 33}}

C=2×3 cell array
    {[   1]}    {[          2]}    {[     3]}
    {'text'}    {5×10×2 double}    {3×1 cell}

È inoltre possibile utilizzare {} per creare un array di celle 0x0 vuoto.

C = {}

C =

  0×0 empty cell array

Per creare un array di celle con una grandezza specificata, utilizzare la funzione cell, descritta di seguito.

È possibile utilizzare cell per preallocare un array di celle a cui assegnare i dati successivamente. cell converte inoltre alcuni tipi di strutture dati Java^®, .NET e Python^® in array di celle di oggetti MATLAB^® equivalenti.

Sintassi

C = cell(n)

C = cell(sz1,...,szN)

C = cell(sz)

D = cell(obj)

Descrizione

C = cell(n) restituisce un array di celle n x n di matrici vuote.

C = cell(sz1,...,szN) restituisce un array di celle sz1 x ... x szN di matrici vuote, dove sz1,...,szN indicano la grandezza di ciascuna dimensione. Ad esempio, cell(2,3) restituisce un array di celle 2x3.

C = cell(sz) restituisce un array di celle di matrici vuote, dove il vettore di grandezza sz definisce size(C). Ad esempio, cell([2 3]) restituisce un array di celle 2x3.

D = cell(obj) converte un array Java, un array .NET System.String o System.Object o una sequenza Python in un array di celle MATLAB.

Argomenti di input

n — Grandezza dell'array di celle quadrato

valore intero

Grandezza dell'array di celle quadrato, specificata come valore intero.

• Se n è 0, C è un array di celle vuoto.

• Se n è negativo, viene trattato come 0.

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

sz1,...,szN — Grandezze delle dimensioni

valori interi

Grandezze delle dimensioni dell'array di celle, specificate come valori interi.

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

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

• Oltre la seconda dimensione, cell ignora le dimensioni finali con grandezza pari a 1. Ad esempio, cell(3,1,1,1) produce un array di celle 3x1 di matrici vuote.

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

sz — Dimensione

vettore riga di numeri interi

Grandezza, specificata come vettore riga di numeri interi. Ciascun elemento di sz indica la grandezza della dimensione corrispondente.

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

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

• Oltre la seconda dimensione, cell ignora le dimensioni finali con grandezza pari a 1. Ad esempio, cell([3 1 1 1]) produce un array di celle 3x1 di matrici vuote.

Esempio sz = [2 3 4] crea un array di celle 2x3x4 di matrici vuote.

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

obj — Array di input

Array o oggetto Java | Array .NET di tipo System.String o System.Object | Tipo di sequenza Python

Array di input, specificato come:

• Array o oggetto Java

• Array .NET di tipo System.String o System.Object

• Tipo di sequenza Python

Argomenti di output

C — Array di output

array di celle

Array di output, restituito come un array di celle. Ciascuna cella contiene un array vuoto, 0 per 0, di tipo double.

D — Array rimodellato

array di celle

Array rimodellato, restituito come un array di celle.

Ciascuna cella contiene un oggetto MATLAB che ha un tipo più vicino al tipo corrispondente di Java, .NET o Python. Per maggiori informazioni, vedere:

• Handle Data Returned from Java Methods

• Automatically Convert Python Types to MATLAB Types

• .NET Type to MATLAB Type Mapping

Esempi

Creazione di array di celle

Quando parti di dati correlati presentano tipi di dati diversi, è possibile metterli insieme in un array di celle. Ciascuna cella contiene una parte di dati. Per fare riferimento agli elementi di un array di celle, utilizzare l'indicizzazione dell'array. È possibile indicizzare su un array di celle utilizzando le parentesi tonde () e i contenuti delle celle utilizzando le parentesi graffe {}.

Creare un array di celle che contenga diverse letture della temperatura effettuate in una determinata data. Specificare una data come vettore di caratteri e le temperature come array di double. Per memorizzare queste parti di dati in un array di celle, includerle tra parentesi graffe.

C = {'2017-08-16',[56 67 78]}

C=1×2 cell array
    {'2017-08-16'}    {[56 67 78]}

Aggiungere all'array di celle le letture per le diverse date. Un modo per aggiungere altre celle è espandere l'array di celle tramite assegnazione, proprio come si può espandere un array ordinario.

C(2,:) = {'2017-08-17',[58 69 79]};
C(3,:) = {'2017-08-18',[60 68 81]}

C=3×2 cell array
    {'2017-08-16'}    {[56 67 78]}
    {'2017-08-17'}    {[58 69 79]}
    {'2017-08-18'}    {[60 68 81]}

Indicizzare sulla prima riga di C. Quando si esegue l'indicizzazione con le parentesi tonde (), il risultato è un array di celle che è un sottoinsieme dell'array di celle.

C(1,:)

ans=1×2 cell array
    {'2017-08-16'}    {[56 67 78]}

Indicizzare sul contenuto di una cella. Quando si esegue l'indicizzazione con le parentesi graffe {}, il risultato è la parte di dati contenuta nella cella specificata.

C{1,2}

ans = 1×3

    56    67    78

Array di celle quadrato

Creare un array di celle 3x3 di matrici vuote.

C = cell(3)

C=3×3 cell array
    {0×0 double}    {0×0 double}    {0×0 double}
    {0×0 double}    {0×0 double}    {0×0 double}
    {0×0 double}    {0×0 double}    {0×0 double}

Array di celle tridimensionale

Creare un array di celle 3x4x2 di matrici vuote.

C = cell(3,4,2);
size(C)

ans = 1×3

     3     4     2

Riproduzione della dimensione da un array esistente

Creare un array di celle di matrici vuote della stessa grandezza di un array esistente.

A = [7 9; 2 1; 8 3];
sz = size(A);
C = cell(sz)

C=3×2 cell array
    {0×0 double}    {0×0 double}
    {0×0 double}    {0×0 double}
    {0×0 double}    {0×0 double}

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

C = cell(size(A));

Suggerimenti

• La creazione di un array di celle di matrici vuote con la funzione cell è equivalente all'assegnazione di una matrice vuota all'ultimo indice di un nuovo array di celle. Ad esempio, queste due dichiarazioni sono equivalenti:

  C = cell(3,4,2);
  C{3,4,2} = [];

Funzionalità estese

Generazione di codice C/C++

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

Note su utilizzo e limitazioni:

• Vedere Cell Array Limitations for Code Generation (MATLAB 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 distribuiti

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

Note su utilizzo e limitazioni:

• Vedere distributed.cell (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

R2023b: Visualizzazione dei contenuti parziali, nonché delle grandezze e del tipo di dati degli array nelle celle

Tra le release R2021b e R2023b, MATLAB visualizzava l'intero contenuto di un array in una cella, se il contenuto si adattava al display. Se l'array non si adattava, MATLAB mostrava la massima quantità di array consentita dal display.

A partire dalla release R2023b, se l'intero contenuto di un array in una cella non si adatta al display, MATLAB mostra la quantità massima di array consentita dal display, nonché la grandezza e il tipo di dati dell'array. Ad esempio, a partire dalla release R2023b, MATLAB visualizza il contenuto parziale, la grandezza e il tipo di dati di una cella che contiene un array di 100 valori doppi.

D = {3.14,[1:100]};
D(2)

ans =

  1×1 cell array

    {[1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 … ] (1×100 double)}

Se il primo elemento dell'array è troppo grande per essere visualizzato, ad esempio un membro di un'enumerazione con un nome lungo, MATLAB visualizza solo la grandezza e il tipo di dati dell'array.

La funzione disp segue lo stesso comportamento.

R2021b: Visualizzazione di contenuti parziali degli array nelle celle al posto della grandezza e del tipo di dati

Prima della release R2021b, MATLAB visualizzava l'intero contenuto di un array in una cella, se il contenuto si adattava al display. Se l'array non si adattava, MATLAB mostrava la grandezza e il tipo di dati dell'array.

A partire dalla release R2021b, se l'intero contenuto di un array non si adatta al display, MATLAB mostra la quantità massima di array consentita dallo spazio, anziché la grandezza e il tipo di dati. Ad esempio, a partire dalla release R2021b, MATLAB visualizza il contenuto parziale di una cella che contiene una array di 100 valori doppi.

D = {3.14,[1:100]};
D(2)

ans =

  1×1 cell array

    {[1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 … ]}

Se il primo elemento dell'array è troppo grande per essere visualizzato, ad esempio un membro di un'enumerazione con un nome lungo, MATLAB visualizza solo la grandezza e il tipo di dati.

La funzione disp segue lo stesso comportamento.

R2019a: Coerenza dell’espansione dell'array di celle con l'espansione dell'array generale

A partire dalla release R2019a, le dimensioni di un array di celle espanso sono coerenti sia che si utilizzino parentesi graffe o parentesi tonde per gli indici. In precedenza, le dimensioni di output erano diverse quando non si specificavano gli indici per tutte le dimensioni. L'indicizzazione con le parentesi graffe ora corrisponde al comportamento precedente dell'indicizzazione con le parentesi tonde, che è coerente con l'espansione generale degli array. Ad esempio:

• Se C è 1x2x3x4, C(5,2)={3} e C{5,2}=3 espandono entrambe C a 5x2x3x4. In precedenza, C{5,2}=3 restituiva un array 5x24.

• Se C è 0x5 o 5x0, C(3)={2} e C{3}=2 espandono C a 1x3. In precedenza, C{3}=2 restituiva un array 1x5 quando C era 0x5 e un array 3x1 quando C era 5x0.

• Se C è 0x2x3, C(3)={2} e C{3}=2 producono errori perché non è chiaro quale dimensione espandere. In precedenza, C{3}=2 restituiva un array 1x6.

Vedi anche

num2cell | table2cell | iscell | cell2mat | cell2struct | cell2table | mat2cell | struct2cell

Argomenti

• Creazione di array di celle
• Preallocate Memory for Cell Array
• Access Data in Cell Array