HPPC: 高性能原始类型集合

1. 安装指南

1.1 环境要求

• Java 8 或更高版本
• Maven 或 Gradle 构建工具

1.2 使用 Maven 安装

在项目的 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>com.carrotsearch</groupId>
    <artifactId>hppc</artifactId>
    <version>0.9.1</version>
</dependency>

1.3 使用 Gradle 安装

在 build.gradle 文件中添加以下依赖：

implementation 'com.carrotsearch:hppc:0.9.1'

1.4 手动安装

可以从 GitHub Releases 页面下载最新版本的 JAR 文件，并将其添加到项目的类路径中。

2. 项目使用说明

2.1 概述

HPPC 是一个高性能的原始类型集合库，提供了对原始类型（如 int, long, float, double 等）的集合支持，避免了 Java 标准库中对原始类型的自动装箱和拆箱操作，从而提高了性能和内存利用率。

2.2 主要特性

• 高性能：通过避免装箱和拆箱操作，HPPC 提供了比标准库更高的性能。
• 开放内部结构：HPPC 的内部结构是开放的，允许用户直接访问和操作底层数据结构。
• API 设计：HPPC 的 API 设计与 java.util.collections 不兼容，提供了更适合高性能场景的操作接口。

2.3 示例代码

以下是一个简单的示例，展示了如何使用 HPPC 创建一个 IntArrayList：

import com.carrotsearch.hppc.IntArrayList;

public class HPPCDemo {
    public static void main(String[] args) {
        IntArrayList list = new IntArrayList();
        list.add(1);
        list.add(2);
        list.add(3);

        for (int i : list) {
            System.out.println(i);
        }
    }
}

3. 项目 API 使用文档

3.1 核心类

• IntArrayList：用于存储 int 类型的列表。
• LongArrayList：用于存储 long 类型的列表。
• IntObjectHashMap：用于存储 int 到对象的映射。
• LongObjectHashMap：用于存储 long 到对象的映射。

3.2 常用方法

• add(T value)：向集合中添加一个元素。
• get(int index)：获取指定索引位置的元素。
• set(int index, T value)：设置指定索引位置的元素。
• size()：返回集合的大小。
• iterator()：返回一个迭代器，用于遍历集合中的元素。

3.3 示例

以下是一个使用 IntObjectHashMap 的示例：

import com.carrotsearch.hppc.IntObjectHashMap;

public class HPPCDemo {
    public static void main(String[] args) {
        IntObjectHashMap<String> map = new IntObjectHashMap<>();
        map.put(1, "One");
        map.put(2, "Two");
        map.put(3, "Three");

        for (int key : map.keys()) {
            System.out.println(key + ": " + map.get(key));
        }
    }
}

4. 项目安装方式

4.1 Maven 安装

如前所述，在 pom.xml 中添加依赖即可。

4.2 Gradle 安装

如前所述，在 build.gradle 中添加依赖即可。

4.3 手动安装

从 GitHub Releases 页面下载 JAR 文件，并将其添加到项目的类路径中。

---

通过以上文档，您应该能够顺利安装和使用 HPPC 项目，并了解其核心 API 的使用方法。