__GNU_CXX::_RELATIVE_POINTER_IMPL(3)

💖 NAME 💖

__gnu_cxx::_Relative_pointer_impl< _Tp > — bestie, it's a storage policy you pair up with _Pointer_adapter<>, and instead of hoarding the pointer's whole absolute address, it just keeps the address as an offset value that's relative to its own address. so cute, so portable ✨

---

🌸 SYNOPSIS 🌸

#include <pointer.h>

Inherited by __gnu_cxx::_Pointer_adapter< _Relative_pointer_impl< _Tp > >, __gnu_cxx::_Pointer_adapter< _Relative_pointer_impl< void > >, and __gnu_cxx::_Pointer_adapter< _Relative_pointer_impl< const void > >. yes, three whole glow-ups inherited from this one 🫶

✨ Public Types ✨

• typedef _Tp element_type — the element type it's repping, no notes 💅

🎀 Public Member Functions 🎀

• _Tp * get () const — hands you back the pointer, that's it, that's the whole vibe
• bool operator< (const _Relative_pointer_impl &__rarg) const — less-than comparison against another _Relative_pointer_impl named __rarg
• bool operator== (const _Relative_pointer_impl &__rarg) const — equality check against that same __rarg friend
• void set (_Tp *__arg) — sets the pointer from __arg, slay

---

🦋 Detailed Description 🦋

template<typename _Tp>
class __gnu_cxx::_Relative_pointer_impl< _Tp >

A storage policy for use with _Pointer_adapter<> which stores the pointer's address as an offset value which is relative to its own address.

okay so here's the why, and it's actually iconic: this is intended for pointers within shared memory regions which might be mapped at different addresses by different processes. like, the address you get is not the address your bestie gets, and this policy is unbothered by that fr fr 🌈

For null pointers, a value of 1 is used. and before you come for it — 0 is legitimate sometimes for nodes in circularly linked lists, so that's exactly why 1 got the job. This value was chosen as the least likely to generate an incorrect null, As there is no reason why any normal pointer would point 1 byte into its own pointer address. the logic? ate. no crumbs. periodt 💀✨

not me being obsessed with a null sentinel value that was picked purely because it's statistically the most awkward address possible 😭

---

👑 Author 👑

Generated automatically by Doxygen for libstdc++ from the source code. it wasn't a person, it was a whole pipeline, and honestly? respect 🫶

---

mwah 💖 that's the whole page, bestie. this one comes from the libstdc++ manual, filed under __gnu_cxx:...mpl< _Tp >(3) — go forth and offset your pointers relative to yourself, it's giving main character energy 🎀🦋