add_matrixadd_matrixAddMatrixAddMatrix (Operator)

Name

add_matrixadd_matrixAddMatrixAddMatrix — Addiert zwei Matrizen.

Signatur

add_matrix( : : MatrixAID, MatrixBID : MatrixSumID)

Der Operator add_matrixadd_matrixAddMatrixAddMatrixAddMatrix berechnet die Summe 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 MatrixSumMatrixSumMatrixSumMatrixSummatrixSum mit dem Ergebnis generiert. Der Operator gibt das Matrix Handle MatrixSumIDMatrixSumIDMatrixSumIDMatrixSumIDmatrixSumID der Matrix MatrixSumMatrixSumMatrixSumMatrixSummatrixSum 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:

  MatrixSumMatrixSumMatrixSumMatrixSummatrixSum = 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.

MatrixSumIDMatrixSumIDMatrixSumIDMatrixSumIDmatrixSumID (output_control) matrix → (integer)

Matrix Handle mit den Summen der Eingabematrizen.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert add_matrixadd_matrixAddMatrixAddMatrixAddMatrix 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

add_matrix_modadd_matrix_modAddMatrixModAddMatrixModAddMatrixMod

Siehe auch

sub_matrixsub_matrixSubMatrixSubMatrixSubMatrix, sub_matrix_modsub_matrix_modSubMatrixModSubMatrixModSubMatrixMod

Modul

Foundation

Operatoren