CKTIS / C++
std::ptrdiff_t — tipo per la differenza tra puntatori
std::ptrdiff_t è un tipo intero con segno definito dall’implementazione, fornito da <cstddef>. È il tipo del risultato della sottrazione tra puntatori: rappresenta una distanza in elementi, non in byte, e può contenere valori negativi.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <cstddef>
std::ptrdiff_t distance = last - first;std::ptrdiff_t, disponibile dopo aver incluso <cstddef>, è un alias di un tipo intero con segno scelto dall’implementazione. Non dare per scontato che sia int o long, né che abbia una larghezza fissa. La sottrazione integrata tra puntatori produce un risultato di questo tipo.
Per puntatori a elementi dello stesso array, last - first indica la differenza tra i loro indici, non un numero di byte. È possibile usare un puntatore immediatamente oltre la fine dell’array, ma non dereferenziarlo. Invertire gli operandi inverte il segno del risultato.
Sottrarre puntatori ad array distinti causa comportamento indefinito, anche se i loro indirizzi sono vicini. Anche una differenza non rappresentabile nell’intervallo di std::ptrdiff_t causa comportamento indefinito. Memorizzare il risultato in un tipo più ampio non corregge la sottrazione stessa.
Al contrario, std::size_t è senza segno e viene usato, tra le altre cose, per le dimensioni degli oggetti in byte. Non usarlo per memorizzare una differenza potenzialmente negativa.
Nell’esempio, last punta immediatamente oltre la fine dell’array di quattro elementi, quindi last - first vale 4 e first - last vale -4. Nell’ambiente di test il programma stampa questi valori come numeri decimali. Tuttavia, in un’implementazione con un numero sufficiente di bit per byte, std::ptrdiff_t può essere un alias di signed char. In tal caso, inserire i valori direttamente in std::cout con << scrive caratteri anziché numeri decimali.
Esempi
#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';
}
Risultato
4 -4
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.