CKTIS / C++
std::ptrdiff_t — Typ für Zeigerabstände
std::ptrdiff_t ist ein implementierungsdefinierter vorzeichenbehafteter Ganzzahltyp aus <cstddef>. Er ist der Ergebnistyp der Zeigersubtraktion, bezeichnet einen Abstand in Elementen statt in Bytes und kann negative Werte speichern.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cstddef>
std::ptrdiff_t distance = last - first;std::ptrdiff_t ist nach dem Einbinden von <cstddef> verfügbar und ein Alias für einen von der Implementierung ausgewählten vorzeichenbehafteten Ganzzahltyp. Gehe weder davon aus, dass es int oder long ist, noch dass es eine festgelegte Breite hat. Die eingebaute Zeigersubtraktion liefert einen Wert dieses Typs.
Bei Zeigern auf Elemente desselben Arrays bezeichnet last - first die Differenz ihrer Indizes, nicht eine Anzahl von Bytes. Ein Zeiger direkt hinter dem Ende des Arrays darf verwendet, aber nicht dereferenziert werden. Werden die Operanden vertauscht, ändert sich das Vorzeichen des Ergebnisses.
Die Subtraktion von Zeigern auf getrennte Arrays führt zu undefiniertem Verhalten, selbst wenn ihre Adressen nahe beieinanderliegen. Auch eine Differenz, die nicht im Wertebereich von std::ptrdiff_t darstellbar ist, führt zu undefiniertem Verhalten. Das Speichern des Ergebnisses in einem breiteren Typ behebt die Subtraktion selbst nicht.
Im Gegensatz dazu ist std::size_t vorzeichenlos und wird unter anderem für Objektgrößen in Bytes verwendet. Verwende es nicht, um eine möglicherweise negative Differenz zu speichern.
Im Beispiel zeigt last direkt hinter das Ende des Arrays mit vier Elementen. Daher ist last - first gleich 4 und first - last gleich -4. In der getesteten Umgebung gibt das Programm diese Werte als Dezimalzahlen aus. Bei einer Implementierung mit ausreichend breiten Bytes kann std::ptrdiff_t jedoch ein Alias für signed char sein. Werden die Werte dann mit << direkt an std::cout übergeben, gibt der Stream Zeichen statt Dezimalzahlen aus.
Beispiele
#include <cstddef>
#include <iostream>
int main() {
int values[] = {10, 20, 30, 40};
const int* first = values;
const int* last = values + 4;
std::ptrdiff_t forward = last - first;
std::ptrdiff_t backward = first - last;
std::cout << forward << '\n' << backward << '\n';
}
Ergebnis
4 -4
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.