学习 LLVM(7) PointerUnion 类

PointerUnion 类当前我知道用在 TinyPtrVector 中作为底层数据存放。简单说明一下。

定义在文件 llvm/include/llvm/[[ADT]]/[[PointerUnion.h]] 中。

== 概述 ==
实现联合保存两种不一样的可区分类型的指针，将区分位保存在指针的最低位（NumLowBitsAvailable）。这种方式在空间上是极其节省的，但能够使用很是天然和类型安全的 API。

This implements a discriminated union of two pointer types,
and keeps the discriminator bit-mangled into the low bits of the pointer.
This allows the implementation to be extremely efficient in space, but
permits a very natural and type-safe API.

参见：
* [[PointerUnionTypeSelectorReturn]]
* [[PointerUnionTypeSelector]]
* [[PointerUnionUIntTraits]]
* [[PointerIntPair]]

（注：对它们的描述略）

== 实现机理 ==
模板类 PointerUnion 概要以下：

<syntaxhighlight lang="cpp">
  template <PT1, PT2> class PointerUnion {
    PointerIntPair<...> Val;  // 注1
   
    PointerUnion()  // 多种构造函数，注2
    isNull() -- 若是指针为 null 则返回 true，和类型无关
    is<PT1>(), is<PT2>() -- 返回 true 若是指针是类型 PT1, PT2
    get<PT1>(), get<PT2>() -- 返回指针
    // 其它函数略
  }
</syntaxhighlight>

* 注1: PointerIntPair<void*, 1, ...> 参见 [[PointerIntPair]]，表示一个指针+1位的整数。
* 注2：当构造为 PT1* 时，Val.int = 0；当指针为 PT2* 时，Val.int = 1

== 评述 ==
在一个 void* 空间中保存两种类型的指针，以指针的低位 bit 来保存指针类型，看起来很麻烦。
用起来也要当心，用途很少的话，还不如不要这么麻烦，多放一个字节来保存类型信息也很好的。

实现的 PointerUnion3, PointerUnion4 与此相似，都十分辛苦但没有必要？？

参见： * [[TinyPtrVector]]