CKTIS / C++
std::ptrdiff_t — typ pro rozdíl ukazatelů
std::ptrdiff_t je implementací definovaný celočíselný typ se znaménkem z hlavičky <cstddef>. Je typem výsledku odečítání ukazatelů: vyjadřuje vzdálenost v prvcích, nikoli v bajtech, a může obsahovat záporné hodnoty.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstddef>
std::ptrdiff_t distance = last - first;std::ptrdiff_t, dostupný po vložení <cstddef>, je alias pro celočíselný typ se znaménkem zvolený implementací. Nepředpokládejte, že jde o int nebo long ani že má pevnou šířku. Vestavěné odečítání ukazatelů vrací výsledek tohoto typu.
U ukazatelů na prvky téhož pole znamená last - first rozdíl jejich indexů, nikoli počet bajtů. Ukazatel bezprostředně za koncem pole lze použít, ale nelze jej dereferencovat. Opačné pořadí operandů změní znaménko výsledku.
Odečítání ukazatelů do různých polí způsobuje nedefinované chování, i když jsou jejich adresy blízko sebe. Nedefinované chování způsobí také rozdíl, který nelze reprezentovat v rozsahu std::ptrdiff_t. Uložení výsledku do širšího typu samotné odečítání nenapraví.
Naproti tomu std::size_t je typ bez znaménka a používá se mimo jiné pro velikosti objektů v bajtech. Nepoužívejte jej k uložení potenciálně záporného rozdílu.
V příkladu ukazuje last bezprostředně za konec pole se čtyřmi prvky, takže last - first má hodnotu 4 a first - last má hodnotu -4. V testovaném prostředí program vypíše tyto hodnoty jako desetinná čísla. U implementace s dostatečným počtem bitů v bajtu však může být std::ptrdiff_t aliasem typu signed char. Přímý výpis těchto hodnot do std::cout pomocí << pak vypíše znaky místo desetinných čísel.
Příklady
#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';
}
Výsledek
4 -4
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.