StringUtils.h

Go to the documentation of this file.

/*
 * This library 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 2.1 of the License, or (at your option) any later version.
 *
 * This library 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 library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * StringUtils..h
 * Random String functions.
 * Copyright (C) 2005-2008 Simon Newton
 */

#ifndef INCLUDE_OLA_STRINGUTILS_H_
#define INCLUDE_OLA_STRINGUTILS_H_

#include <stdint.h>
#include <sstream>
#include <string>
#include <vector>

namespace ola {

using std::string;
using std::vector;

void StringSplit(const string &input,
                 vector<string> &tokens,
                 const string &delimiters=" ");

void StringTrim(string *input);

void ShortenString(string *input);

bool StringEndsWith(const string &s, const string &suffix);

string IntToString(int i);

string IntToString(unsigned int i);

void Escape(string *original);

string EscapeString(const string &original);

bool StringToBool(const string &value, bool *output);

bool StringToInt(const string &value,
                 unsigned int *output,
                 bool strict = false);

bool StringToInt(const string &value, uint16_t *output, bool strict = false);

bool StringToInt(const string &value, uint8_t *output, bool strict = false);

bool StringToInt(const string &value, int *output, bool strict = false);

bool StringToInt(const string &value, int16_t *output, bool strict = false);

bool StringToInt(const string &value, int8_t *output, bool strict = false);

bool HexStringToInt(const string &value, uint8_t *output);

bool HexStringToInt(const string &value, uint16_t *output);

bool HexStringToInt(const string &value, uint32_t *output);

bool HexStringToInt(const string &value, int8_t *output);

bool HexStringToInt(const string &value, int16_t *output);

bool HexStringToInt(const string &value, int32_t *output);

void ToLower(string *s);

void ToUpper(string *s);

void CapitalizeLabel(string *s);

void CustomCapitalizeLabel(string *s);

void FormatData(std::ostream *out,
                const uint8_t *data,
                unsigned int length,
                unsigned int indent = 0,
                unsigned int byte_per_line = 8);

template <typename int_type>
bool PrefixedHexStringToInt(const string &input, int_type *output) {
  if (input.find("0x") != 0)
    return false;
  string modified_input = input.substr(2);
  return HexStringToInt(modified_input, output);
}

template<typename T>
string StringJoin(const string &delim, const T &input) {
  std::ostringstream str;
  typename T::const_iterator iter = input.begin();
  while (iter != input.end()) {
    str << *iter++;
    if (iter != input.end())
      str << delim;
  }
  return str.str();
}
}  // namespace ola
#endif  // INCLUDE_OLA_STRINGUTILS_H_