portable snippets

Trechos Portáteis

Esta é uma coleção de trechos de código de domínio público (CC0) escritos em C para executar várias tarefas comuns que normalmente dependem do sistema operacional, da arquitetura e/ou do compilador. Basicamente, nosso objetivo é mover aquelas irritantes condicionais de pré-processador do seu código para o nosso.

Os módulos não têm destino fixo (como C89), pois isso impediria algumas funcionalidades; em vez disso, simplesmente tentamos fornecer o suporte mais amplo possível para cada módulo. Se você tiver uma plataforma que não é compatível com um recurso específico, mas poderia ser, informe-nos; ficaríamos felizes em tentar encontrar uma maneira de apoiá-lo.

Tudo é testado continuamente com várias versões de GCC, Clang e PGI (no Travis CI), MSVC (no AppVeyor) e Emscripten (no Codefresh):

Os módulos atualmente prontos para uso incluem:

• builtin — use recursos internos/intrínsecos do compilador ou use o padrão C
• endian — detecção e troca de endianness
• atomic — operações comuns de sincronização atômica
• safe-math — funções inteiras seguras contra overflow
• exact-int — tipos inteiros de largura exata (pense em <stdint.h> )
• relógio – relógio de parede multiplataforma, tempo de CPU e tempo monotônico

Existem também módulos que podem ainda não estar prontos para uso generalizado, mas que se beneficiariam muito com os testes:

• desalinhado – carregamentos e armazenamentos desalinhados rápidos
• uma vez – inicialização única
• random — geração de números aleatórios (3 sabores: criptográfico, reproduzível e rápido)
• debug-trap — depurando armadilhas e asserções
• check – verificação de asserção

Os módulos podem ser usados ​​isoladamente, embora alguns funcionem melhor juntos, então se você puder manter todo o repositório junto em vez de apenas copiar um único arquivo, recomendamos que você faça isso.

Por favor, não tenha vergonha de registrar problemas sobre qualquer um deles; se você tiver problemas, é provável que outros também tenham, por isso gostaríamos de corrigi-los.

Se você tiver algo com o qual gostaria de contribuir, registre um problema ou pull request. Se você quiser ajudar escrevendo algo novo, dê uma olhada nos problemas de "aprimoramento" em nosso rastreador de problemas para ter ideias.

Algumas coisas realmente não cabem neste repositório, então aqui estão alguns projetos pequenos para fazer coisas portáveis ​​nos quais você pode estar interessado:

• Hedley — macros para habilitar recursos específicos do compilador que tornam seu código mais fácil de usar, mais difícil de usar indevidamente, mais seguro, mais rápido e mais portátil.
• parg — Análise de argumentos semelhante a getopt/getopt_long. Domínio público.
• TinyCThread — Implementa a API de threads C11 sobre pthreads e a API do Windows. licença zlib.
• win-iconv — Implementação do Windows da API iconv (conversão de conjunto de caracteres).
• mman-win32 — implementação de mman.h ( mmap() , etc. ) para Windows.

Se houver um projeto que você gostaria de ver adicionado à lista, registre um problema ou pull request.