KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::ptrdiff_t — type voor pointerverschillen

std::ptrdiff_t is een implementatiegedefinieerd geheel-getaltype met teken uit <cstddef>. Het is het resultaattype van pointeraftrekking: het geeft een afstand in elementen aan, niet in bytes, en kan negatieve waarden bevatten.

Versie: C++23; repository compiler flag, production runtime not attested

Syntax

#include <cstddef>
std::ptrdiff_t distance = last - first;

std::ptrdiff_t is beschikbaar na het includeren van <cstddef> en is een alias voor een door de implementatie gekozen geheel-getaltype met teken. Ga er niet van uit dat het int of long is, of dat het een vaste breedte heeft. Ingebouwde pointeraftrekking levert een resultaat van dit type op.

Voor pointers naar elementen van dezelfde array betekent last - first het verschil tussen hun indexen, niet een aantal bytes. Een pointer direct voorbij het einde van de array mag worden gebruikt, maar niet worden gedereferentieerd. Als je de operanden omwisselt, verandert het teken van het resultaat.

Pointers naar verschillende arrays van elkaar aftrekken veroorzaakt ongedefinieerd gedrag, ook als hun adressen dicht bij elkaar liggen. Een verschil dat niet binnen het bereik van std::ptrdiff_t kan worden weergegeven, veroorzaakt eveneens ongedefinieerd gedrag. Het resultaat opslaan in een breder type herstelt de aftrekking zelf niet.

std::size_t is daarentegen een type zonder teken en wordt onder meer gebruikt voor objectgroottes in bytes. Gebruik het niet om een mogelijk negatief verschil op te slaan.

In het voorbeeld wijst last direct voorbij het einde van de array met vier elementen. Daardoor is last - first gelijk aan 4 en first - last gelijk aan -4. In de geteste omgeving geeft het programma die waarden weer als decimale getallen. Bij een implementatie met voldoende bits per byte kan std::ptrdiff_t echter een alias voor signed char zijn. Als je de waarden dan met << rechtstreeks naar std::cout stuurt, worden er tekens geschreven in plaats van decimale getallen.

Voorbeelden

#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';
}

Resultaat

4
-4

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.

Bronnen