Table of Contents
🚀A concise, practical, cross-platform general-purpose utility library written in standard modern C++, integrated with file operation toolkit, mathematical common function toolkit and full-featured date-time processing toolkit, tailored for daily development, framework construction, embedded auxiliary development and lightweight project rapid iteration scenarios.
A large number of scattered code snippets and fragmented utility functions exist in various development repositories; most of them are either fragmented and difficult to manage, lack unified specification encapsulation, have messy interface styles, fail to take cross-platform compatibility into account, or are overly bloated with redundant functions that increase project volume. Few lightweight aggregated utility libraries can stably cover file traversal judgment, common mathematical calculations and comprehensive time processing. None of the existing open-source tool libraries fully meet my actual needs for clean structure, zero redundant dependencies, consistent calling logic, cross-platform universality and easy secondary expansion, so I developed UtilitiesLibrary independently to build a unified, neat and long-term maintainable personal general basic tool library.
Here’s why UtilitiesLibrary is well-suited for integration into daily development projects:
- You can focus more energy on core business logic writing and project architecture design, instead of write repetitive file checking, time conversion and mathematical auxiliary calculation code in every new project.
- It adopts unified standardized interface design, consistent naming specifications and neat code layering, eliminating the trouble of adapting different styles of scattered tool functions.
- Fully supports cross-platform compatibility, perfectly compatible with Windows, Linux, macOS mainstream operating systems and works steadily on desktop, server and embedded platforms.
- Strictly follow C++ syntax specifications, abandon weird obscure writing, retain high code readability while ensuring operational efficiency, making later extension and debugging effortless.
- Three core modules are independently decoupled, users can reference and use them separately as needed, and will not introduce extra redundant code to increase project compilation volume and running overhead.
- Rich and complete built-in practical functions: cross-platform file time acquisition, filename parsing & hidden file judgment, common mathematical calculation encapsulation, timestamp mutual conversion, date comparison judgment, year/month/day/hour/minute/second independent extraction and other practical functions, covering most basic development demands.
Of course, this basic general tool library cannot cover all professional scenario-specific low-level functions such as network communication, hardware underlying calling and high-concurrency scheduling. I will continue to maintain and iterate UtilitiesLibrary later, continuously enrich practical general functions, optimize internal logic details, fix potential compatibility bugs, and expand more lightweight auxiliary tool modules according to actual development demands. All developers are welcome to star this project, share valuable optimization ideas and function expansion demands through Issues, and jointly polish this practical lightweight basic utility library. Every user's recognition and use is the biggest power to promote the continuous improvement of this project.
- ✨ Standard C++ Pure Implementation, Zero External Dependencies Written based on mainstream modern C++ standards, no third-party library reliance, out-of-the-box use, simple access and easy integration into all kinds of C++ projects.
- 📂 Full-Featured Cross-Platform File Toolkit Support file & folder traversal, pure filename extraction (remove suffix), hidden file judgment, cross-platform stable acquisition of file modification time, fast judgment of files modified on the current day and other common file operation functions.
- 🧮 Practical Common Mathematical Function Encapsulation Integrate daily development commonly used numerical calculation, data conversion, range constraints and other basic mathematical auxiliary interfaces, simplify tedious numerical processing logic.
- ⏰ Complete Date-Time Processing System Realize second/millisecond-level timestamp acquisition, timestamp and standard date-time string mutual conversion, independent extraction of individual fields including year/month/day/hour/minute/second, and fast comparison judgment of time points.
- 🔄 Unified Cross-Platform Compatibility Logic Abandon platform-specific exclusive APIs, adopt standard library general implementation scheme, and all core functions run stably and consistently on Windows / Linux / macOS.
- 🧩 Module Decoupling & Independent Reference File, mathematics, date and time three major core modules are completely decoupled, support separate introduction and separate use, flexible matching different project development demands.
- 🧹 Neat Code Structure & Easy Expansion Internal code layering is clear, function classification is clear, reserved function expansion interface, convenient for users to add personalized custom utility functions on the basis of the original framework.
- 🎯 Lightweight & Low Overhead Focus on practical basic functions, abandon redundant fancy functions, occupy low resources, and can be used not only for desktop projects, but also for lightweight embedded auxiliary development scenarios.
- Daily personal C++ practice projects and small functional tool development
- Rapid development of lightweight desktop client and console programs
- Basic file management and time statistics function development of server side auxiliary components
- Embedded upper computer auxiliary development and simple MCU auxiliary logic writing
- Framework basic underlying tool function aggregation and project public basic code unification management
- Scenarios that need to unify basic utility functions and reduce repeated wheel-making behavior
- Student programming learning, code standardization training and usual development code accumulation sorting
Here is an example to build.
At first, please clone the repository on your local computer:
git clone https://github.com/FishgameStudio/utils-lib.gitPlease keep the copyright comments in the header file while using. if you modified our source code, please insert these lines into your code:
// Modified by [Your Name] [Modified Date]
// Changes: [Modified Content]This is an example to compile & run the code.
To compile the code, you need:
- clang/clang++ latest version(22).
- gcc/g++ latest version(16.1).
- MSVC latest version(14.50.35710).
Your compiler must support libc++.
This is an example of the compiling code.
# clang++
clang++ test/your_code.cpp -Wall -std=c++26 -stdlib=libc++ -fexperimental-library -I./utils/ -o build/your_program
# g++
g++ -o build/your_program -Wall -std=c++26 -I./utils/ test/your_code.cpp
# MSVC (no escape character)
cl /O2 /W4 /std:c++26 /I.\utils\ /Fobuild\ /Febuild\your_program.exe test\your_code.cpp
# Run
build/your_program- String library
- Requests library
- DateTime library
- Hashlib
See the open issues for a full list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Nicola Grey - popxhxh@outlook.com
Project Link: https://github.com/FishgameStudio/utils-lib
Hope this lightweight UtilitiesLibrary can assist you in daily C++ development, simplify repetitive basic logic writing, and speed up your project construction efficiency.
Every star, fork and sincere feedback means a lot to me. You are warmly welcome to submit issues for bugs feedback and function suggestions, or send pull requests to participate in code optimization and function iteration, so as to polish and improve this utility library together.
If you find this project practical and helpful, don’t forget to hit Star and Fork. All valuable opinions and ideas are sincerely welcomed. Thank you very much for your support!