cxStringUtils.h

Go to the documentation of this file.

// Copyright (c) 2026 E. Oulashin
#ifndef __CXSTRINGUTILS_H__
#define __CXSTRINGUTILS_H__
 
/* cxStringUtils.h - String utility functions
 *
 * Copyright (c) 2004-2007 Michael H. Kinney
 */
 
#include <regex.h>
#include <cctype>  // For isdigit(), isalpha, etc.
#include <string>
#include <vector>
#include <list>
#include <sstream>
 
#include "cxReturnCodes.h"
#include "cxKeyDefines.h"
#include "cxInputOptions.h"
#include "cxBorderStyles.h"
 
namespace cxStringUtils
{
   void SplitStringRegex(const std::string& input, const std::string& regex,
          std::vector<std::string>& resultContainer);
 
   bool Find(const std::string& input, const std::string& regex, bool useBasicRegex = false);
 
   void Find(const std::string& input, const std::string& regex, std::string& output);
 
   bool Replace(std::string& srcStr, const std::string& regexStr, const std::string& replacementStr);
 
   std::string replace(const std::string& input, const std::string& search, const std::string& replace);
 
   int stringTo(const std::string& s);
   long stringToLong(const std::string& s);
   unsigned stringToUnsigned(const std::string& s);
   double stringToDouble(const std::string& s);
   long double stringToLongDouble(const std::string& s);
   std::string stringToString(const std::string& s);
 
   void test_stringTo();
 
   std::string toString(const int& x);
   std::string toString(const long& x);
   std::string toString(const double& x);
   std::string toString(const long double& x);
   std::string toString(const unsigned& x);
   std::string toString(const unsigned long& x);
   std::string toString(const cx::eReturnCode& x);
   std::string toString(const cx::eInputOptions& x);
   std::string toString(const cx::eBorderStyle& x);
   std::string toString(const void* x);
 
   void test_toString();
 
   bool startsWithNumber(const std::string& pStr);
 
   bool isPrintable(const int& pKey);
 
   int indexOfLastCap(const std::string& pStr);
 
   void toUpper(std::string& theString);
 
   std::string stripNewlines(const std::string& pStr);
 
   std::string replaceNewlines(const std::string& pStr, const char& pChar);
 
   void insertUnderline(std::string& pStr, char pChar, bool pAll = false);
 
   std::string removeChar(const std::string& pString, const int pPos);
 
   std::string strToUpper(const std::string& theString);
 
   std::string strToLower(const std::string& theString);
 
   void TrimSpaces(std::string& str);
 
   void splitStringOnNewlines(const std::string& pStr, std::list<std::string>& pStrings);
 
} // End of stringUtils namespace
 
#endif