string_tools.h

Go to the documentation of this file.

// HOG-Man - Hierarchical Optimization for Pose Graphs on Manifolds
// Copyright (C) 2010 G. Grisetti, R. Kümmerle, C. Stachniss
// 
// HOG-Man is free software: you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as published
// by the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// 
// HOG-Man is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Lesser General Public License for more details.
// 
// You should have received a copy of the GNU Lesser General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

#ifndef STRING_TOOLS_H
#define STRING_TOOLS_H

#include <string>
#include <sstream>
#include <cstdlib>
#include <vector>
#include "runtime_error.h"

// @{

std::string trim(const std::string& s);

std::string trimLeft(const std::string& s);

std::string trimRight(const std::string& s);

std::string strToLower(const std::string& s);

std::string strToUpper(const std::string& s);

template <typename OutputIterator>
OutputIterator readInts(const char* str, OutputIterator out)
{
  char* cl  = (char*)str;
  char* cle = cl;
  while (1) {
    int id = strtol(cl, &cle, 10);
    if (cl == cle)
      break;
    *out++ = id;
    cl = cle;
  }
  return out;
}

template <typename OutputIterator>
OutputIterator readFloats(const char* str, OutputIterator out)
{
  char* cl  = (char*)str;
  char* cle = cl;
  while (1) {
    double val = strtod(cl, &cle);
    if (cl == cle)
      break;
    *out++ = val;
    cl = cle;
  }
  return out;
}

std::string formatString(const char* fmt, ...) __attribute__ ((format (printf, 1, 2)));

int strPrintf(std::string& str, const char* fmt, ...) __attribute__ ((format (printf, 2, 3)));

template<typename T>
void convertString(const std::string& s, T& x, bool failIfLeftoverChars = true)
{
  std::istringstream i(s);
  char c;
  if (!(i >> x) || (failIfLeftoverChars && i.get(c)))
    throw RuntimeError("%s: Unable to convert %s", __PRETTY_FUNCTION__, s.c_str());
}

template<typename T>
T stringToType(const std::string& s, bool failIfLeftoverChars = true)
{
  T x;
  convertString(s, x, failIfLeftoverChars);
  return x;
}

bool strStartsWith(const std::string & str, const std::string& substr);

bool strEndsWith(const std::string & str, const std::string& substr);

std::string strExpandFilename(const std::string& filename);

std::vector<std::string> strSplit(const std::string& s, const std::string& delim);

// @}

#endif