all

R2026b

Ermitteln, ob alle Array-Elemente ungleich null oder true sind

Syntax

B = all(A)

B = all(A,'all')

B = all(A,dim)

B = all(A,vecdim)

Beschreibung

B = all(A) prüft entlang der ersten Array-Dimension von A, deren Größe nicht 1 ist, und stellt fest, ob die Elemente alle ungleich null oder eine logische 1 (true) sind. In der Praxis ist all eine natürliche Erweiterung des logischen AND-Operators.

• Wenn A ein Vektor ist, gibt all(A) eine logische 1 (true) zurück, wenn alle Elemente ungleich null sind, und eine logische 0 (false) zurück, wenn mindestens ein Element null ist.

• Wenn A eine nicht leere Matrix ist, behandelt all(A) die Spalten von A als Vektoren und gibt einen Zeilenvektor aus logischen Einsen (1) und Nullen (0) zurück.

• Wenn A eine leere 0x0-Matrix ist, gibt all(A) eine logische 1 (true) zurück.

• Wenn A ein mehrdimensionales Array ist, operiert all(A) entlang der ersten Array-Dimension, deren Größe nicht 1 ist, und gibt ein Array aus logischen Werten zurück. Die Größe dieser Dimension wird 1, während alle anderen Dimensionen ihre Größe beibehalten.

B = all(A,'all') prüft alle Elemente von A. Diese Syntax ist für MATLAB^®-Versionen R2018b und später gültig.

B = all(A,dim) prüft die Elemente entlang der Dimension dim. Die dim-Eingabe ist ein positiver ganzzahliger Skalar.

B = all(A,vecdim) prüft die Elemente basierend auf den im Vektor vecdim angegebenen Dimensionen. Wenn beispielsweise A eine Matrix ist, prüft all(A,[1 2]) alle Elemente von A, da jedes Element einer Matrix in der Array-Schicht enthalten ist, die von den Dimensionen 1 und 2 definiert wird.

Beispiele

Spalten der Prüfmatrix

Erstellen Sie eine 3x3-Matrix und prüfen Sie jede Spalte auf alle Elemente, die ungleich null sind.

A = [0 0 3;0 0 3;0 0 3]

A = 3×3

     0     0     3
     0     0     3
     0     0     3

B = all(A)

B = 1×3 logical array

   0   0   1

Reduzieren eines logischen Vektors auf eine einzelne Bedingung

Erstellen Sie einen Vektor aus Dezimalwerten und prüfen Sie, welche Werte kleiner als 0,5 sind.

A = [0.53 0.67 0.01 0.38 0.07 0.42 0.69];
B = (A < 0.5)

B = 1×7 logical array

   0   0   1   1   1   1   0

Die Ausgabe ist ein Vektor logischer Werte. Die Funktion all reduziert einen solchen Vektor logischer Werte auf eine einzelne Bedingung. In diesem Fall ergibt B = all(A < 0.5) eine logische 0.

Dadurch ist all bei if-Anweisungen besonders nützlich.

if all(A < 0.5)

%do something

else

%do something else

end

Der Code wird in Abhängigkeit von einer einzelnen Bedingung und nicht von einem Vektor aus möglicherweise widersprüchlichen Bedingungen ausgeführt.

Prüfen von Arrays mit beliebigen Dimensionen

Erstellen Sie ein mehrdimensionales 3x7x5-Array und prüfen Sie, ob alle zugehörigen Elemente kleiner als 3 sind.

A = rand(3,7,5) * 5;
B = all(A(:) < 3)

B = logical
   0

Sie können das Array auch auf Elemente prüfen, die größer als null sind.

B = all(A(:) > 0)

B = logical
   1

Die Syntax A(:) wandelt die Elementen von A in einen einspaltigen Vektor um. Daher können Sie diese Art von Anweisung für ein Array mit beliebiger Größe verwenden.

Zeilen der Prüfmatrix

Erstellen Sie eine 3x3-Matrix.

A = [0 0 3;0 0 3;0 0 3]

A = 3×3

     0     0     3
     0     0     3
     0     0     3

Prüfen Sie die Zeilen von A auf alle Elemente ungleich null, indem Sie dim = 2 angeben.

B = all(A,2)

B = 3×1 logical array

   0
   0
   0

Elemente ungleich null auf einer Array-Seite

Erstellen Sie ein 3D-Array und stellen Sie auf jeder Datenseite (Zeilen und Spalten) fest, ob alle Elemente ungleich null vorhanden sind.

A(:,:,1) = [2 1; 3 5];
A(:,:,2) = [0 0; 0 0];
A(:,:,3) = [-2 9; 4 1];
B = all(A,[1 2])

B = 1×1×3 logical array
B(:,:,1) =

   1


B(:,:,2) =

   0


B(:,:,3) =

   1

Eingabeargumente

A — Eingabearray

Skalar | Vektor | Matrix | mehrdimensionales Array

Eingabearray, angegeben als Skalar, Vektor, Matrix oder mehrdimensionales Array.

Datentypen: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
Unterstützung komplexer Zahlen: Ja

dim — Dimension, entlang der die Operation erfolgt

positiver ganzzahliger Skalar

Dimension, entlang der die Operation erfolgt, angegeben als positiver ganzzahliger Skalar. Wenn Sie die Dimension nicht angeben, wird standardmäßig die erste Array-Dimension verwendet, deren Größe nicht 1 ist.

Angenommen, es liegt ein zweidimensionales Eingabearray, A, vor:

• all(A,1) wird für aufeinanderfolgende Elemente in den Spalten von A ausgeführt und gibt einen Zeilenvektor aus logischen Werten zurück.

• all(A,2) wird für aufeinanderfolgende Elemente in den Zeilen von A ausgeführt und gibt einen Spaltenvektor aus logischen Werten zurück.

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

vecdim — Vektor aus Dimensionen

Vektor positiver Ganzzahlen

Vektor aus Dimensionen, angegeben als Vektor positiver Ganzzahlen. Jedes Element stellt eine Dimension des Eingabearray dar. Die Längen der Ausgabe in den angegebenen Ausführungsdimensionen sind gleich 1, während die anderen unverändert bleiben.

Angenommen, es liegt ein 2x3x3-Eingabearray, A, vor. Dann gibt all(A,[1 2]) ein 1x1x3-Array zurück, dessen Elemente Werte ungleich null für jede Seite von A anzeigen.

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

Ausgabeargumente

B — Logisches Array

Skalar | Vektor | Matrix | mehrdimensionales Array

Logisches Array, zurückgegeben als Skalar, Vektor, Matrix oder mehrdimensionales Array. Die Dimension von A, auf die all angewendet wird, weist in B die Größe 1 auf.

Erweiterte Fähigkeiten

Tall Arrays

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

Die Funktion all bietet vollständige Unterstützung für Tall-Arrays. 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:

• Für das Eingabeargument A:

  • Wenn Sie keine Dimension angeben, wird der Codegenerator an der ersten Dimension des Eingabearrays ausgeführt, deren Größe variabel ist oder nicht 1 beträgt. Wenn diese Dimension zum Zeitpunkt der Codegenerierung eine variable Größe aufweist oder zur Laufzeit 1 beträgt, kann es zu einem Laufzeitfehler kommen. Geben Sie die Dimension an, um diesen Fehler zu vermeiden.

  • Wenn alle Dimensionen des Eingabearrays zum Zeitpunkt der Codegenerierung eine variable Größe aufweisen, darf das Array zur Laufzeit nicht leer sein.

• Das Argument dim, so verwendet, muss zum Zeitpunkt der Codegenerierung eine Konstante sein.

GPU-Codegenerierung

Generieren von CUDA® Code für NVIDIA® Grafikprozessoren mit dem GPU Coder™.

Siehe die Verwendungshinweise und Einschränkungen im Abschnitt zur C/C++ Codegenerierung. Dieselben Verwendungshinweise und Einschränkungen gelten auch für die Grafikkarten-Codegenerierung.

HDL-Codegenerierung

Generieren von VHDL, Verilog und SystemVerilog Code für FPGA- und ASIC-Designs mit HDL Coder™.

Doppelte Datentypen werden nicht unterstützt.

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.

Die Funktion all 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™.

Die Funktion all bietet vollständige Unterstützung für Grafikkarten-Arrays. Zum Ausführen der Funktion auf einer Grafikkarte geben Sie die Eingabedaten als gpuArray (Parallel Computing Toolbox) an. 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™.

Die Funktion all 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

Siehe auch

any | and | allunique | colon | prod | sum

Themen

• Reduce Logical Arrays to Single Value