stringutil.h

//=========================================================================
//  STRINGUTIL.H - part of
//                  OMNeT++/OMNEST
//           Discrete System Simulation in C++
//
//=========================================================================
 
/*--------------------------------------------------------------*
  Copyright (C) 2006-2017 OpenSim Ltd.
 
  This file is distributed WITHOUT ANY WARRANTY. See the file
  `license' for details on this and other legal matters.
*--------------------------------------------------------------*/
 
#ifndef __OMNETPP_STRINGUTIL_H
#define __OMNETPP_STRINGUTIL_H
 
#include <cstdarg>
#include <cstring>
#include <string>
#include <map>
#include <vector>
#include "simkerneldefs.h"
 
namespace omnetpp {
 
inline bool opp_isempty(const char *s)  {return !s || !s[0];}
 
inline const char *opp_nulltoempty(const char *s)  {return s ? s : "";}
 
inline const char *opp_emptytodefault(const char *s, const char *defaultString)  {return opp_isempty(s) ? defaultString : s;}
 
SIM_API bool opp_isblank(const char *txt);
 
inline int opp_strlen(const char *s)
{
    return s ? strlen(s) : 0;
}
 
inline char *opp_strdup(const char *s)
{
    if (!s || !s[0]) return nullptr;
    char *p = new char[strlen(s)+1];
    strcpy(p,s);
    return p;
}
 
inline char *opp_strcpy(char *s1, const char *s2)
{
    return strcpy(s1, s2 ? s2 : "");
}
 
inline int opp_strcmp(const char *s1, const char *s2)
{
    if (s1)
        return s2 ? strcmp(s1,s2) : (*s1 ? 1 : 0);
    else
        return (s2 && *s2) ? -1 : 0;
}
 
SIM_API std::string opp_trim(const std::string& text);
 
SIM_API char *opp_strprettytrunc(char *dest, const char *src, unsigned maxlen);
 
_OPP_GNU_ATTRIBUTE(format(printf, 1, 2))
SIM_API std::string opp_stringf(const char *fmt, ...);
 
SIM_API std::string opp_vstringf(const char *fmt, va_list& args);
 
SIM_API std::string opp_replacesubstring(const std::string& text, const std::string& substring, const std::string& replacement, bool replaceAll);
 
SIM_API std::vector<std::string> opp_splitandtrim(const std::string& text);
 
SIM_API std::vector<std::string> opp_split(const std::string& text, const std::string& separator);
 
SIM_API std::vector<std::string> opp_splitandtrim(const std::string& text, const std::string& separator);
 
SIM_API bool opp_stringbeginswith(const char *s, const char *prefix);
 
SIM_API bool opp_stringendswith(const char *s, const char *ending);
 
SIM_API std::string opp_substringbefore(const std::string& str, const std::string& substr);
 
SIM_API std::string opp_substringafter(const std::string& str, const std::string& substr);
 
SIM_API std::string opp_substringbeforelast(const std::string& str, const std::string& substr);
 
SIM_API std::string opp_substringafterlast(const std::string& str, const std::string& substr);
 
SIM_API std::string opp_removestart(const std::string& str, const std::string& prefix);
 
SIM_API std::string opp_removeend(const std::string& str, const std::string& end);
 
SIM_API std::string opp_strlower(const char *s);
 
SIM_API std::string opp_strupper(const char *s);
 
SIM_API const char *opp_strnistr(const char *haystack, const char *needle, int n, bool caseSensitive);
 
SIM_API int opp_strdictcmp(const char *s1, const char *s2);
 
SIM_API std::string opp_join(const char *separator, const char *s1, const char *s2);
 
SIM_API std::string opp_join(const char *separator, const std::string& s1, const std::string& s2);
 
SIM_API std::string opp_join(const char **strings, const char *separator, bool skipEmpty=false, char quoteChar=0);
 
SIM_API std::string opp_join(const char **strings, int n, const char *separator, bool skipEmpty=false, char quoteChar=0);
 
SIM_API std::string opp_join(const std::vector<std::string>& strings, const char *separator, bool skipEmpty=false, char quoteChar=0);
 
SIM_API char *opp_itoa(char *buf, int d);
 
SIM_API char *opp_ltoa(char *buf, long d);
 
SIM_API char *opp_i64toa(char *buf, int64_t d);
 
SIM_API char *opp_dtoa(char *buf, const char *format, double d);
 
SIM_API long opp_strtol(const char *s, char **endptr);
 
SIM_API long opp_atol(const char *s);
 
SIM_API unsigned long opp_strtoul(const char *s, char **endptr);
 
SIM_API unsigned long opp_atoul(const char *s);
 
SIM_API long long opp_strtoll(const char *s, char **endptr);
 
SIM_API long long opp_atoll(const char *s);
 
SIM_API unsigned long long opp_strtoull(const char *s, char **endptr);
 
SIM_API unsigned long long opp_atoull(const char *s);
 
SIM_API double opp_strtod(const char *s, char **endptr);
 
SIM_API double opp_atof(const char *s);
 
}  // namespace omnetpp
 
#endif