base64cpp

Build and install

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel $(nproc)
cmake --install build --parallel $(nproc)

Make sure to set proper CMAKE_PREFIX_PATH and CMAKE_INSTALL_PREFIX to discover dependencies and install.

Use -DBUILD_SHARED_LIBS=ON for a shared library; the default is static.

CMAKE_POSITION_INDEPENDENT_CODE is set to ON.

Windows build

We build in Git Bash with clang-cl and we add a magic string to CMake to select runtime.

Use Ninja as a make file generator.

Set PATH to include clang-cl.exe from VS.

export PATH="$PATH:/c/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/Llvm/x64/bin"

Add this to cmake configuration:

-G Ninja \
-DCMAKE_C_COMPILER=clang-cl \
-DCMAKE_CXX_COMPILER=clang-cl \
-DCMAKE_MSVC_RUNTIME_LIBRARY='MultiThreaded$<$<CONFIG:Debug>:Debug>'

Usage in CMake

find_package(base64cpp CONFIG REQUIRED)
target_link_libraries(my_app PRIVATE base64cpp::base64cpp)

The CMake package is always generated and installed.

Usage with pkg-config

Disabled by default. Configure with -DCREATE_PKG_CONFIG=ON to generate and install base64cpp.pc.

export PKG_CONFIG_PATH="$HOME/local-dehancer/lib/pkgconfig"
pkg-config --cflags --libs base64cpp

Tests

Install GoogleTest, then:

cmake -B build -DBUILD_TESTING=ON
cmake --build build --parallel $(nproc)
ctest --test-dir build --output-on-failure

Example

#include <base64cpp.hpp>

std::string source = "1234567890binary";
std::string encoded;
base64::encode(source, encoded, 24); // Default line width: 76.

std::string decoded;
base64::decode(encoded, decoded);