rippled/modules/ripple_basics/utility/ripple_StringUtilities.h

//------------------------------------------------------------------------------
/*
    Copyright (c) 2011-2013, OpenCoin, Inc.
*/
//==============================================================================

#ifndef RIPPLE_STRINGUTILITIES_H
#define RIPPLE_STRINGUTILITIES_H

/** String utility functions.
*/

//------------------------------------------------------------------------------

// Ripple specific constant used for parsing qualities and other things
//
#define QUALITY_ONE         1000000000  // 10e9

//------------------------------------------------------------------------------

// Terminal output color codes
#define vt_f_black          "\033[30m"
#define vt_f_red            "\033[31m"
#define vt_f_green          "\033[32m"
#define vt_f_yellow         "\033[33m"
#define vt_f_blue           "\033[34m"
#define vt_f_megenta        "\033[35m"
#define vt_f_cyan           "\033[36m"
#define vt_f_white          "\033[37m"
#define vt_f_default        "\033[39m"

#define vt_b_black          "\033[40m"
#define vt_b_red            "\033[41m"
#define vt_b_green          "\033[42m"
#define vt_b_yellow         "\033[43m"
#define vt_b_blue           "\033[44m"
#define vt_b_megenta        "\033[45m"
#define vt_b_cyan           "\033[46m"
#define vt_b_white          "\033[47m"
#define vt_b_default        "\033[49m"

#define vt_f_bold_black    "\033[1m\033[30m"
#define vt_f_bold_red      "\033[1m\033[31m"
#define vt_f_bold_green    "\033[1m\033[32m"
#define vt_f_bold_yellow   "\033[1m\033[33m"
#define vt_f_bold_blue     "\033[1m\033[34m"
#define vt_f_bold_megenta  "\033[1m\033[35m"
#define vt_f_bold_cyan     "\033[1m\033[36m"
#define vt_f_bold_white    "\033[1m\033[37m"
#define vt_f_bold_default  "\033[1m\033[39m"

#define vt_bold             "\033[1m"
#define vt_dim              "\033[2m"     // does not work for xterm
#define vt_normal           "\033[22m"    // intensity

#define vt_n_enable         "\033[7m"     // negative
#define vt_n_disable        "\033[27m"

#define vt_u_single         "\033[4m"     // underline
#define vt_u_double         "\033[21m"    // does not work for xterm
#define vt_u_disable        "\033[24m"

#define vt_reset    vt_f_default vt_b_default vt_normal vt_n_disable vt_u_disable

//------------------------------------------------------------------------------

extern std::string strprintf (const char* format, ...);

extern std::string urlEncode (const std::string& strSrc);

template<class Iterator>
std::string strJoin (Iterator first, Iterator last, std::string strSeperator)
{
    std::ostringstream  ossValues;

    for (Iterator start = first; first != last; first++)
    {
        ossValues << str (boost::format ("%s%s") % (start == first ? "" : strSeperator) % *first);
    }

    return ossValues.str ();
}

char charHex (int iDigit);

template<class Iterator>
std::string strHex (Iterator first, int iSize)
{
    std::string     strDst;

    strDst.resize (iSize * 2);

    for (int i = 0; i < iSize; i++)
    {
        unsigned char c = *first++;

        strDst[i * 2]     = charHex (c >> 4);
        strDst[i * 2 + 1]   = charHex (c & 15);
    }

    return strDst;
}

inline const std::string strHex (const std::string& strSrc)
{
    return strHex (strSrc.begin (), strSrc.size ());
}

inline std::string strHex (Blob const& vucData)
{
    return strHex (vucData.begin (), vucData.size ());
}

inline std::string strHex (const uint64 uiHost)
{
    uint64_t    uBig    = htobe64 (uiHost);

    return strHex ((unsigned char*) &uBig, sizeof (uBig));
}

inline static std::string sqlEscape (const std::string& strSrc)
{
    static boost::format f ("X'%s'");
    return str (boost::format (f) % strHex (strSrc));
}

inline static std::string sqlEscape (Blob const& vecSrc)
{
    size_t size = vecSrc.size ();

    if (size == 0)
        return "X''";

    std::string j (size * 2 + 3, 0);

    unsigned char* oPtr = reinterpret_cast<unsigned char*> (&*j.begin ());
    const unsigned char* iPtr = &vecSrc[0];

    *oPtr++ = 'X';
    *oPtr++ = '\'';

    for (int i = size; i != 0; --i)
    {
        unsigned char c = *iPtr++;
        *oPtr++ = charHex (c >> 4);
        *oPtr++ = charHex (c & 15);
    }

    *oPtr++ = '\'';
    return j;
}

int charUnHex (char cDigit);
int strUnHex (std::string& strDst, const std::string& strSrc);

uint64_t uintFromHex (const std::string& strSrc);

Blob strUnHex (const std::string& strSrc);

Blob strCopy (const std::string& strSrc);
std::string strCopy (Blob const& vucSrc);

bool parseIpPort (const std::string& strSource, std::string& strIP, int& iPort);
bool parseQuality (const std::string& strSource, uint32& uQuality);

inline std::string strGetEnv (const std::string& strKey)
{
    return getenv (strKey.c_str ()) ? getenv (strKey.c_str ()) : "";
}

template<typename T> T lexical_cast_s (const std::string& string)
{
    // lexically cast a string to the selected type. Does not throw
    try
    {
        return boost::lexical_cast<T> (string);
    }
    catch (...)
    {
        return 0;
    }
}

template<typename T> std::string lexical_cast_i (const T& t)
{
    // lexicaly cast the selected type to a string. Does not throw
    try
    {
        return boost::lexical_cast<std::string> (t);
    }
    catch (...)
    {
        return "";
    }
}

template<typename T> T lexical_cast_st (const std::string& string)
{
    // lexically cast a string to the selected type. Does throw
    return boost::lexical_cast<T> (string);
}

template<typename T> std::string lexical_cast_it (const T& t)
{
    // lexicaly cast the selected type to a string. Does not throw
    return boost::lexical_cast<std::string> (t);
}

bool parseUrl (const std::string& strUrl, std::string& strScheme, std::string& strDomain, int& iPort, std::string& strPath);

#define ADDRESS(p) strHex(uint64( ((char*) p) - ((char*) 0)))

/** Convert a pointer address to a string for display purposes.
*/
extern std::string addressToString (void const* address);

/** Create a Parameters from a String.

    Parameter strings have the format:

    <key>=<value>['|'<key>=<value>]
*/
extern StringPairArray parseDelimitedKeyValueString (String s, beast_wchar delimiter='|');

#endif