Subtraktions-Zuweisung -=

Der Subtraktions-Zuweisungs-Operator subtrahiert den Wert, der rechts des Operators steht vom Wert der links des Operator stehenden Variablen ab und speichert das Resultat zurück in die Variable.

5

#include <stdio.h>

int main(){
  int a = 15;
  a -= 10;
  printf("%d\n", a);
}

Siehe auch Zuweisungs-Operator =, Subtraktions-Operator -

Details

Der Subtraktions-Zuweisungs-Operator erwartet links einen lvalue und rechts einen rvalue und wird von rechts nach links abgearbeitet. Der Rückgabewert ist in C ein rvalue: Der Wert des linken Operanden nach der Zuweisung. in C++ ist der Rückgabewert ein lvalue: Der (mittlerweile zugewiesene) linke Operand selbst.

Der Subtraktions-Zuweisungs-Operator verhält sich genau gleich wie der Zuweisungsoperator, nur dass er eine zusätzliche Subtraktion ausführt. Für Details über die Eigenschaften einer Subtraktions-Zuweisung wird hier somit auf die Beschreibung des Zuweisungsoperators und des Subtraktions-Operators verwiesen. Als zusätzliche Erläuterung des Subtraktions-Zuweisungs-Operators im Bezug zum einfachen Zuweisungsoperator genügen folgende zwei Programmzeilen, welche absolut äquivalent sind:

  a -=      10;
  a  = a - (10);

Die gesetzten runden Klammern deuten an, dass aufgrund der Operatoren-Rangordnung bei der Subtraktions-Zuweisung genauso wie bei allen Zuweisungs-Operatoren der komplette rechte Teil nach den Gleichheitszeichen als EIN Operand ausgewertet wird.

Überladen des Operators

Der Subtraktions-Zuweisungs-Operator hat grundsätzlich die semantische Bedeutung einer Subtraktion eines Wertes von einer Variablen und anschliessender Zuweisung des Resultates zu derselben. Allerdings steht es dem Programmierer frei, eine andere Semantik zu definieren.

Die Prototypen für das Überladen des Subtraktions-Zuweisungs-Operators sind die folgenden (Einschränkungen und Erläuterungen siehe Überladen von Operatoren):

inside class


outside class

Type operator -=(Type);
Type operator -=(Type) const;

Type operator -=(Type, Type);

Man beachte, dass der Subtraktions-Zuweisungs-Operator im Gegensatz zum einfachen Zuweisungs-Operator sowohl innerhalb als auch ausserhalb der Klasse überladen werden kann, obschon gewisse Quellen dies nicht erlauben. Es ist jedoch grundsätzlich zu empfehlen, Zuweisungs-Operatoren nicht ausserhalb der Klasse zu definieren.

Ausserdem ist zu beachten, dass überladene Zuweisungs-Operatoren angeblich nicht über Klassen vererbt werden. Der Autor konnte diese Aussage jedoch noch nicht evaluieren.

Da der Subtraktions-Zuweisungs-Operator in C++ normalerweise einen lvalue zurückgibt, ist der Rückgabetyp der Überladung üblicherweise ein Referenz-Typ (&) der eigenen Klasse, wobei der Rückgabewert normalerweise mit return *this angegeben wird.

Der const-Prototyp macht auf den ersten Moment keinen Sinn, da bei einer Zuweisung im herkömmlichen Sinne das betroffene Objekt immer verändert wird. Man beachte jedoch, dass Felder von Klassen mittels der mutable-Speicherklasse deklariert werden können, was es ermöglicht, einen Subtraktions-Zuweisungs-Operator als konstant zu deklarieren. Bei Auftreten beider Prototyp-Varianten in einer Klasse wird jedoch grundsätzlich (ohne die Notwendigkeit eines const-Aufrufes) die nicht-const-Überladung aufgerufen.

Im folgenden Beispiel wird eine Klasse präsentiert für einen zweidimensionalen Vektor. Gemäss der Vektoralgebra wird eine Subtraktion eines Skalarwertes von einem Vektor als die komponentenweise Subtraktion des Wertes von den Vektorfeldern beschrieben.

10.000000, 20.000000

9.000000, 19.000000

#include <cstdio>

class Vector2{
  float a[2];
public:
  Vector2(float x, float y){a[0]=x; a[1]=y;}
  void print(){printf("%f, %f\n", a[0], a[1]);}
  
  Vector2& operator -=(float s){
    a[0] -= s; a[1] -= s;
    return *this;
  }
};

int main(){
  Vector2 v(10, 20);
  v.print();
  v -= 1;
  v.print();
  return 0;
}