portable snippets

Cuplikan Portabel

Ini adalah kumpulan cuplikan kode domain publik (CC0) yang ditulis dalam C untuk melakukan berbagai tugas umum yang biasanya bergantung pada OS, arsitektur, dan/atau kompiler. Pada dasarnya, tujuan kami adalah memindahkan persyaratan praprosesor yang mengganggu tersebut dari kode Anda ke kode kami.

Modul tidak memiliki target tetap (seperti C89) karena hal itu akan menghalangi beberapa fungsi; sebaliknya, kami hanya berusaha memberikan dukungan seluas-luasnya untuk setiap modul. Jika Anda memiliki platform yang tidak didukung untuk fitur tertentu namun mungkin didukung, harap beri tahu kami; kami akan dengan senang hati mencoba mencari cara untuk mendukungnya.

Semuanya diuji terus menerus dengan berbagai versi GCC, Clang, dan PGI (di Travis CI), MSVC (di AppVeyor), dan Emscripten (di Codefresh):

Modul yang siap digunakan saat ini antara lain:

• builtin - gunakan kompiler bawaan/intrinsik, atau kembali ke standar C
• endian — deteksi dan pertukaran endianness
• atomik — operasi sinkronisasi atom yang umum
• safe-math — fungsi integer yang aman untuk overflow
• Exact-int — tipe integer dengan lebar persis (pikirkan <stdint.h> )
• jam — jam dinding lintas platform, waktu CPU, dan waktu monoton

Ada juga modul yang mungkin belum siap untuk digunakan secara luas, namun akan mendapat manfaat besar dari pengujian:

• tidak selaras — pemuatan & penyimpanan cepat yang tidak selaras
• sekali — inisialisasi satu kali
• acak — pembuatan angka acak (3 jenis: kriptografi, dapat direproduksi, dan cepat)
• debug-trap — men-debug jebakan dan pernyataan
• check - pemeriksaan pernyataan

Modul dapat digunakan secara terpisah, meskipun beberapa modul dapat bekerja lebih baik jika digabungkan, jadi jika Anda dapat menyatukan seluruh repositori daripada hanya menyalin satu file, kami sarankan Anda melakukannya.

Mohon jangan malu untuk mengajukan permasalahan mengenai hal-hal ini; jika Anda mempunyai masalah, kemungkinan besar orang lain juga akan mengalaminya, jadi kami ingin memperbaikinya.

Jika Anda memiliki sesuatu yang ingin Anda sumbangkan, silakan ajukan masalah atau tarik permintaan. Jika Anda ingin membantu dengan menulis sesuatu yang baru, lihat masalah "peningkatan" di pelacak masalah kami untuk mendapatkan ide.

Ada beberapa hal yang tidak sesuai dengan repositori ini, jadi berikut adalah beberapa proyek kecil untuk melakukan hal-hal portabel yang mungkin Anda minati:

• Hedley — makro untuk mengaktifkan fitur khusus kompiler yang membuat kode Anda lebih mudah digunakan, lebih sulit disalahgunakan, lebih aman, lebih cepat, dan lebih portabel.
• parg — Penguraian argumen mirip dengan getopt/getopt_long. Domain publik.
• TinyCThread — Mengimplementasikan API thread C11 di atas pthreads dan Windows API. lisensi zlib.
• win-iconv — Implementasi Windows dari iconv API (konversi kumpulan karakter).
• mman-win32 — implementasi mman.h ( mmap() , dll. ) untuk Windows.

Jika ada proyek yang ingin Anda tambahkan ke daftar, silakan ajukan masalah atau tarik permintaan.