string.hpp

Go to the documentation of this file.

 
#ifndef IFW_CORE_UTILS_STRING_HPP_
#define IFW_CORE_UTILS_STRING_HPP_
 
#include <ifw/core/utils/base/base.hpp>
 
 
namespace ifw::core::utils::string {

    std::string Upper(const std::string& str);

    std::string Lower(const std::string& str);

    std::string Trim(const std::string& str,
                     const std::string& trim_chars);

    std::string Replace(const std::string& str,
                        const std::string& old_sub_str,
                        const std::string& new_sub_str);

    std::string Truncate(const std::string& text,
                         const int32_t max_len,
                         const std::string& truncation_indicator = "...");
 
    // TODO: Remove ifw::core::utils::string::Split(). boost::algorithm::split() does the same.
    void Split(const std::string& str,
               const std::string& separator,
               std::vector<std::string>& str_els,
               int32_t exp_nb_elements = -1);

    std::vector<std::string> Split(const std::string& str,
                                   const std::string& separator,
                                   int32_t exp_nb_elements = -1);

    void SplitBuffer(const std::string buffer,
                     std::vector<std::string>& buffer_lines,
                     const bool strip = true,
                     const bool remove_empty_lines = true,
                     const std::string remove_comments = "");

    template <class TYPE>
    std::string Concat(const std::vector<TYPE>& list,
                       const std::string& sep = "") {
      std::stringstream tmp_buf;
      for (const auto& el : list) {
          tmp_buf << el << sep;
        }
      return tmp_buf.str().substr(0, (tmp_buf.str().size() - sep.size()));
    }

    void StringCopy(char* dest_buf,
                    const char* src_buf,
                    const int32_t max_bytes,
                    const bool truncate = false);

    bool Match(const std::string& str,
               const std::string& reg_exp);
 
}
 
#endif // IFW_CORE_UTILS_STRING_HPP_