C语言集成ip2region库的Demo

以下是使用C语言集成ip2region库的简单Demo，基于官方文档及搜索结果中的核心信息整理：

---

​​1. 环境准备​​

1. ​​下载源码​​
   从 ip2region GitHub仓库 克隆代码，重点关注binding/c目录下的C语言实现。
2. ​​获取数据库文件​​
   将仓库中data/ip2region.xdb文件拷贝至项目目录（如/data/）。

---

​​2. 核心代码示例​​

#include <stdio.h>
#include <stdlib.h>
#include "ip2region.h"

int main(int argc, char *argv[]) {
    // 1. 初始化查询引擎（B树算法）
    IP2Region *region = IP2Region_create("data/ip2region.xdb"); // 数据库路径
    if (region == NULL) {
        fprintf(stderr, "Error: Failed to load database\n");
        return EXIT_FAILURE;
    }

    // 2. 输入待查询的IP地址
    if (argc != 2) {
        printf("Usage: %s <IP地址>\n", argv[0]);
        IP2Region_destroy(region);
        return EXIT_FAILURE;
    }
    const char *ip = argv[1];

    // 3. 执行查询
    IP2RegionBlock block;
    int ret = IP2Region_btree_search(region, ip, &block);
    if (ret != 0) {
        printf("查询失败，请检查IP格式或数据库路径\n");
        IP2Region_destroy(region);
        return EXIT_FAILURE;
    }

    // 4. 输出结果
    printf("IP: %s\n", ip);
    printf("地区信息: %s|%s|%s|%s|%s\n", 
           block.country, block.region, block.province, block.city, block.isp);
    
    // 5. 释放资源
    IP2Region_destroy(region);
    return EXIT_SUCCESS;
}

---

​​3. 编译与运行​​

1. ​​编译指令​​ gcc -o ip_query main.c ip2region.c -O2 说明：需将ip2region.h和ip2region.c从仓库的binding/c目录复制到项目路径。
2. ​​执行查询​​ ./ip_query 8.8.8.8 ​​输出示例​​： IP: 8.8.8.8 地区信息: 美国|0|0|0|谷歌

---

​​4. 关键函数解析​​

• ​​IP2Region_create()​​
  初始化查询引擎，支持文件路径或内存加载（内存模式需先用IP2Region_load_buffer加载数据）。
• ​​IP2Region_btree_search()​​
  使用B树算法查询IP，返回结构体IP2RegionBlock包含国家、省份、城市等信息。
• ​​IP2Region_destroy()​​
  释放查询引擎占用的资源，避免内存泄漏。

---

​​5. 扩展配置​​

• ​​切换算法​​
  若需使用binary或memory算法，替换IP2Region_btree_search()为： IP2Region_binary_search() // 二分查找 IP2Region_memory_search() // 内存加速（需预加载数据库到内存）
• ​​性能优化​​
  • 高频查询推荐memory模式：预加载.xdb到内存，查询速度可达微秒级。
  • 多线程场景需为每个线程创建独立的查询对象。

---

​​6. 常见问题​​

1. ​​数据库路径错误​​
   确保.xdb文件路径正确，或使用绝对路径。
2. ​​IP格式校验​​
   调用IP2Region_isip()函数验证IP合法性。

---

通过此Demo可快速实现IP地址的离线定位功能。如需更完整示例，可参考仓库binding/c/testSearcher.c文件。