portable snippets

ポータブル スニペット

これは、通常は OS、アーキテクチャ、コンパイラに依存するさまざまな一般的なタスクを実行するために C で記述されたパブリック ドメイン (CC0) コード スニペットのコレクションです。基本的に、私たちの目標は、煩わしいプリプロセッサの条件文をあなたのコードから私たちのコードに移動することです。

モジュールには、一部の機能が妨げられるため、固定ターゲット (C89 など) がありません。代わりに、各モジュールに対して可能な限り幅広いサポートを提供するよう努めるだけです。特定の機能がサポートされていないプラットフォームをお持ちの場合は、サポートされる可能性がありますので、お知らせください。私たちは喜んでそれをサポートする方法を考え出します。

すべては、さまざまなバージョンの GCC、Clang、PGI (Travis CI 上)、MSVC (AppVeyor 上)、および Emscripten (Codefresh 上) で継続的にテストされます。

現在すぐに使用できるモジュールには次のものがあります。

• 組み込み - コンパイラの組み込み/組み込みを使用するか、標準 C にフォールバックします。
• エンディアン — エンディアンの検出とスワップ
• atomic — 一般的なアトミック同期操作
• safe-math — オーバーフローセーフな整数関数
• strict-int — 正確な幅の整数型 ( <stdint.h>を考えてください)
• クロック — クロスプラットフォームの壁時計、CPU 時間、単調時間

まだ広く使用する準備ができていないかもしれないが、テストすることで大きな恩恵を受けるモジュールもあります。

• unaligned — 高速な非整列ロードとストア
• 1 回 — 1 回限りの初期化
• ランダム — 乱数生成 (暗号化、再現可能、高速の 3 種類)
• debug-trap — トラップとアサーションのデバッグ
• check — アサーションのチェック

モジュールは単独で使用できますが、組み合わせた方がより効果的に機能するものもあります。そのため、単一のファイルをコピーするだけでなくリポジトリ全体をまとめて保持できる場合は、そうすることをお勧めします。

これらについては、遠慮せずに問題を報告してください。あなたが問題を抱えているなら、他の人も同様に問題を抱えている可能性が高いので、私たちはそれらを修正したいと考えています。

貢献したいものがあれば、Issue または Pull Request を提出してください。新しいものを書いて手助けしたい場合は、アイデア用の課題トラッカーで「拡張」の問題を参照してください。

いくつかのことは実際にはこのリポジトリに適合しないので、ここでは、興味があるかもしれないことを移植可能に行うための小規模なプロジェクトをいくつか紹介します。

• Hedley — コードを使いやすく、悪用しにくく、安全、高速、移植性を高めるコンパイラ固有の機能を有効にするマクロ。
• parg — getopt/getopt_long と同様の引数解析。パブリックドメイン。
• TinyCThread — pthread および Windows API 上に C11 スレッド API を実装します。 zlibライセンス。
• win-iconv — iconv API (文字セット変換) の Windows 実装。
• mman-win32 — Windows 用のmman.h ( mmap()など) の実装。

リストに追加したいプロジェクトがある場合は、問題を提出するかプルリクエストを提出してください。