sub_matrixsub_matrixSubMatrixSubMatrix (Operator)

Name

sub_matrixsub_matrixSubMatrixSubMatrix — Subtraktion zweier Matrizen.

Signatur

sub_matrix( : : MatrixAID, MatrixBID : MatrixSubID)

Der Operator sub_matrixsub_matrixSubMatrixSubMatrixSubMatrix berechnet die Differenz der Eingabematrizen MatrixAMatrixAMatrixAMatrixAmatrixA und MatrixBMatrixBMatrixBMatrixBmatrixB, die durch die Matrix Handles MatrixAIDMatrixAIDMatrixAIDMatrixAIDmatrixAID und MatrixBIDMatrixBIDMatrixBIDMatrixBIDmatrixBID gegeben sind. Beide Eingabematrizen müssen die gleichen Dimensionen besitzen. Es wird eine neue Matrix MatrixSubMatrixSubMatrixSubMatrixSubmatrixSub mit dem Ergebnis generiert. Der Operator gibt das Matrix Handle MatrixSubIDMatrixSubIDMatrixSubIDMatrixSubIDmatrixSubID der Matrix MatrixSubMatrixSubMatrixSubMatrixSubmatrixSub zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix möglich. Die Formel für die Berechnung lautet:

  MatrixSubMatrixSubMatrixSubMatrixSubmatrixSub = MatrixAMatrixAMatrixAMatrixAmatrixA - MatrixBMatrixBMatrixBMatrixBmatrixB.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

MatrixAIDMatrixAIDMatrixAIDMatrixAIDmatrixAID (input_control) matrix → (integer)

Matrix Handle der Eingabematrix A.

MatrixBIDMatrixBIDMatrixBIDMatrixBIDmatrixBID (input_control) matrix → (integer)

Matrix Handle der Eingabematrix B.

MatrixSubIDMatrixSubIDMatrixSubIDMatrixSubIDmatrixSubID (output_control) matrix → (integer)

Matrix Handle mit den Differenzen der Eingabematrizen.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert sub_matrixsub_matrixSubMatrixSubMatrixSubMatrix den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrix

Alternativen

sub_matrix_modsub_matrix_modSubMatrixModSubMatrixModSubMatrixMod

Siehe auch

add_matrixadd_matrixAddMatrixAddMatrixAddMatrix, add_matrix_modadd_matrix_modAddMatrixModAddMatrixModAddMatrixMod

Modul

Foundation

Operatoren