Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jbaldwin/libchain
Easy to use std::string enhancements.
https://github.com/jbaldwin/libchain
cpp cpp17 cpp17-library modern-cpp string string-manipulation
Last synced: about 10 hours ago
JSON representation
Easy to use std::string enhancements.
- Host: GitHub
- URL: https://github.com/jbaldwin/libchain
- Owner: jbaldwin
- License: mit
- Created: 2020-04-05T22:28:14.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-12-05T18:58:30.000Z (almost 3 years ago)
- Last Synced: 2023-06-01T04:50:30.730Z (over 1 year ago)
- Topics: cpp, cpp17, cpp17-library, modern-cpp, string, string-manipulation
- Language: C++
- Homepage:
- Size: 219 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# libchain - C++17 std::string utility chain belt
[](https://github.com/jbaldwin/libchain/workflows/build/badge.svg)
[](https://coveralls.io/github/jbaldwin/libchain?branch=master)
[](https://lgtm.com/projects/g/jbaldwin/libchain/context:cpp)
[](https://www.codacy.com/gh/jbaldwin/libchain/dashboard?utm_source=github.com&utm_medium=referral&utm_content=jbaldwin/libchain&utm_campaign=Badge_Grade)
[![language][badge.language]][language]
[![license][badge.license]][license]
https://github.com/jbaldwin/libchain
## Usage
### Requirements
C++17 compiler (g++/clang++)
Tested on g++-9 and clang++-9
CMake
make and/or ninja
### Instructions
#### Building
mkdir Release && cd Release
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .
## Examples
```C++
#include
#include
int main()
{
using namespace chain;
auto print_parts = [](auto& parts) {
for (const auto& part : parts)
{
std::cout << part << " ";
}
std::cout << "\n";
};
// A simple csv split. split() only allocates space for the std::string_view
// values that it returns, it does not make any copies of the input data.
auto parts1 = str::split("1,2,3", ',');
// parts1 = { "1", "2", "3" }
print_parts(parts1);
// A split mapped into integers.
auto parts2 = str::split_map(
"1,2,3", ',', [](std::string_view part) { return str::to_number(part).value_or(0); });
// parts2 = { 1, 2, 3 }
print_parts(parts2);
// A pre-allocated split, for large splits to reduce allocations.
std::vector parts3{};
parts3.reserve(128);
str::split("1,2,3,...,128", ',', parts3);
// parts3 = { "1", "2", "3", ... , "128" }
print_parts(parts3);
// A split with zero allocations.
str::split_for_each("1,2,3,4,5", ',', [](std::string_view part) {
// 1, 2, 3, 4, 5
std::cout << part << ", ";
// Can optionally provide a lambda that returns -> bool type,
// returning true continues splitting, returning false stops splitting.
});
std::cout << "\n";
// A simple csv join.
std::vector parts4{1, 2, 3};
auto joined1 = str::join(parts4, ',');
// joined1 == "1,2,3"
std::cout << joined1 << "\n";
// A map join which squares its parts first.
std::vector parts5{1, 2, 3};
// "1,4,9"
std::cout << str::map_join(parts5, ',', [](int64_t x) { return x * x; }) << "\n";
// Simple consistent to number api, leverages std::optional instead of exceptions.
auto value = str::to_number("420").value_or(0);
// value == 420
std::cout << value << "\n";
return 0;
}
````
## Support
File bug reports, feature requests and questions using [GitHub Issues](https://github.com/jbaldwin/libchain/issues)
## Readme updates
To edit this file the template is located at `.githooks/readme-template.md`, editing it directly in the root README.md will be overwritten by the `git pre-commit` hook which automatically replaces the code portions of this file with the appropriate examples.
## Code formatting
This library has a `git pre-commit` hook which is installed when `cmake` is invoked. Any files that are commited will automatically have `clang-format` run on them before.
Copyright © 2020, Josh Baldwin
[badge.language]: https://img.shields.io/badge/language-C%2B%2B17-yellow.svg
[badge.license]: https://img.shields.io/badge/license-MIT-blue
[language]: https://en.wikipedia.org/wiki/C%2B%2B17
[license]: https://en.wikipedia.org/wiki/MIT_License