String.h

Go to the documentation of this file.

#ifndef SimTK_SimTKCOMMON_STRING_H_
#define SimTK_SimTKCOMMON_STRING_H_

/* -------------------------------------------------------------------------- *
 *                      SimTK Core: SimTKcommon                               *
 * -------------------------------------------------------------------------- *
 * This is part of the SimTK Core biosimulation toolkit originating from      *
 * Simbios, the NIH National Center for Physics-Based Simulation of           *
 * Biological Structures at Stanford, funded under the NIH Roadmap for        *
 * Medical Research, grant U54 GM072970. See https://simtk.org.               *
 *                                                                            *
 * Portions copyright (c) 2005-10 Stanford University and the Authors.        *
 * Authors: Michael Sherman                                                   *
 * Contributors:                                                              *
 *                                                                            *
 * Permission is hereby granted, free of charge, to any person obtaining a    *
 * copy of this software and associated documentation files (the "Software"), *
 * to deal in the Software without restriction, including without limitation  *
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,   *
 * and/or sell copies of the Software, and to permit persons to whom the      *
 * Software is furnished to do so, subject to the following conditions:       *
 *                                                                            *
 * The above copyright notice and this permission notice shall be included in *
 * all copies or substantial portions of the Software.                        *
 *                                                                            *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR *
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,   *
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL    *
 * THE AUTHORS, CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,    *
 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR      *
 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE  *
 * USE OR OTHER DEALINGS IN THE SOFTWARE.                                     *
 * -------------------------------------------------------------------------- */

// Keeps MS VC++ 8 quiet about sprintf, strcpy, etc.
#ifdef _MSC_VER
#pragma warning(disable:4996)
#endif


#include "SimTKcommon/internal/common.h"

#include <cstdio>
#include <string>
#include <limits>
#include <complex>
#include <sstream>

namespace SimTK {
    
class String : public std::string {
public:

String() { }

// uses default copy constructor, copy assignment, and destructor

String(const char* s) : std::string(s) { }

explicit String(char c) {push_back(c);}

String(const std::string& s) : std::string(s) { }

String(const String& s, int start, int len) : std::string(s,start,len) { }

operator const char*() const { return c_str(); }

char& operator[](int i) {
    assert(i >= 0);
    return std::string::operator[]((std::string::size_type)i);
}

char operator[](int i) const {
    assert(i >= 0);
    return std::string::operator[]((std::string::size_type)i);
}

char& operator[](std::string::size_type i) {return std::string::operator[](i);}
char operator[](std::string::size_type i) const {return std::string::operator[](i);}

int size() const {return (int)std::string::size();}

int length() const {return (int)std::string::length();}

explicit String(int i) { char buf[32]; sprintf(buf,"%d",i); (*this)=buf; }
explicit String(long i) { char buf[32]; sprintf(buf,"%ld",i); (*this)=buf; }
explicit String(long long i) { char buf[64]; sprintf(buf,"%lld",i); (*this)=buf; }
explicit String(unsigned int s)  { char buf[32]; sprintf(buf,"%u",s); (*this)=buf; }
explicit String(unsigned long s) { char buf[32]; sprintf(buf,"%lu",s); (*this)=buf; }
explicit String(unsigned long long s) { char buf[64]; sprintf(buf,"%llu",s); (*this)=buf; }
explicit String(float r)    { char buf[64]; sprintf(buf,"%.8g",r); (*this)=buf; }
explicit String(double r)   { char buf[64]; sprintf(buf,"%.16g",r); (*this)=buf; }
explicit String(long double r)  { char buf[64]; sprintf(buf,"%.20Lg",r); (*this)=buf; }
explicit String(std::complex<float> r)  
    { char buf[128]; sprintf(buf,"(%.8g,%.8g)",r.real(),r.imag()); (*this)=buf; }
explicit String(std::complex<double> r) 
    { char buf[128]; sprintf(buf,"(%.16g,%.16g)",r.real(),r.imag()); (*this)=buf; }
explicit String(std::complex<long double> r)    
    { char buf[128]; sprintf(buf,"(%.20Lg,%.20Lg)",r.real(),r.imag()); (*this)=buf; }
explicit String(bool b) : std::string(b?"true":"false") { }
template <class T> inline explicit String(const T& t); // see below
template <class T> inline bool tryConvertTo(T& out) const; // see below

template <class T> inline void convertTo(T& out) const; // see below

template <class T> T convertTo() const 
{   T temp; convertTo<T>(temp); return temp; }

SimTK_SimTKCOMMON_EXPORT String& toUpper();
SimTK_SimTKCOMMON_EXPORT String& toLower();
SimTK_SimTKCOMMON_EXPORT String& trimWhiteSpace();
SimTK_SimTKCOMMON_EXPORT String& replaceAllChar(char oldChar, char newChar);
static const String& getAs(const std::string& s) 
{   return reinterpret_cast<const String&>(s); }
static String& updAs(std::string& s) 
{   return reinterpret_cast<String&>(s); }
static String toUpper(const std::string& in)
{   return String(in).toUpper(); }
static String toLower(const std::string& in)
{   return String(in).toLower(); }
static SimTK_SimTKCOMMON_EXPORT String trimWhiteSpace(const std::string& in);
String& replaceAllChar(const std::string& in, char oldChar, char newChar)
{   return String(in).replaceAllChar(oldChar, newChar); }
};  

// All std::stream activity should be dealt with inline so that we don't have
// to worry about binary compatibiliy issues that can arise when passing 
// streams through the API.

// Templatized String constructor definition.
template <class T> inline
String::String(const T& t) {
    std::ostringstream stream;
    stream << t;
    *this = stream.str();
}

// This namespace-level static method should not be necessary but gcc 4.1
// still has trouble with template specialization for template member
// functions. So rather than specializing the tryConvertTo() member, I'm 
// specializing this helper function instead.
template <class T> inline static
bool tryConvertStringTo(const String& value, T& out) {
    std::istringstream sstream(value);
    sstream >> out; if (sstream.fail()) return false;
    if (sstream.eof()) return true;
    // Successful conversion but didn't use all the characters. Maybe the
    // rest is just whitespace?
    std::ws(sstream);       // Skip trailing whitespace if any.
    return sstream.eof();   // We must have used up the whole string now.
}

// This specialization ensures that we get the whole String including
// leading and trailing white space. Of course this is not useful for 
// anything but may occur as a result of some higher-level templatized 
// method that doesn't know what type it is converting here.
template<> inline
bool tryConvertStringTo(const String& value, String& out)
{   out = value; return true; }

// Same as above but for std::string output rather than String.
template<> inline
bool tryConvertStringTo(const String& value, std::string& out)
{   out = value; return true; }

// This partial specialization ensures that you can't interpret
// a String as a pointer.
template<class T> inline static
bool tryConvertStringTo(const String& value, T*& out) {
    SimTK_ERRCHK1_ALWAYS(false, "SimTK::convertStringTo(value,T*)",
        "Can't interpret a string as a pointer (%s*).",
        NiceTypeName<T>::name());
    return false; 
}

template <class T> inline bool 
String::tryConvertTo(T& out) const 
{   return tryConvertStringTo(*this, out); }

template <class T> inline void 
String::convertTo(T& out) const {
    const int MaxStr = 50;
    const bool convertOK = tryConvertTo<T>(out);
    if (convertOK) return;

    // Make sure we don't try to output more than MaxStr characters of
    // the bad string in the error message.
    String shorter = this->substr(0, MaxStr);
    if (shorter.size() < this->size()) shorter += " ...";
    SimTK_ERRCHK2_ALWAYS(convertOK, "Xml::getAs()",
        "Couldn't interpret string '%s' as type T=%s.",
        shorter.c_str(), NiceTypeName<T>::name());
}

template <class T> inline static
void convertStringTo(const String& in, T& out)
{   in.convertTo<T>(out); }

template <class T> inline static
T convertStringTo(const String& in)
{   return in.convertTo<T>(); }

}
#endif // SimTK_SimTKCOMMON_STRING_H_