基准测试

大文件比较

NSMBU 8-43（解压后 63.9 MB）

* 平均 3 次运行；在 Windows 11 上的 x64 Clang (17.0.6) 构建进行了测试，测试在 Intel i9-13900KF 上进行

小文件比较

任务：压缩 N64 Bowser Castle（源文件大小：2,574,368）

* 平均 3 次运行；在 Windows 11 上的 x64 Clang (17.0.6) 构建进行了测试，测试在 Intel i9-13900KF 上进行

通常情况下，mk8 算法以最快的速度获得可接受的压缩效果。对于文件大小至关重要的场景，lib-yaz0 与 wszst ultra 在最小的文件大小上并列，但速度约快 25%。

（Windows）性能比较：Clang 与 MSVC

在 Windows 上，微软的编译器（MSVC）在大多数算法上似乎落后于 Clang，差距相当明显

* 平均 3 次运行；在 Windows 11 上的 x64 MSVC 构建进行了测试，测试在 Intel i9-13900KF 上进行

平均性能提升 -19.51%

建议

根据性能结果，Clang通常更受欢迎。要将Clang设置为szs的编译器，在运行cargo build之前，执行以下命令：

SET CXX=clang

此外，使用兼容的Clang/Rust版本将允许进行跨语言LTO优化。

示例（C绑定）

#include "szs.h"

// Calculate the upper bound for encoding.
u32 max_size = riiszs_encoded_upper_bound(sizeof(data));

// Allocate a buffer based on the calculated upper bound.
void* encoded_buf = malloc(max_size);
if (!buf) {
	fprintf(stderr, "Failed to allocate %u bytes.\n", max_size);
	return -1;
}

// Boyer-Moore-horspool variant
u32 algorithm = RII_SZS_ENCODE_ALGO_NINTENDO;

u32 actual_len = 0;
const char* ec = riiszs_encode_algo_fast(encoded_buf, max_size, data, sizeof(data), &actual_len, algorithm);
if (ec != NULL) {
	fprintf(stderr, "Failed to compress: %s\n", ec);
	riiszs_free_error_message(ec);
	return -1;
}
printf("Encoded %u bytes.\n", actual_len);
// Optionally: shrink the dst_data to the actual size.
encoded_buf = realloc(encoded_buf, actual_len);

C++在C绑定之上封装

还提供了一个CMake示例。

#include `szs.h`

// Boyer-Moore-horspool variant
szs::Algo algorithm = szs::Algo::Nintendo;
auto encoded = szs::encode(data, algorithm);
if (!encoded)
	std::println(stderr, "Failed to compress: {}.", encoded.error()); {
	return -1;
}
std::vector<u8> szs_data = *encoded;
std::println("Encoded {} bytes.", szs_data.size());

许可证

此库根据MIT许可证发布。