StringHelper.h

Go to the documentation of this file.

/*
 * Copyright (C) 2006-2011, SRI International (R)
 *
 * This program 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.
 *
 * This program 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/>.
 */
 
#pragma once
 
#ifndef __OpenKarto_StringHelper_h__
#define __OpenKarto_StringHelper_h__
 
#include <stdio.h>
#include <ostream>
#include <sstream>
 
#include <OpenKarto/String.h>
 
namespace karto
{
 
 
 
 
  class Color;
 
  class Pose2;
  class Pose3;
  class Quaternion;
 
  template<typename T> class Size2;
 
  template<typename T> class Vector2;
  template<typename T> class Vector3;
  template<typename T> class Vector4;
 
  class KARTO_EXPORT StringHelper
  {
  public:
    static String ToString(const char* value);
 
    static String ToString(kt_bool value);
 
    static String ToString(kt_int16s value);
 
    static String ToString(kt_int16u value);
 
    static String ToString(kt_int32s value);
 
    static String ToString(kt_int32u value);
 
    static String ToString(kt_int64s value);
 
    static String ToString(kt_int64u value);
 
#if defined(__APPLE__) && !defined(__LP64__)
    static String ToString(kt_size_t value);
#endif
  
    static String ToString(kt_float value);
 
    static String ToString(kt_double value);
          
    static String ToString(kt_float value, kt_int32u precision);
 
    static String ToString(kt_double value, kt_int32u precision);
 
    static String ToString(const String& rValue);
 
    template<typename T>
    inline static String ToString(const Size2<T>& rValue);
 
    template<typename T>
    inline static String ToString(const Vector2<T>& rValue);
 
    template<typename T>
    inline static String ToString(const Vector3<T>& rValue);
 
    template<typename T>
    inline static String ToString(const Vector4<T>& rValue);
 
    static String ToString(const Quaternion& rValue);
 
    static String ToString(const Color& rValue);
 
    static String ToString(const Pose2& rValue);
 
    static String ToString(const Pose3& rValue);
 
    static kt_bool FromString(const String& rStringValue, kt_bool& rValue);
 
    static kt_bool FromString(const String& rStringValue, kt_int16s& rValue);
    
    static kt_bool FromString(const String& rStringValue, kt_int16u& rValue);
 
    static kt_bool FromString(const String& rStringValue, kt_int32s& rValue);
    
    static kt_bool FromString(const String& rStringValue, kt_int32u& rValue);
 
    static kt_bool FromString(const String& rStringValue, kt_int64s& rValue);
    
    static kt_bool FromString(const String& rStringValue, kt_int64u& rValue);
 
    static kt_bool FromString(const String& rStringValue, kt_float& rValue);
    
    static kt_bool FromString(const String& rStringValue, kt_double& rValue);
 
    static kt_bool FromString(const String& rStringValue, String& rValue);
 
    template<typename T>
    static kt_bool FromString(const String& rStringValue, Size2<T>& rValue)
    {
      kt_size_t index = rStringValue.FindFirstOf(" ");
      if (index != -1)
      {
        karto::String stringValue;
        T value;
 
        stringValue = rStringValue.SubString(0, index);
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetWidth(value);
 
        stringValue = rStringValue.SubString(index + 1, rStringValue.Size());
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetHeight(value);
 
        return true;
      }
 
      return false;
    }
 
    template<typename T>
    static kt_bool FromString(const String& rStringValue, Vector2<T>& rValue)
    {
      kt_size_t index = rStringValue.FindFirstOf(" ");
      if (index != -1)
      {
        karto::String stringValue;
        T value;
        
        stringValue = rStringValue.SubString(0, index);
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetX(value);
 
        stringValue = rStringValue.SubString(index + 1, rStringValue.Size());
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetY(value);
 
        return true;
      }
 
      return false;
    }
 
    template<typename T>
    inline static kt_bool FromString(const String& rStringValue, Vector3<T>& rValue)
    {
      karto::String tempString = rStringValue;
      kt_size_t index = tempString.FindFirstOf(" ");
      if (index != -1)
      {
        karto::String stringValue;
        T value;
 
        // Get X
        stringValue = tempString.SubString(0, index);
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetX(value);
 
        // Get Y
        tempString = rStringValue.SubString(index + 1, rStringValue.Size());
        index = tempString.FindFirstOf(" ");
 
        stringValue = tempString.SubString(0, index);
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetY(value);
 
        // Get Z
        tempString = tempString.SubString(index + 1, rStringValue.Size());
        index = tempString.FindFirstOf(" ");
 
        stringValue = tempString.SubString(index + 1, rStringValue.Size());
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetZ(value);
 
        return true;
      }
 
      return false;
    }
 
    template<typename T>
    static kt_bool FromString(const String& rStringValue, Vector4<T>& rValue)
    {
      karto::String tempString = rStringValue;
      kt_size_t index = tempString.FindFirstOf(" ");
      if (index != -1)
      {
        karto::String stringValue;
        T value;
 
        // Get X
        stringValue = tempString.SubString(0, index);
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetX(value);
 
        // Get Y
        tempString = rStringValue.SubString(index + 1, rStringValue.Size());
        index = tempString.FindFirstOf(" ");
 
        stringValue = tempString.SubString(0, index);
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetY(value);
 
        // Get Z
        tempString = tempString.SubString(index + 1, rStringValue.Size());
        index = tempString.FindFirstOf(" ");
 
        stringValue = tempString.SubString(index + 1, rStringValue.Size());
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetZ(value);
 
        // Get W
        tempString = tempString.SubString(index + 1, rStringValue.Size());
        index = tempString.FindFirstOf(" ");
 
        stringValue = tempString.SubString(index + 1, rStringValue.Size());
 
        value = 0;
        FromString(stringValue, value);
        rValue.SetW(value);
 
        return true;
      }
 
      return false;
    }
 
    static kt_bool FromString(const String& rStringValue, Quaternion& rValue);
 
    static kt_bool FromString(const String& rStringValue, Color& rValue);
 
    static kt_bool FromString(const String& rStringValue, Pose2& rValue);
 
    static kt_bool FromString(const String& rStringValue, Pose3& rValue);
 
    static String Trim(const String& rValue);
 
    static String Replace(const String& rSource, const String& rFind, const String& rReplace);
 
    static kt_bool IsLetter(char ch);
 
    static String ToLowerCase(const String &rValue);
    
    static String ToUpperCase(const String &rValue);
  }; // class StringHelper
 
 
  class KARTO_EXPORT StringBuilder
  {
  public:
    const String& ToString() const;
 
    void Clear();
 
  public:
//    StringBuilder& operator << (char value);
 
    StringBuilder& operator << (kt_int8u value);
 
    StringBuilder& operator << (kt_int16s value);
    StringBuilder& operator << (kt_int16u value);
 
    StringBuilder& operator << (kt_int32s value);
    StringBuilder& operator << (kt_int32u value);
 
    StringBuilder& operator << (kt_int64s value);
    StringBuilder& operator << (kt_int64u value);
 
#if defined(__APPLE__) && !defined(__LP64__)
 
    StringBuilder& operator << (kt_size_t value);
#endif
 
    StringBuilder& operator << (kt_float value);
    StringBuilder& operator << (kt_double value);
 
    StringBuilder& operator << (const String& rValue);
 
    StringBuilder& operator << (const StringBuilder& rValue);
 
    friend KARTO_FORCEINLINE std::ostream& operator << (std::ostream& rStream, const StringBuilder& rStringBuilder)
    {
      rStream << rStringBuilder.ToString();
      return rStream;
    }
 
  private:
    String m_String;
  }; // class StringBuilder
 
 
}
 
#endif // __OpenKarto_StringHelper_h__