stringutilities.hh

Go to the documentation of this file.

// -*- mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
// vi: set et ts=4 sw=4 sts=4:
//
// SPDX-FileCopyrightInfo: Copyright © DuMux Project contributors, see AUTHORS.md in root folder
// SPDX-License-Identifier: GPL-3.0-or-later
//
 
#ifndef DUMUX_COMMON_STRING_UTILITIES_HH
#define DUMUX_COMMON_STRING_UTILITIES_HH
 
#include <vector>
#include <string>
#include <string_view>
#include <tuple>
 
namespace Dumux {
 
/*
 * \brief Tokenize a string splitting at a given delimiter
 * \ingroup Core
 * \param str a string to be tokenized
 * \param delim a set of delimiter characters separating the tokens
 * \note this works without copying the original string, make sure that string
 *       does not go out of scope!
 * \note The delimiter characters cannot appear within any of the tokens
 *
 * Examples:
 *  - tokenize("bla&foo&&&bar", "&") -> {"bla", "foo", "bar"}
 *  - tokenize("    a  b   ", " ") -> {"a", "b"}
 *  - tokenize(str, " \n\t") -> split at whitespace (and removes all whitespace)
 */
std::vector<std::string_view> tokenize(std::string_view str, std::string_view delim)
{
    const auto token = [&](std::size_t pos){
        const auto start = str.find_first_not_of(delim, pos);
        const auto end = str.find_first_of(delim, start);
        return std::make_pair(start, end);
    };
 
    std::vector<std::string_view> tokens;
    for (auto [start, end] = token(0); start != end; std::tie(start, end) = token(end))
        tokens.emplace_back(str.substr(start, end-start));
    return tokens;
}
 
/*
 * \brief Split a string at a given separator string
 * \ingroup Core
 * \param str a string to be split
 * \param delim a set of delimiter characters separating the tokens
 * \param removeEmpty if empty string between two separator should be removed from the result
 * \note this works without copying the original string, make sure that string
 *       does not go out of scope!
 *
 * Examples:
 *  - split("| Hello | world |", "|") -> {"", " Hello ", " world ", ""}
 *  - split("| Hello | world |", "|", true) -> {" Hello ", " world "}
 *  - split("blafoobla", "foo") -> {"bla", "bla"}
 *  - split("blafoobla", "bla") -> {"", "foo", ""}
 *  - split("blafoobla", "bla", true) -> {"foo"}
 */
std::vector<std::string_view> split(std::string_view str, std::string_view delim, bool removeEmpty = false)
{
    const auto token = [&](std::size_t pos){
        const auto end = str.find(delim, pos);
        return std::make_pair(pos, end);
    };
 
    std::vector<std::string_view> split;
    for (auto [start, end] = token(0); start != std::string::npos; std::tie(start, end) = token(start))
    {
        if (auto&& sub = str.substr(start, end-start); !removeEmpty || !sub.empty())
            split.emplace_back(std::move(sub));
 
        // skip to after the delimiter
        start = (end != std::string::npos) ? end + delim.size() : end;
    }
    return split;
}
 
} // end namespace Dumux
 
#endif