tjstring.h

/***************************************************************************
                          tjstring.h  -  description
                             -------------------
    begin                : Mon Mar 10 2003
    copyright            : (C) 2000-2021 by Thies Jochimsen
    email                : thies@jochimsen.de
 ***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
 
#ifndef TJSTRING_H
#define TJSTRING_H
 
 
#include <tjutils/tjutils.h>
//#include <tjutils/tjstream.h>
#include <tjutils/tjtools.h>
 
#define _DEFAULT_DIGITS_ 5
#define _DEFAULT_LINEWIDTH_ 74
 
#ifdef USING_WIN32
#define SEPARATOR_STR  "\\"
#define SEPARATOR_CHAR '\\'
#else
#define SEPARATOR_STR  "/"
#define SEPARATOR_CHAR '/'
#endif
 
 
 
// class for debugging string component
class StringComp {
 public:
  static const char* get_compName();
};
 
 
 
enum whichOccurences {allOccurences,firstOccurence};
 
 
//  String helper functions
 
 
  STD_string replaceStr(const STD_string& s, const STD_string& searchstring, const STD_string& replacement, whichOccurences mode=allOccurences);
 
  STD_string extract(const STD_string& s, const STD_string& blockbegin, const STD_string& blockend, bool hierachical=false, int beginpos=0);
 
 
  STD_string rmblock(const STD_string& s, const STD_string& blockbegin, const STD_string& blockend,
                                     bool rmbegin=true, bool rmend=true, bool rmall=true, bool hierachical=false);
 
  
  STD_string toupperstr(const STD_string& s);
 
 
  STD_string tolowerstr(const STD_string& s);
 
enum expFormat {autoExp, alwaysExp, neverExp};
 
 
  STD_string ftos (double f, unsigned int digits=_DEFAULT_DIGITS_, expFormat eformat=autoExp);
 
 
  STD_string itos (int i, unsigned int maxabs=0);
 
  STD_string ptos (const void* p);
 
  STD_string n_times(const STD_string& s, unsigned int n);
 
  STD_string justificate(const STD_string& s, unsigned int indention=0,bool ignore_firstline=false, unsigned int linewidth=_DEFAULT_LINEWIDTH_);
 
 
  int textbegin(const STD_string& s, int startpos=0, const char custom_separator=0);
 
  int sepbegin(const STD_string& s, int startpos=0, const char custom_separator=0);
 
  STD_string shrink(const STD_string& s);
 
  int noccur(const STD_string& s, const STD_string& searchstring);
 
  STD_string dos2unix(const STD_string& s);
 
  int load(STD_string& str, const STD_string& filename);
 
  int write(const STD_string& str, const STD_string& filename, fopenMode mode=overwriteMode);
 
 
 
#endif