这里的 struct handlemap 就是这样的一张 hash 表。而 handleid 目前被定义为 unsigned int ，可以在实际使用时定义为其它字长的整数。

一共提供了 5 个 API ：

struct handlemap * handlemap_init();
void handlemap_exit(struct handlemap *);

分别是创建和销毁 handlemap 结构，没什么好说的。和 skynet 的实现不同，这里做了一些简化。在销毁 handlemap 时，暂时没有手段去清理里面那些还没有删除的 id 。

我认为在实际使用时，可以通过外部手段去解决。

• handleid handlemap_new(struct handlemap *, void *ud); 就是为 ud 分配并绑定一个 id 。这个操作一般会成功，但在很少情况下会因为内存不足而失败。失败则返回 0 。 0 在整个系统中永远表示无效 id 。

• void * handlemap_grab(struct handlemap *, handleid id); 取出 id 对应的对象指针，并在内部增加对它的引用。如果 id 无效，那么会返回 NULL 指针。在实现时，采用了引用计数用来满足线程安全。

• void * handlemap_release(struct handlemap *, handleid id); 当使用完对象指针后，应该调用这个 api 归还 id 的引用。另外，如果希望删除这个 id 也可以调用它。无论是归还引用还是删除，都必须检查这个 api 的返回值。当返回值不为 NULL 时，表示返回的这个 ud 已经脱离了 handlemap 的管理，通常你需要删除这个对象。

这个数据结构的实现难点在于需要线程安全。在不同的线程中可以并发去 grab 对象，同时也可以安全的删除它们。

我使用了一个读写锁来保证线程安全：

在创建新 id ，或当一个 id release 的时候引用减到零，都会加上写锁，完成成 handlemap 的修改。

而获取（grab）或释放 （release ）id 时，则是加的读锁，这些操作是可以并发的。

btw, 和 skynet 不同，这份实现里我支持了 windows 的原子操作 api 。但没有仔细测试，如果有兴趣的同学可以试着用 VC 编译。