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__