portable snippets

便携式片段

这是用 C 语言编写的公共领域 (CC0) 代码片段的集合，用于执行通常依赖于操作系统、体系结构和/或编译器的各种常见任务。基本上，我们的目标是将那些烦人的预处理器条件从您的代码移至我们的代码中。

模块没有固定的目标（例如 C89），因为这会排除某些功能；相反，我们只是尝试为每个模块提供最广泛的支持。如果您的平台不支持某项特定功能，但可能支持，请告知我们；我们很乐意尝试找出支持它的方法。

一切都使用不同版本的 GCC、Clang 和 PGI（在 Travis CI 上）、MSVC（在 AppVeyor 上）和 Emscripten（在 Codefresh 上）进行持续测试：

目前可用的模块包括：

• builtin — 使用编译器内置函数/内在函数，或者依靠标准 C
• endian — 字节序检测和交换
• atomic — 常见的原子同步操作
• safe-math — 溢出安全整数函数
• exact-int — 精确宽度整数类型（想想<stdint.h> ）
• 时钟 — 跨平台挂钟、CPU 时间和单调时间

还有一些模块可能尚未准备好广泛使用，但将从测试中受益匪浅：

• unaligned — 快速未对齐加载和存储
• 一次——一次性初始化
• random — 随机数生成（3 种风格：加密、可重现和快速）
• debug-trap — 调试陷阱和断言
• check——断言检查

模块可以单独使用，尽管有些模块在一起工作效果更好，因此如果您可以将整个存储库放在一起而不是仅仅复制单个文件，我们建议您这样做。

请不要羞于提出有关这些问题的问题；如果您遇到问题，其他人也可能会遇到问题，因此我们希望解决这些问题。

如果您想贡献一些东西，请提交问题或拉取请求。如果您想通过编写新内容来提供帮助，请查看我们的问题跟踪器中的“增强”问题以获取想法。

有些东西并不真正适合这个存储库，所以这里有一些您可能感兴趣的可移植的小型项目：

• Hedley — 启用特定于编译器的功能的宏，使您的代码更易于使用、更不易误用、更安全、更快且更可移植。
• parg — 参数解析类似于 getopt/getopt_long。公共领域。
• TinyCThread — 在 pthread 和 Windows API 之上实现 C11 线程 API。 zlib 许可证。
• win-iconv — iconv API（字符集转换）的 Windows 实现。
• mman-win32 — Windows 的mman.h （ mmap()等）实现。

如果您希望将某个项目添加到列表中，请提交问题或拉取请求。