cell2mat

Konvertieren eines Zellenarrays in ein gewöhnliches Array

Syntax

A = cell2mat(C)

Beschreibung

A = cell2mat(C) konvertiert ein Zellenarray in ein gewöhnliches Array.

Die Inhalte von C müssen die Verknüpfung in ein N-dimensionales Rechteck unterstützen. Anderenfalls sind die Ergebnisse undefiniert. Beispielsweise müssen die Inhalte der Zellen in derselben Spalte zwar dieselbe Anzahl von Spalten, nicht jedoch dieselbe Anzahl von Zeilen aufweisen.

Beispiele

Konvertieren eines Zellenarrays in ein numerisches Array

Konvertieren Sie numerische Arrays in vier Zellen eines Zellenarrays in ein numerisches Array.

C = {[1],    [2 3 4];
     [5; 9], [6 7 8; 10 11 12]}

C=2×2 cell array
    {[       1]}    {[   2 3 4]}
    {2×1 double}    {2×3 double}

A = cell2mat(C)

A = 3×4

     1     2     3     4
     5     6     7     8
     9    10    11    12

Konvertieren eines Zellenarrays mit Strukturen in ein Array

Konvertieren Sie Strukturen in einem Zellenarray in ein Strukturarray. Die Strukturen müssen dieselben Felder aufweisen.

s1.a = [1 2 3 4];
s1.b = 'Good';
s2.a = [5 6; 7 8];
s2.b = 'Morning';
c = {s1,s2};
d = cell2mat(c)

d=1×2 struct array with fields:
    a
    b

Zeigen Sie das erste Feld der Struktur d(1) an.

d(1).a

ans = 1×4

     1     2     3     4

Zeigen Sie das zweite Feld von d(2) an.

d(2).b

ans = 
'Morning'

Konvertieren eines Zellenarrays mit unterschiedlichen Datentypen

Seit R2025a

Konvertieren Sie ein Zellenarray mit verschiedenen Datentypen in ein gewöhnliches Array.

Erstellen Sie ein Zellenarray mit single- und double-Werten.

a = single([1 2 3]);
b = double([2 4 6]);
C = {a;b}

C =

  2×1 cell array

    {[1 2 3]}
    {[2 4 6]}

Konvertieren Sie das Zellenarray in ein numerisches Array. Das resultierende Array ist single.

D = cell2mat(C)

D =

  2×3 single matrix

     1     2     3
     2     4     6

Eingabeargumente

C — Eingabe-Zellenarray

Zellenarray

Eingabe-Zellenarray. Wenn die Inhalte der Zellen denselben Datentyp aufweisen, weist das resultierende Array ebenfalls diesen Datentyp auf. Die Funktion kann Zellen verknüpfen, die Strukturen enthalten, sofern diese Strukturen identische Feldnamen aufweisen.

Die Zellen können verschiedene Datentypen aufweisen, wenn MATLAB^® die Datentypen in einen Ausgabetyp konvertieren kann. Beispiele zu grundlegenden Datentyp-Kombinationen und den resultierenden Typen finden Sie unter Valid Combinations of Unlike Classes.

cell2mat akzeptiert zudem Zellenarrays mit klassenbasierten Objekten. Informationen zur Kombination klassenbasierter Objekte finden Sie unter Concatenating Objects of Different Classes.

cell2mat akzeptiert keine verschachtelten Zellen in C.

Erweiterte Fähigkeiten

Tall Arrays

Rechnen mit Arrays, die mehr Zeilen haben, als in den Speicher passen.

Die Funktion cell2mat unterstützt Tall-Arrays mit folgenden Verwendungshinweisen und Einschränkungen:

• Die Zellen des Eingabe-Zellenarrays müssen numerische, logische oder Zeichen-Datentypen enthalten.

Weitere Informationen finden Sie unter Tall-Arrays.

C/C++ Codegenerierung

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

Hinweise zur Verwendung und Einschränkungen:

• Die Codegenerierung wird für die Funktion cell2mat nicht für unbeschränkte Zellenarrays oder Zellenarrays variabler Größe unterstützt, die dünn besetzte Arrays enthalten.

• Arrays oder Strukturen, die in einer Eingabe mit unbeschränkten Zellenarrays oder Zellenarrays variabler Größe vorliegen und eine Dimension größer als 2 aufweisen, werden für die Codegenerierung mit der Funktion cell2mat nicht unterstützt.

• Für eine Eingabe, die zur Laufzeit leere Zellen aufweist, gibt cell2mat eine leere Zelle desselben Datentyps zurück. Für eine Eingabe, die zur Kompilierungszeit leere Zellen aufweist, gibt cell2mat eine leere Zelle des Typs double zurück.

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.

GPU-Arrays

Schnellere Codeausführung durch Ausführen auf einer Grafikkarte (GPU) mit der Parallel Computing Toolbox™. (seit R2025a)

Die Funktion cell2mat unterstützt Zellenarrays mit gpuArray (Parallel Computing Toolbox)-Objekten vollständig. Weitere Informationen finden Sie unter Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Verteilte Arrays

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

Diese Funktion bietet vollständige Unterstützung für verteilte Arrays. Weitere Informationen finden Sie unter Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Versionsverlauf

Eingeführt vor R2006a

R2025a: Zellenarray-Elemente können verschiedene Datentypen enthalten

Vor R2025a akzeptierte cell2mat numerische, logische und Zeichentypen sowie Strukturen mit identischen Feldnamen. Alle Zellen des Eingabearrays mussten denselben Datentyp aufweisen.

cell2mat kann nun Zellenarrays mit zusätzlichen Datentypen akzeptieren, darunter Strings, kategorische Variablen, gpuArray-Objekte und klassenbasierte Objekte.

Die Funktion kann zudem ein Zellenarray mit verschiedenen Datentypen konvertieren, wen MATLAB diese Datentypen in einen Ausgabetyp konvertieren kann. Beispiele zu grundlegenden Datentyp-Kombinationen und den resultierenden Typen finden Sie unter Valid Combinations of Unlike Classes.

Wenn das Zellenarray klassenbasierte Objekte unterschiedlicher Klassen enthält, versucht MATLAB, diese zu verknüpfen. Weitere Informationen finden Sie unter Concatenating Objects of Different Classes.

Siehe auch

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