A common utilties library for my future creations
 
 
 
 
Go to file
Brett e2364280b0 destory alloc fix 2024-03-04 11:21:43 -05:00
.idea working msvc 2024-02-21 19:32:40 -05:00
cmake unicode, cmakes 2024-02-24 03:30:31 -05:00
include/blt destory alloc fix 2024-03-04 11:21:43 -05:00
libraries windows 2024-02-21 20:24:00 -05:00
src/blt push version 0.12.0. Breaking changes to the hashmap typename, Now blt::hashmap_t and blt::hashset_t 2024-02-25 14:39:56 -05:00
tests vector 3 2024-02-21 15:31:22 -05:00
.gitignore ignore 2024-02-21 19:33:31 -05:00
.gitmodules Parallel hashmap submodule 2022-12-26 23:44:02 -05:00
CMakeLists.txt fix private 2024-02-26 11:02:16 -05:00
CMakeSettings.json changes? 2024-02-14 16:19:48 -05:00
LICENSE changes? 2024-02-14 16:19:48 -05:00
README.md changes? 2024-02-14 16:19:48 -05:00
arg_parse_variant_map.drawio make arg_results public 2024-02-08 09:52:02 -05:00
blt_argparse_variant_map.png make arg_results public 2024-02-08 09:52:02 -05:00
build_and_run_debug.sh changes? 2024-02-14 16:19:48 -05:00
commit.sh changes? 2024-02-14 16:19:48 -05:00
design.txt changes? 2024-02-14 16:19:48 -05:00
icon.png changes? 2024-02-14 16:19:48 -05:00
icon_large.png changes? 2024-02-14 16:19:48 -05:00
icon_small.png changes? 2024-02-14 16:19:48 -05:00

README.md

BLT v0.8.0a

A C++20 common utilities library to make thing easy!

Icon


Specialties

blt::logging.v2

Found in the header file include/std/logging.h, blt::logging is a fast and simple single header logging library which can be used independently of BLT. Just include the header file anywhere in your project and in ONE cpp file define #define BLT_LOGGING_IMPLEMENTATION. If you are using BLT as a CMake library (as you should!) this is done for you.

  • Compile Time Config

    • Using CMake
      • Several options are provided which disable various logging contexts, as such global logging can be disabled by passing -DBLT_DISABLE_LOGGING:BOOL=ON
      • Options follow the pattern of BLT_DISABLE_LEVEL where level is one of TRACE,DEBUG,INFO,WARN,ERROR, or FATAL.
        • This allows for individual logging levels to be disabled while leaving the others functional. These options can be combined.
        • See CMakeLists.txt for a complete list of options.
    • Standalone
      • The CMake options define global variables in a config file. If you are using logging standalone you will need to remove the config include.
      • Macros can be used in the same pattern of BLT_DISABLE_LEVEL to disable the various logging levels

blt::arg_parse

blt::arg_parse found in blt/parse/argparse.h is an attempt at a near 1:1 replication of Python's argparse in C++. Python's argparse is one of the best command line argument parsing solutions with some of the best documentation I've seen. The goal was to create an API which would function exactly as the Python docs described, simplifying how much I needed to remember and document for this library.

blt::profile_t (v2)

The newest version of my profiler solution now features a CPU cycle counter, CPU thread execution time, and wall time. It has more options for sorting and general printing while featuring a nicer codebase. It is an improvement over blt::profiling while maintaining (almost) complete backwards compatability. Due to changes in the ABI the BLT_PRINT_PROFILE macro deletes the internal profiles and intervals AND takes arguments which match the new formatting options for profiling v2. However, BLT_START_INTERVAL, BLT_WRITE_PROFILE, and BLT_END_INTERVAL are still the same. Documentation for this is coming soon, along with more profiling features. the BLT_* macros can be disabled by the standard BLT_DISABLE_PROFILING from the v1 profiler. It is encouraged to use the new blt::* profile functions over the macros however these currently cannot be disabled. (TODO)

Features / Examples

  • Data Structures

    • Queue / Stack
      • faster than std::queue / std::stack
      • backed by a contiguous array
  • Utility

    • Simple Random Wrapper Interface
    • Simple random functions based on the PCG Hash
    • String Functions

      • starts_with
      • ends_with
      • contains
      • toLowerCase
      • toUpperCase
      • split
      • trim
    • Logging
      • See blt::logging section above
    • Time
      • Current time in nanoseconds (without all the c++ gobbledygook)
        • Java's currentTimeMilliseconds
        • nanoTime as well
        • std::chrono::duration_cast<std::chrono::nanoseconds>(std::chrono::high_resolution_clock::now().time_since_epoch()).count() becomes blt::system::nanoTime()
      • Formatted time string with year/month/date + current time
  • Profiling

    • Basic profiler with history and formatted output