hypercore-cxx / util-string

Functional string helpers

SYNOPSIS

Functional string helpers.

USAGE

This module is designed to work with the datcxx build tool. To add this module to your project us the following command...

build add datcxx/util-string

TEST

build test

STRING

SEARCH

Search a string for regular expression matches, returns a vector<string>.

std::string f = "/test/parallel/test-path.js";
std::vector<string> r = search(f, "\\w+");
// r.size() == 5

MATCH

Same as search but return a cmatch starting with the complete input at index 0. This will potentially be depricated.

std::string f = "/test/parallel/test-path.js";
cmatch r = match(f, "/(\\w+)/(.*)");
// r.size() == 3

SPLIT

Split on a regular expression.

std::string f = "/test/parallel/test-path.js";
vector<string> r = split(f, "/");
//  r.size() == 4

TEST

Test if a string is an exact match.

std::string f = "/test/parallel/test-path.js";
bool r = test(f, "^/(\\w+)/(\\w+)/(\\w+)-path.js$");
// r == true

TRIM, RTRIM, LTRIM

string r = trim("/foobar//", "/");
// r.trim() == "foobar"

string r = rtrim("!Hello, World!!", "!");
// r == "!Hello, World"

string r = ltrim("!Hello, World!!", "!");
// r == "Hello, World!!"

REPLACE

string r = replace("Hello, World!", "o", "x");
// r == "Hellx, Wxrld!"

const string s = "Hello, World!";

string r = replace(s, "l", [&](string const& m, int index) {
  return string("L" + to_string(index));
});

// r == "HeL0L1o, WorL2d!"