portable snippets

Extraits portables

Il s'agit d'une collection d'extraits de code du domaine public (CC0) écrits en C pour effectuer diverses tâches courantes qui dépendent généralement du système d'exploitation, de l'architecture et/ou du compilateur. Fondamentalement, notre objectif est de déplacer ces conditions conditionnelles ennuyeuses du préprocesseur de votre code vers le nôtre.

Les modules n'ont pas de cible fixe (comme C89) car cela empêcherait certaines fonctionnalités ; au lieu de cela, nous essayons simplement de fournir le support le plus large possible pour chaque module. Si vous disposez d'une plate-forme qui n'est pas prise en charge pour une fonctionnalité particulière mais qui pourrait l'être, veuillez nous en informer ; nous serions heureux d'essayer de trouver un moyen de le soutenir.

Tout est testé en continu avec différentes versions de GCC, Clang et PGI (sur Travis CI), MSVC (sur AppVeyor) et Emscripten (sur Codefresh) :

Les modules actuellement prêts à l'emploi comprennent :

• intégré - utilisez les éléments intégrés/intrinsèques du compilateur ou utilisez le C standard
• endian — détection et échange d'endianité
• atomique - opérations de synchronisation atomique courantes
• safe-math — fonctions entières sécurisées contre le débordement
• exact-int — types entiers de largeur exacte (pensez <stdint.h> )
• clock – horloge murale multiplateforme, temps CPU et temps monotone

Il existe également des modules qui ne sont peut-être pas encore prêts à être utilisés à grande échelle, mais qui gagneraient grandement à être testés :

• non aligné – chargements et magasins rapides non alignés
• une fois - initialisation unique
• random – génération de nombres aléatoires (3 versions : cryptographique, reproductible et rapide)
• debug-trap — débogage des pièges et des assertions
• check - vérification d'assertion

Les modules peuvent être utilisés isolément, bien que certains fonctionnent mieux ensemble, donc si vous pouvez conserver l'ensemble du référentiel au lieu de simplement copier un seul fichier, nous vous recommandons de le faire.

N'hésitez pas à signaler des problèmes concernant l'un de ces éléments ; si vous rencontrez des problèmes, il est probable que d'autres en auront également, c'est pourquoi nous aimerions les résoudre.

Si vous souhaitez contribuer à quelque chose, veuillez déposer un problème ou une pull request. Si vous souhaitez nous aider en écrivant quelque chose de nouveau, jetez un œil aux problèmes « d'amélioration » dans notre outil de suivi des problèmes pour trouver des idées.

Certaines choses ne correspondent pas vraiment à ce référentiel, alors voici quelques petits projets pour faire des choses de manière portable qui pourraient vous intéresser :

• Hedley — macros pour activer des fonctionnalités spécifiques au compilateur qui rendent votre code plus facile à utiliser, plus difficile à utiliser à mauvais escient, plus sûr, plus rapide et plus portable.
• parg — Analyse des arguments similaire à getopt/getopt_long. Domaine public.
• TinyCThread — Implémente l'API des threads C11 au-dessus des pthreads et de l'API Windows. licence zlib.
• win-iconv — Implémentation Windows de l'API iconv (conversion du jeu de caractères).
• mman-win32 — Implémentation mman.h ( mmap() , etc. ) pour Windows.

S'il y a un projet que vous aimeriez voir ajouté à la liste, veuillez déposer un problème ou une pull request.