CKTIS / C++
Aftrekkende toewijzingsoperator (-=)
De operator -= trekt de rechteroperand af van de waarde van de linkeroperand en slaat het resultaat op in het linkerobject. Bij de ingebouwde operator wordt de linkeroperand maar één keer geëvalueerd; typeconversies en beperkingen voor pointerrekenkunde blijven gelden.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
lhs -= rhsDe ingebouwde expressie lhs -= rhs werkt als lhs = lhs - rhs, maar evalueert lhs slechts één keer. De linkerkant moet een wijzigbare lvalue zijn, bijvoorbeeld een variabele die niet const is. De expressie levert een lvalue op die naar hetzelfde object verwijst. De rechteroperand wordt vóór de linkeroperand geëvalueerd; toewijzingsoperatoren groeperen van rechts naar links.
Bij getallen gebruikt de aftrekking de gebruikelijke rekenkundige conversies; daarna wordt het resultaat geconverteerd naar het type van het linkerobject. Daarom slaat int count = 10; count -= 2.5; de waarde 7 op: de conversie laat het fractionele deel vervallen. Overflow bij signed integer-rekenkunde leidt tot ongedefinieerd gedrag; rekenkunde met een unsigned type werkt modulo 2^N. Houd rekening met promoties en conversies in plaats van aan te nemen dat de berekening plaatsvindt in het type van de linkerkant.
Een pointer naar een volledig objecttype kan -= met een integer gebruiken. De offset wordt uitgedrukt in elementen, niet in bytes. Als de pointer geen nullpointer is, moet het resultaat naar een element van dezelfde array wijzen of precies één positie voorbij het einde ervan liggen. In C++23 is p -= 0 goed gedefinieerd als p een nullpointer is: p blijft dan een nullpointer. Dat twee pointers met - van elkaar kunnen worden afgetrokken, betekent niet dat pointer -= other_pointer is toegestaan.
In het voorbeeld verhoogt values[i++] -= 3 i maar één keer. Klassentypen kunnen operator-= overloaden; het gedrag en het resultaatstype hangen af van de declaratie ervan, en gelijkwaardigheid aan lhs = lhs - rhs is niet gegarandeerd.
Voorbeelden
#include <iostream>
int main() {
int values[] = {10, 20};
int i = 0;
values[i++] -= 3;
int count = 10;
count -= 2.5;
std::cout << values[0] << ' ' << values[1] << ' ' << i << '\n';
std::cout << count << '\n';
}
Resultaat
7 20 1 7
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.