DPDK 20.08中rte_hash_lookup_data()返回0的场景是什么

rte_hash_lookup_data()在DPDK 20.08版本中返回0是合法的正常返回场景，不属于错误，对应场景和逻辑如下：

• 核心原因：DPDK哈希表内部对存储条目的索引是从0开始编号的，并非从1开始计数。当待查找的key成功匹配哈希表中索引为0的有效条目时，接口就会返回0。这个返回值和其他大于0的返回值语义完全一致，就是可供调用方索引用户数据数组的合法偏移量，不属于-EINVAL、-ENOENT这类负错误码范畴。
• 文档偏差说明：DPDK 20.08的官方接口文档对返回值的描述存在疏漏，仅提及返回值为"可用作偏移量的正值"，没有明确说明偏移量从0起始，0本身就是合法返回值，容易误导开发者认为0是非预期返回。
• 常见编码踩坑：判断查找失败的正确逻辑是校验返回值是否小于0，即使用if (ret < 0)进入错误处理分支，禁止使用if (ret <= 0)的判断方式，否则会将合法的0偏移量误判为查找失败。
• 源码逻辑佐证：查看DPDK 20.08版本rte_hash.c的实现，查找命中时直接返回条目在哈希表存储区的位置下标，第一个插入的有效条目、或是哈希冲突后最终落位到0号槽位的有效条目，被命中时都会返回0，整个查找流程中不存在将0作为错误码返回的分支逻辑。

极少数异常场景下返回0伴随取到的用户数据和插入值不匹配，一般是哈希表内存被越界踩坏、传入的key长度和哈希表初始化时指定的key长度不一致导致的，这类场景不属于接口正常返回逻辑。

内容的提问来源于stack exchange，提问作者J.Maduka