cell

Zellenarray

Beschreibung

Ein Zellenarray ist ein Datentyp mit indizierten Datencontainern, die Zellen genannt werden, wobei jede Zelle einen beliebigen Datentyp enthalten kann. Zellenarrays enthalten meist entweder Textlisten, Kombinationen aus Texten und Zahlen oder numerische Arrays verschiedener Größe. Referenzieren Sie Sätze an Zellen, indem Sie die jeweiligen Indizes in runde Klammern () setzen. Greifen Sie auf Zelleninhalte zu, indem Sie diese mit geschweiften Klammern {} indizieren.

Erstellung

Um Daten in ein Zellenarray einzufügen, erstellen Sie das Array mit dem Zellenarray-Konstruktionsoperator {}.

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}

Zudem können Sie {} verwenden, um ein leeres 0x0-Zellenarray zu erstellen.

C = {}

C =

  0×0 empty cell array

Um ein Zellenarray mit der angegebenen Größe zu erstellen, verwenden Sie die unten beschriebene cell-Funktion.

Sie können cell verwenden, um ein Zellenarray vorzubelegen, um diesem später Daten zuzuweisen. cell wandelt zudem bestimmte Typen von Java^®-, .NET- und Python^®-Datenstrukturen in Zellenarrays äquivalenter MATLAB^®-Objekte um.

Syntax

C = cell(n)

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

C = cell(sz)

D = cell(obj)

Beschreibung

C = cell(n) gibt ein nxn-Zellenarray aus leeren Matrizen zurück.

C = cell(sz1,...,szN) gibt ein sz1-x...xszN-Zellenarray aus leeren Matrizen zurück, bei dem sz1,...,szN die Größe der jeweiligen Dimension angibt. cell(2,3) gibt beispielsweise ein 2x3-Zellenarray zurück.

C = cell(sz) gibt ein Zellenarray aus leeren Matrizen zurück, wobei der Größenvektor sz size(C) definiert. cell([2 3]) gibt beispielsweise ein 2x3-Zellenarray zurück.

D = cell(obj) wandelt ein Java-Array, ein .NET System.String- oder ein System.Object-Array oder eine Python-Sequenz in ein MATLAB-Zellenarray um.

Eingabeargumente

n — Größe des quadratischen Zellenarrays

ganzzahliger Wert

Größe eines quadratischen Zellenarrays, angegeben als Ganzzahlwert.

• Wenn n 0 ist, handelt es sich bei C um ein leeres Zellenarray.

• Wenn n negativ ist, wird der Wert wie 0 behandelt.

Datentypen: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — Größe der Dimensionen

ganzzahlige Werte

Größe der Dimensionen des Zellenarrays, angegeben als Ganzzahlwerte.

• Wenn die Größe einer beliebigen Dimension 0 ist, dann ist C ein leeres Zellenarray.

• Wenn die Größe einer beliebigen Dimension negativ ist, wird der Wert wie 0 behandelt.

• Jenseits der zweiten Dimension ignoriert cell nachgeordnete Dimensionen mit einer Größe von 1. Beispielsweise generiert cell(3,1,1,1) ein 3x1-Zellenarray aus leeren Matrizen.

Datentypen: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Größe

Zeilenvektor aus Ganzzahlen

Größe, angegeben als Zeilenvektor aus Ganzzahlen. Jedes Element von sz weist auf die Größe der entsprechenden Dimension hin.

• Wenn die Größe einer beliebigen Dimension 0 ist, dann ist C ein leeres Zellenarray.

• Wenn die Größe einer beliebigen Dimension negativ ist, wird der Wert wie 0 behandelt.

• Jenseits der zweiten Dimension ignoriert cell nachgeordnete Dimensionen mit einer Größe von 1. Beispielsweise generiert cell([3 1 1 1]) ein 3x1-Zellenarray aus leeren Matrizen.

Beispiel: sz = [2 3 4] erstellt ein 2x3x4-Zellenarray aus leeren Matrizen.

Datentypen: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

obj — Eingabearray

Java-Array oder -Objekt | .NET-Array mit dem Typ System.String oder System.Object | Python-Sequenz-Typ

Eingabearray, angegeben als:

• Java-Array oder -Objekt

• .NET-Array mit dem Typ System.String oder System.Object

• Python-Sequenz-Typ

Ausgabeargumente

C — Ausgabearray

Zellenarray

Ausgabearray, zurückgegeben als Zellenarray. Jede Zelle umfasst ein leeres 0x0-Array mit dem Typ double.

D — Konvertiertes Array

Zellenarray

Konvertiertes Array, zurückgegeben als Zellenarray.

Jede Zelle enthält ein MATLAB-Objekt mit einem Typ, der dem jeweiligen Java-, .NET- oder Python-Typ am ehesten entspricht. Weitere Informationen finden Sie hier:

• Handle Data Returned from Java Methods

• Automatically Convert Python Types to MATLAB Types

• .NET Type to MATLAB Type Mapping

Beispiele

Erstellen eines Zellen-Arrays

Wenn zusammengehörende Datenelemente verschiedene Datentypen aufweisen, können Sie diese in einem Zellenarray anordnen. Jede Zelle enthält ein Datenelement. Mithilfe von Array-Indizierung können Sie die Elemente eines Zellenarrays referenzieren. Verwenden Sie runde Klammern (), um in ein Zellenarray zu indizieren und geschweifte Klammern {}, um in den Inhalt einer Zelle zu indizieren.

Erstellen Sie ein Zellenarray mit mehreren Temperaturmesswerten, die an einem bestimmten Datum erfasst wurden. Geben Sie ein Datum als Zeichenvektor und die Temperaturen als Array aus Double-Werten an. Um diese Datenelemente in einem Zellenarray zu speichern, setzen Sie sie in geschweifte Klammern.

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

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

Fügen Sie dem Zellenarray Messwerte für weitere Daten hinzu. Eine Methode zum Hinzufügen weiterer Zellen besteht darin, das Zellenarray wie ein gewöhnliches Array durch Zuweisung zu erweitern.

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

Indizieren Sie in die erste Zeile von C. Wenn Sie mit runden Klammern () indizieren, ist das Ergebnis ein Zellenarray, das eine Untermenge des Zellenarrays ist.

C(1,:)

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

Indizieren Sie in den Inhalt einer Zelle. Wenn Sie mit geschweiften Klammern {} indizieren, ist das Ergebnis das Datenelement in der angegebenen Zelle.

C{1,2}

ans = 1×3

    56    67    78

Quadratisches Zellenarray

Erstellen Sie ein 3x3-Zellenarray aus leeren Matrizen.

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}

3-D-Zellenarray

Erstellen Sie ein 3x4x2-Zellenarray aus leeren Matrizen.

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

ans = 1×3

     3     4     2

Klonen der Größe eines vorhandenen Arrays

Erstellen Sie ein Zellenarray aus leeren Matrizen mit derselben Größe wie ein bestehendes Array.

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}

Es ist ein gängiges Muster, die beiden vorherigen Codezeilen zu einer einzigen Zeile zu kombinieren.

C = cell(size(A));

Tipps

• Ein Zellenarray aus leeren Matrizen mit der cell-Funktion zu erstellen, ist äquivalent zur Zuweisung einer leeren Matrix zum letzten Index eines neuen Zellenarrays. Diese zwei Ausdrücke sind beispielsweise äquivalent:

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

Erweiterte Fähigkeiten

C/C++ Codegenerierung

Generieren Sie C und C++ Code mit MATLAB® Coder™.

Hinweise zur Verwendung und Einschränkungen:

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

Thread-Based Environment

Führen Sie mithilfe von MATLAB® backgroundPool den Code im Hintergrund aus oder machen Sie den Code mit der Parallel Computing Toolbox™ ThreadPool schneller.

Diese Funktion bietet vollständige Unterstützung für thread-basierte Umgebungen. Weitere Informationen finden Sie unter Run MATLAB Functions in Thread-Based Environment.

Verteilte Arrays

Partitionieren von großen Arrays über den kombinierten Speicher Ihres Clusters mit Parallel Computing Toolbox™.

Hinweise zur Verwendung und Einschränkungen:

• Siehe distributed.cell (Parallel Computing Toolbox).

Versionsverlauf

Eingeführt vor R2006a

R2023b: Es werden Teilinhalte sowie Größe und Datentyp der Arrays in Zellen angezeigt

Von R2021b bis R2023b zeigte MATLAB alle Inhalte eines Arrays in einer Zelle an, wenn in der Anzeige ausreichend Platz für die Inhalte vorhanden war. Wenn für das Array nicht genug Platz vorhanden war, zeigte MATLAB so viel vom Array an, wie der Platz in der Anzeige erlaubte.

In Releases ab R2023b zeigt MATLAB, sofern nicht alle Inhalte eines Arrays in einer Zelle in der Anzeige Platz finden, so viel des Arrays an, wie die Anzeige erlaubt. Zusätzlich werden noch die Größe und der Datentyp des Arrays angezeigt. Beispielsweise zeigt MATLAB in Releases ab R2023b Teilinhalte sowie Größe und Datentyp einer Zelle an, die ein Array aus 100 Double-Werten enthält.

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

Wenn das erste Element des Arrays selbst zu groß für die Anzeige ist, z. B. ein Aufzählungsmitglied mit einem langen Namen, zeigt MATLAB nur die Größe und den Datentyp des Arrays an.

Die Funktion disp weist dasselbe Verhalten auf.

R2021b: Teilinhalte von Arrays in Zellen werden anstelle von Größe und Datentyp angezeigt

In Releases vor R2021b zeigte MATLAB alle Inhalte eines Arrays in einer Zelle an, sofern die Inhalte in der Anzeige Platz fanden. Wenn für das Array nicht genug Platz vorhanden war, zeigte MATLAB nur die Größe und den Datentyp des Arrays an.

In Releases ab R2021b zeigt MATLAB, sofern nicht alle Inhalte eines Arrays in der Anzeige Platz finden, anstelle der Größe und des Datentyps so viel des Arrays an, wie die Anzeige erlaubt. Beispielsweise zeigt MATLAB in Releases ab R2021b Teilinhalte einer Zelle an, die ein Array aus 100 Double-Werten enthält.

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

Wenn das erste Element des Arrays selbst zu groß für die Anzeige ist, z. B. ein Aufzählungsmitglied mit einem langen Namen, zeigt MATLAB nur die Größe und den Datentyp an.

Die Funktion disp weist dasselbe Verhalten auf.

R2019a: Die Erweiterung von Zellenarrays ist vergleichbar mit der Erweiterung allgemeiner Arrays

In Releases ab R2019a sind die Dimensionen eines erweiterten Zellenarrays stets konsistent, unabhängig davon, ob Sie für die Indizes geschweifte oder runde Klammern verwenden. Zuvor unterschieden sich die Ausgabedimensionen, wenn Sie nicht für alle Dimensionen Indizes angaben. Die Indizierung mit geschweiften Klammern entspricht nun dem vorherigen Verhalten der Indizierung mit runden Klammern, was mit der Erweiterung allgemeiner Arrays konsistent ist. Beispiel:

• Wenn C 1x2x3x4 ist, dann erweitern C(5,2)={3} und C{5,2}=3 C auf 5x2x3x4. Zuvor führte C{5,2}=3 zu einem 5x24-Array.

• Wenn C 0x5 oder 5x0 ist, erweitern C(3)={2} und C{3}=2 C auf 1x3. Zuvor führte C{3}=2 zu einem 1x5-Array, wenn C 0x5 war, und zu einem 3x1-Array, wenn C 5x0 war.

• Wenn C 0x2x3 ist, dann führen C(3)={2} und C{3}=2 zu Fehlern, weil nicht eindeutig ist, welche Dimension erweitert werden soll. Zuvor führte C{3}=2 zu einem 1x6-Array.

Siehe auch

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

Themen

• Erstellen eines Zellen-Arrays
• Preallocate Memory for Cell Array
• Zugreifen auf Daten in einem Zellen-Array