rem

Rest nach Division

Syntax

r = rem(a,b)

Beschreibung

r = rem(a,b) gibt den Rest nach einer Division von a durch b zurück, wobei a der Dividend und b der Divisor ist. Diese Funktion wird oft als Restoperation bezeichnet und kann als r = a - b.*fix(a./b) ausgedrückt werden. Die Funktion rem befolgt die Konvention, dass rem(a,0) NaN ist.

Beispiele

Rest nach Division eines Skalars

Berechnen Sie den Rest, nachdem Sie 5 durch 23 dividiert haben.

a = 23;
b = 5;
r = rem(a,b)

r = 
3

Rest nach Division eines Vektors

Finden Sie den Rest nach einer Division für einen Vektor aus Ganzzahlen mit dem Divisor 3.

a = 1:5;
b = 3;
r = rem(a,b)

r = 1×5

     1     2     0     1     2

Rest nach Division für positive und negative Werte

Finden Sie den Rest nach einer Division für eine Reihe von Ganzzahlen, einschließlich positiver und negativer Werte. Beachten Sie, dass Ergebnisse ungleich null das gleiche Vorzeichen haben wie der Dividend.

a = [-4 -1 7 9];
b = 3;
r = rem(a,b)

r = 1×4

    -1    -1     1     0

Rest nach Division für Gleitkommawerte

Ermitteln Sie den Rest nach Division für mehrere Winkel mithilfe eines Divisors von 2*pi. rem versucht nach Möglichkeit, präzise ganzzahlige Ergebnisse zu berechnen, indem Rundungseffekte bei Gleitkommazahlen ausgeglichen werden.

theta = [0.0 3.5 5.9 6.2 9.0 4*pi];
b = 2*pi;
r = rem(theta,b)

r = 1×6

         0    3.5000    5.9000    6.2000    2.7168         0

Eingabeargumente

a — Dividend

Skalar | Vektor | Matrix | mehrdimensionales Array | Tabelle | Timetable

Dividend, angegeben als Skalar, Vektor, Matrix, mehrdimensionales Array, Tabelle oder Timetable. a muss ein reellwertiges Array mit beliebigem numerischem Typ sein. Die Eingaben a und b müssen entweder dieselbe Größe oder kompatible Größen aufweisen (a ist beispielsweise eine M-mal-N-Matrix und b ein Skalar oder ein 1-mal-N-Zeilenvektor). Weitere Informationen finden Sie unter Kompatible Arraygrößen für Basisoperationen.

Wenn a ein duration-Array und b ein numerisches Array ist, werden die Werte in b als Anzahl von 24-Stunden-Tagen behandelt.

Wenn eine Eingabe einen Ganzzahl-Datentyp aufweist, muss die andere Eingabe denselben Ganzzahl-Datentyp aufweisen oder ein Skalar double sein.

Datentypen: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration | char | table | timetable

b — Divisor

Skalar | Vektor | Matrix | mehrdimensionales Array | Tabelle | Timetable

Divisor, angegeben als Skalar, Vektor, Matrix, mehrdimensionales Array, Tabelle oder Timetable. b muss ein reellwertiges Array mit beliebigem numerischem Typ sein. Die Eingaben a und b müssen entweder dieselbe Größe oder kompatible Größen aufweisen (a ist beispielsweise eine M-mal-N-Matrix und b ein Skalar oder ein 1-mal-N-Zeilenvektor). Weitere Informationen finden Sie unter Kompatible Arraygrößen für Basisoperationen.

Wenn b ein duration-Array und a ein numerisches Array ist, werden die Werte in a als Anzahl von 24-Stunden-Tagen behandelt.

Wenn eine Eingabe einen Ganzzahl-Datentyp aufweist, muss die andere Eingabe denselben Ganzzahl-Datentyp aufweisen oder ein Skalar double sein.

Datentypen: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration | char | table | timetable

Mehr über

Unterschiede zwischen mod und rem

Das Konzept eines Rests nach der Division ist nicht eindeutig definiert und die zwei Funktionen mod und rem berechnen jeweils unterschiedliche Varianten. Die Funktion mod erzeugt ein Ergebnis, das entweder Null ist oder dasselbe Vorzeichen wie der Divisor aufweist. Die Funktion rem erzeugt ein Ergebnis, das entweder Null ist oder dasselbe Vorzeichen wie der Dividend aufweist.

Ein weiterer Unterschied ist die Konvention bei einem Divisor von Null. Die Funktion mod befolgt die Konvention, dass mod(a,0) a zurückgibt; die Funktion rem befolgt die Konvention, dass rem(a,0) NaN zurückgibt.

Beide Varianten haben ihre eigenen Anwendungsfälle. In der Signalverarbeitung ist die Funktion mod beispielsweise im Kontext periodischer Signale nützlich, da ihre Ausgabe periodisch ist (mit einer Periode gleich dem Divisor).

Erweiterte Fähigkeiten

Tall Arrays

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

Die Funktion rem 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:

• Der generierte Code führt die Arithmetik mithilfe der Ausgabeklasse durch. Die Ergebnisse könnten aufgrund von Unterschieden bei den Rundungsfehlern nicht den MATLAB^®-Ergebnissen entsprechen.

• Wenn eine der Eingaben den Typ int64 oder uint64 aufweist, müssen beide Eingaben denselben Typ aufweisen.

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.

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 rem 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 rem 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 rem 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

R2023a: Direkte Durchführung von Berechnungen für Tabellen und Timetables

Die Funktion rem kann die Berechnung mit allen Variablen in einer Tabelle oder einem Timetable ausführen, ohne für den Zugriff auf diese Variablen eine Indizierung zu benötigen. Alle Variablen müssen Datentypen aufweisen, die die Berechnung unterstützen. Weitere Informationen finden Sie unter Direct Calculations on Tables and Timetables.

Siehe auch

mod