Initial commit

This commit is contained in:
doyle 2021-09-12 18:28:32 +10:00
commit 3f7b586ca2
5 changed files with 4098 additions and 0 deletions

1
.gitignore vendored Normal file
View File

@ -0,0 +1 @@
build

42
README.md Normal file
View File

@ -0,0 +1,42 @@
# intc
A MIT licensed C/C++ uint128/256 type library, originally adapted from [calccrypto's uint128/256 library](https://github.com/calccrypto/uint256_t) turned into a primarily C first library and opt out C++ features when compiling in C++ mode.
The overarching motivation of the library can be summed up as follows
- Single header, drop in - no build configuration required.
- Minimal dependencies (only depends on stdbool.h when compiling in C).
- Zero allocations (in other libs typically when converting to strings).
- Ability to rename the API via the pre-processor for tighter integration into C code bases
- C++ features are optional and can be opt out via the pre-processor, i.e. operator overloading and constructors.
## Usage
Include `intc.h` and defined `INTC_IMPLEMENTATION` in one and only one file to enable the implementation in that translation unit.
```cpp
#define INTC_IMPLEMENTATION
#include "intc.h"
#include <stdio.h>
int main(int, char**)
{
#if defined(__cplusplus)
intc_u256 value = 32;
value += 32;
if (value == 64)
value *= 1'000'000'000'000;
intc_u256_string string = intc_u256_readable_int_str(value);
printf("%.*s\n", string.size, string.str); // 64,000,000,000,000
#else
intc_u256 value = INTC_U64_TO_U256(32);
value = intc_u256_add_u64(value, 32);
if (intc_u256_eq_u64(value, 64))
value = intc_u256_mul(value, INTC_U64_TO_U256(1'000'000'000'000));
intc_u256_string string = intc_u256_readable_int_str(value);
printf("%.*s\n", string.size, string.str); // 64,000,000,000,000
#endif
return 0;
}
```
## Tests
Tests are adapted from calccrypto's test suite and can be built by running `build_tests.bat` for Windows and `build_tests.sh` for Unix. For Windows MSVC's cl compiler must be available on the path and GCC must be available on Unix.

23
build_tests.bat Normal file
View File

@ -0,0 +1,23 @@
@echo off
set script_dir=%~dp0
if not exist build mkdir build
where /q cl || (
echo MSVC's cl compiler must be available on the path to build
goto :eof
)
REM MSVC cl build
echo [SCRIPT] Building tests via cl to build\intc_tests_msvc.exe
pushd build
cl -nologo -O2 -D INTC_TESTS_WITH_MAIN -I %script_dir% -TP %script_dir%\intc_tests.h /Fe:intc_tests_msvc /link
popd build
REM Optional clang-cl build if we have the compiler on the path
where /q clang-cl || goto :eof
echo [SCRIPT] Building tests via clang-cl to build\intc_tests_clang.exe
pushd build
clang-cl -nologo -O2 -D INTC_TESTS_WITH_MAIN -I %script_dir% -TP %script_dir%\intc_tests.h /Fe:intc_tests_clang /link
popd build

2082
intc.h Normal file

File diff suppressed because it is too large Load Diff

1950
intc_tests.h Normal file

File diff suppressed because it is too large Load Diff