CKTIS / C++
std::ptrdiff_t — tipo de diferencia entre punteros
std::ptrdiff_t es un tipo entero con signo definido por la implementación y declarado en <cstddef>. Es el tipo de resultado de restar punteros: representa una distancia en elementos, no en bytes, y puede contener valores negativos.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <cstddef>
std::ptrdiff_t distance = last - first;std::ptrdiff_t, disponible al incluir <cstddef>, es un alias de un tipo entero con signo elegido por la implementación. No supongas que es int o long, ni que tiene una anchura fija. La resta integrada de punteros produce un resultado de este tipo.
Para punteros a elementos de una misma matriz, last - first representa la diferencia entre sus índices, no una cantidad de bytes. Se puede usar un puntero situado justo después del final de la matriz, pero no se debe desreferenciar. Invertir los operandos invierte el signo del resultado.
Restar punteros a matrices distintas provoca comportamiento indefinido, aunque sus direcciones estén próximas. Una diferencia que no pueda representarse en std::ptrdiff_t también provoca comportamiento indefinido. Guardar el resultado en un tipo más amplio no corrige la resta en sí.
En cambio, std::size_t no tiene signo y se usa, entre otras cosas, para los tamaños de objetos en bytes. No lo uses para guardar una diferencia que podría ser negativa.
En el ejemplo, last apunta justo después del final de la matriz de cuatro elementos, así que last - first vale 4 y first - last vale -4. En el entorno probado, el programa imprime esos valores como números decimales. Sin embargo, en una implementación cuyos bytes tengan suficientes bits, std::ptrdiff_t puede ser un alias de signed char. En ese caso, insertar los valores directamente en std::cout con << escribe caracteres en lugar de números decimales.
Ejemplos
#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';
}
Resultado
4 -4
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.