sili

Sili - a cross-platform standard library for modern C programming

EimaMei
98
2
C

Sili

VM workflow Linux
VM workflow Windows
VM workflow MacOS

Sili is a cross-platform standard library for modern C99 programming, providing
many new features, improvements and fixes to the language’s standard libraries,
while still adhering to the main principles and appeals of C.

Main goals

Modernize C

The project aims to modernize C by implementing a proper standard library that is
more feature-rich and understandable to read and write, while also containing a
lot of quality of life changes for better readability and safety. It serves
as a lighter alternative to the bloated C++ STL.

Performance & flexibility

Sili strives to strike a balance between having great performance and flexibility
that provide many options for developers when using the library.

Portability

sili.h is a single-header library, allowing for easy integration into any project.
Furthermore, sili is designed to be cross-platform, supporting any OS that has a
working C99 compiler.

Some of the features present in the library

  • Architecture/OS/Compiler/Standard indentification macros (SI_CPU_X86,
    SI_SYSTEM_WINDOWS, SI_COMPILER_CLANG, SI_STANDARD_C99, SI_STANDARD_ANSI
    etc).
  • Useful macros (typeof(), SI_ASSERT/SI_STATIC_ASSERT, SI_BIT, foreach etc).
  • Robust string implementation (siString, fully compatible with char*).
  • Better arrays (siArray(<type>), compatible with other C arrays).
  • char specific functions (si_charToLower, si_charIsSpace, si_hexDigitToInt etc).
  • Hashtable functions (si_hashtableMakeReserve, si_hashtableGetWithHash, si_hashtableSet)
  • Path related functions (si_pathExists, si_pathCopy, si_pathGetFullname etc).
  • A cross-platform file IO functions (si_fileOpen, si_fileReadContents,
    si_fileWriteLineAt etc).
  • siOptional type similar to std::optional.
  • Cross-platform multi-thread support (si_threadCreate, si_threadStart, si_threadJoin).
  • Easy to use benchmarking functions to check performance (si_benchmarkRunsPerLoop,
    si_benchmarkExecutesPerMs, si_benchmarkLoopsAvg etc).
  • An allocator system, making allocations 3x faster than the traditional malloc/free.
  • A general-use hash table.
  • Unicode functions (si_utf8Decode, si_utf8ToUtf16String, si_utf16ToUtf8String).
  • Bit manipulation funcionts (si_numCountBitsU32, si_numRotateLeft, si_bytesToNumArr,
    SI_NUM_BIT_SET etc).
  • DLL function loading (si_dllLoad, si_dllProcAddress).
  • Custom printf implementation, which includes C23 and new specifiers, as well
    as better cross-platform support (%ll and %l both equal to i64).

Examples

Examples of most (but definitely not all) sili’s features are utilized in the
examples folder.