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()等）實作。

如果您希望將某個項目新增到清單中，請提交問題或拉取請求。