cell

Cell array

Description

Un cell array est un type de données comportant des conteneurs de données indexées appelés cellules. Chaque cellule peut contenir n’importe quel type de données. Les cell arrays contiennent généralement des listes de texte, des combinaisons de texte et de nombres ou des tableaux numériques de tailles différentes. Faites référence à des ensembles de cellules en plaçant les indices entre parenthèses (). Accédez au contenu des cellules en les indexant avec des accolades {}.

Création

Quand vous avez des données à intégrer dans un cell array, créez ce dernier avec l’opérateur de construction de cell array {}.

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}

Vous pouvez également utiliser {} pour créer un cell array vide de 0 x 0.

C = {}

C =

  0×0 empty cell array

Pour créer un cell array avec une taille spécifiée, utilisez la fonction cell décrite ci-dessous.

Vous pouvez utiliser cell pour préallouer un cell array auquel vous affecterez des données par la suite. cell convertit également certains types de structures de données Java^®, .NET et Python^® en cell arrays d’objets MATLAB^® équivalents.

Syntaxe

C = cell(n)

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

C = cell(sz)

D = cell(obj)

Description

C = cell(n) renvoie un cell array de matrices vides de dimension n x n.

C = cell(sz1,...,szN) renvoie un cell array de matrices vides de dimension sz1 x … x szN où sz1,...,szN indique la taille de chaque dimension. Par exemple, cell(2,3) renvoie un cell array de 2 x 3.

C = cell(sz) renvoie un cell array de matrices vides où le vecteur de taille sz définit size(C). Par exemple, cell([2 3]) renvoie un cell array de 2 x 3.

D = cell(obj) convertit un tableau Java, un tableau .NET System.String ou System.Object ou bien une séquence Python en cell array MATLAB.

Arguments en entrée

n — Taille d’un cell array carré

valeur entière

Taille d’un cell array carré, spécifiée sous forme d’une valeur entière.

• Si n est égal à 0, C est un cell array vide.

• Si n est négatif, il est traité comme 0.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — Tailles des dimensions

valeurs entières

Tailles des dimensions du cell array, spécifiées sous forme de valeurs entières.

• Si la taille d’une dimension est égale à 0, C est un cell array vide.

• Si la taille d’une dimension est négative, elle est traitée comme une taille égale à 0.

• Au-delà de la deuxième dimension, cell ignore les dimensions suivantes de taille 1. Par exemple, cell(3,1,1,1) produit un cell array de matrices vides de dimension 3 x 1.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Taille

vecteur ligne de nombres entiers

Taille, spécifiée sous forme d’un vecteur ligne de nombres entiers. Chaque élément de sz indique la taille de la dimension correspondante.

• Si la taille d’une dimension est égale à 0, C est un cell array vide.

• Si la taille d’une dimension est négative, elle est traitée comme une taille égale à 0.

• Au-delà de la deuxième dimension, cell ignore les dimensions suivantes de taille 1. Par exemple, cell([3 1 1 1]) produit un cell array de matrices vides de dimension 3 x 1.

Exemple : sz = [2 3 4] crée un cell array de matrices vides de dimension 2 x 3 x 4.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

obj — Tableau en entrée

tableau ou objet Java | tableau .NET de type System.String ou System.Object | type de séquence Python

Tableau en entrée, spécifié sous forme de :

• tableau ou objet Java

• tableau .NET de type System.String ou System.Object

• type de séquence Python

Arguments de sortie

C — Tableau en sortie

cell array

Tableau en sortie, renvoyé sous forme d’un cell array. Chaque cellule contient un tableau de 0 x 0 vide de type double.

D — Tableau converti

cell array

Tableau converti, renvoyé sous forme d’un cell array.

Chaque cellule contient un objet MATLAB du type le plus proche du type Java, .NET ou Python correspondant. Pour plus d’informations, consultez :

• Handle Data Returned from Java Methods

• Automatically Convert Python Types to MATLAB Types

• .NET Type to MATLAB Type Mapping

Exemples

Créer un cell array

Lorsque des données associées sont de types différents, vous pouvez les stocker ensemble dans un cell array. Chaque cellule contient une donnée. Pour faire référence aux éléments d’un cell array, utilisez l’indexation de tableau. Vous pouvez indexer un cell array avec des parenthèses () et le contenu des cellules avec des accolades {}.

Créez un cell array contenant plusieurs relevés de température effectués à une date donnée. Spécifiez une date sous forme d’un vecteur de caractères et des températures sous forme d’un tableau de doubles. Pour stocker ces données dans un cell array, mettez-les entre accolades.

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

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

Ajoutez des relevés pour différentes dates au cell array. L’une des façons d’ajouter des cellules consiste à étendre le cell array par affectation, de la même manière que vous étendez un tableau ordinaire.

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]}

Indexez la première ligne de C. Lorsque vous effectuez une indexation avec des parenthèses (), vous obtenez un cell array qui est un sous-ensemble du cell array d’origine.

C(1,:)

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

Indexez le contenu d’une cellule. Lorsque vous effectuez une indexation avec des accolades {}, le résultat est la donnée contenue dans la cellule spécifiée.

C{1,2}

ans = 1×3

    56    67    78

Cell array carré

Créez un cell array de matrices vides de dimension 3 x 3.

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}

Cell array 3D

Créez un cell array de matrices vides de dimension 3 x 4 x 2.

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

ans = 1×3

     3     4     2

Cloner la taille d'un tableau existant

Créez un cell array de matrices vides de la même taille qu’un tableau existant.

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}

Il est courant de combiner les deux lignes de code précédentes en une seule.

C = cell(size(A));

Conseils

• La création d’un cell array de matrices vides avec la fonction cell équivaut à affecter une matrice vide au dernier indice d’un nouveau cell array. Par exemple, les deux instructions suivantes sont équivalentes :

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

Capacités étendues

Génération de code C/C++

Générez du code C et C++ avec MATLAB® Coder™.

Notes d’usage et limitations :

• Consultez Cell Array Limitations for Code Generation (MATLAB Coder).

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

Cette fonction supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

Distributed arrays

Divisez les tableaux volumineux dans la mémoire combinée de votre cluster avec Parallel Computing Toolbox™.

Notes d’usage et limitations :

• Consultez distributed.cell (Parallel Computing Toolbox).

Historique des versions

Introduit avant R2006a

R2023b: Affichage du contenu partiel en plus de la taille et du type de données des tableaux dans les cellules

Entre les versions R2021b et R2023b, MATLAB affichait l’intégralité du contenu d’un tableau dans une cellule si celui-ci tenait à l’écran. Si le tableau était trop grand, MATLAB affichait autant de contenu que le permettait l’écran.

Depuis la version R2023b, si l’intégralité du contenu d’un tableau dans une cellule ne tient pas à l’écran, MATLAB affiche autant de contenu que le permet l’écran ainsi que la taille et le type de données du tableau. Par exemple, depuis la version R2023b, MATLAB affiche le contenu partiel ainsi que la taille et le type de données pour une cellule contenant un tableau de 100 valeurs doubles.

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)}

Si le premier élément du tableau est lui-même trop grand pour être affiché, par exemple un membre d’une énumération dont le nom est long, MATLAB affiche seulement la taille et le type de données du tableau.

La fonction disp a le même comportement.

R2021b: Affichage du contenu partiel des tableaux dans les cellules au lieu de la taille et du type de données

Avant la version R2021b, MATLAB affichait l’intégralité du contenu d’un tableau dans une cellule si celui-ci tenait à l’écran. Si le tableau était trop grand, MATLAB affichait la taille et le type de données du tableau.

Depuis la version R2021b, si l’intégralité du contenu d’un tableau ne tient pas à l’écran, MATLAB affiche autant de contenu que l’espace le permet au lieu de la taille et du type de données. Par exemple, depuis la version R2021b, MATLAB affiche le contenu partiel d’une cellule contenant un tableau de 100 valeurs doubles.

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 … ]}

Si le premier élément du tableau est lui-même trop grand pour être affiché, par exemple un membre d’une énumération dont le nom est long, MATLAB affiche seulement la taille et le type de données.

La fonction disp a le même comportement.

R2019a: Expansion de cell array cohérente avec l’expansion de tableau ordinaire

Depuis la version R2019a, les dimensions d’un cell array étendu sont cohérentes, que vous utilisiez des accolades ou des parenthèses pour les indices. Auparavant, les dimensions en sortie étaient différentes lorsque vous ne spécifiiez pas d’indices pour toutes les dimensions. L’indexation avec des accolades a désormais le comportement précédent de l’indexation avec des parenthèses, lequel est cohérent avec l’expansion de tableau ordinaire. Par exemple :

• Si C est de dimension 1 x 2 x 3 x 4, C(5,2)={3} et C{5,2}=3 étendent tous les deux C à 5 x 2 x 3 x 4. Auparavant, C{5,2}=3 générait un tableau de 5 x 24.

• Si C est de dimension 0 x 5 ou 5 x 0, C(3)={2} et C{3}=2 étendent C à 1 x 3. Auparavant, C{3}=2 générait un tableau de 1 x 5 quand C était de dimension 0 x 5 et un tableau de 3 x 1 quand C était de dimension 5 x 0.

• Si C est de dimension 0 x 2 x 3, C(3)={2} et C{3}=2 génèrent des erreurs, car la dimension à étendre est ambiguë. Auparavant, C{3}=2 générait un tableau de 1 x 6.

Voir aussi

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

Rubriques

• Créer un cell array
• Préallouer de la mémoire à un cell array
• Accéder aux données d’un cell array