dstring.h File Reference

#include <string>
#include <string_view>
#include <algorithm>
#include <cctype>
#include <cstring>
#include <cstdio>
#include <cstdlib>
#include <cstdint>
#include <ostream>
#include "utf8.h"

Include dependency graph for dstring.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	DString
	A String class for use with Doxygen wrapping std::string and adding some additional functionality offered by QCString. More...
struct	std::hash< DString >

Namespaces
namespace	std

Macros
#define	ASSERT(x)
#define	HAS_IMPLICIT_CAST_TO_PLAIN_C_STRING   0
#define	HAS_CHARACTER_APPEND_OPERATOR   1

Typedefs
using	JavaCCString = std::basic_string<JAVACC_CHAR_TYPE>

Functions
char *	dstrdup (const char *s)
void	dstrfree (const char *s)
	Frees the memory allocated using dstrdup().
uint32_t	dstrlen (const char *str)
	Returns the length of string str, or 0 if a null pointer is passed.
char *	dstrcpy (char *dst, const char *src)
char *	dstrncpy (char *dst, const char *src, size_t len)
bool	disempty (const char *s)
int	dstrcmp (const char *str1, const char *str2)
int	dstrncmp (const char *str1, const char *str2, size_t len)
bool	disspace (char c)
int	dstricmp (const char *str1, const char *str2)
int	dstricmp_sort (const char *str1, const char *str2)
int	dstrnicmp (const char *str1, const char *str2, size_t len)
bool	operator== (const DString &s1, const DString &s2)
bool	operator== (const DString &s1, const char *s2)
bool	operator== (const char *s1, const DString &s2)
bool	operator!= (const DString &s1, const DString &s2)
bool	operator!= (const DString &s1, const char *s2)
bool	operator!= (const char *s1, const DString &s2)
bool	operator< (const DString &s1, const DString &s2)
bool	operator< (const DString &s1, const char *s2)
bool	operator< (const char *s1, const DString &s2)
bool	operator<= (const DString &s1, const char *s2)
bool	operator<= (const char *s1, const DString &s2)
bool	operator> (const DString &s1, const char *s2)
bool	operator> (const char *s1, const DString &s2)
bool	operator>= (const DString &s1, const char *s2)
bool	operator>= (const char *s1, const DString &s2)
DString	operator+ (const DString &s1, const DString &s2)
DString	operator+ (const DString &s1, const char *s2)
DString	operator+ (const char *s1, const DString &s2)
const char *	qPrint (const char *s)
const char *	qPrint (const DString &s)
const char *	qPrint (const std::string &s)
std::string	toStdString (const DString &s)
int	dstrcmp (const DString &str1, const char *str2)
int	dstrcmp (const char *str1, const DString &str2)
int	dstrcmp (const DString &str1, const DString &str2)
int	dstricmp (const DString &str1, const char *str2)
int	dstricmp (const char *str1, const DString &str2)
int	dstricmp (const DString &str1, const DString &str2)
int	dstricmp_sort (const DString &str1, const char *str2)
int	dstricmp_sort (const char *str1, const DString &str2)
int	dstricmp_sort (const DString &str1, const DString &str2)
int	dstrnicmp (const DString &str1, const char *str2, size_t len)
int	dstrnicmp (const char *str1, const DString &str2, size_t len)
int	dstrnicmp (const DString &str1, const DString &str2, size_t len)
DString	substitute (const DString &str, const DString &find, const DString &replace)
	substitute all occurrences of src in s by dst
DString	substitute (const DString &str, const char *find, const char *replace)
DString	substitute (const DString &s, const DString &src, const DString &dst, int skip_seq)
	substitute all occurrences of src in s by dst, but skip each consecutive sequence of src where the number consecutive src matches skip_seq; if skip_seq is negative, skip any number of consecutive src
DString	substitute (const DString &s, char srcChar, char dstChar)
std::ostream &	operator<< (std::ostream &os, const DString &s)
void	swap (DString &s1, DString &s2)

Macro Definition Documentation

ASSERT

#define ASSERT

(

x

)

Value:

if ( !(x) )\
fprintf(stderr,"ASSERT: \"%s\" in %s (%d)\n",#x,__FILE__,__LINE__)

Definition at line 29 of file dstring.h.

#define ASSERT(x)  if ( !(x) )\
        fprintf(stderr,"ASSERT: \"%s\" in %s (%d)\n",#x,__FILE__,__LINE__)

Referenced by anonymous_namespace{tagreader.cpp}::TagFileParser::addIncludes(), addMembersToMemberGroup(), RTFGenerator::beginRTFDocument(), DirDefImpl::createNewDir(), FTVHelp::decContentsDepth(), DocCite::DocCite(), DocRef::DocRef(), DotInclDepGraph::DotInclDepGraph(), HtmlGenerator::endSection(), ManGenerator::endSection(), generateDEFForMember(), generateXMLForClass(), generateXMLForMember(), DotClassGraph::getBaseName(), DotClassGraph::getImgAltText(), RTFDocVisitor::getListTable(), DotClassGraph::getMapLabel(), DefinitionImpl::getSourceFileBase(), DocPara::handleHtmlEndTag(), DocPara::handleHtmlStartTag(), DocPara::handleXRefItem(), MemberDefImpl::isConstructor(), MemberDefImpl::isDestructor(), MemberDefImpl::isLinkableInProject(), matchArguments2(), MemberList::numDecMembers(), MemberList::numDocMembers(), DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), ManDocVisitor::operator()(), RTFDocVisitor::operator()(), XmlDocVisitor::operator()(), DocXRefItem::parse(), parseFilesMultiThreading(), parseFilesSingleThreading(), resolveRef(), setDotFontPath(), setOutput(), HtmlGenerator::startSection(), LatexGenerator::startSection(), ManGenerator::startSection(), RTFGenerator::startSection(), MemberDefImpl::writeDeclaration(), DotNode::writeDEF(), DotNode::writeDocbook(), writeMemberList(), writeObjCMethodCall(), VhdlDocGen::writeVHDLDeclaration(), and DotNode::writeXML().

HAS_CHARACTER_APPEND_OPERATOR

#define HAS_CHARACTER_APPEND_OPERATOR   1

Definition at line 664 of file dstring.h.

HAS_IMPLICIT_CAST_TO_PLAIN_C_STRING

#define HAS_IMPLICIT_CAST_TO_PLAIN_C_STRING   0

Definition at line 625 of file dstring.h.

Typedef Documentation

JavaCCString

using JavaCCString = std::basic_string<JAVACC_CHAR_TYPE>

Definition at line 81 of file dstring.h.

Function Documentation

disempty()

bool disempty ( const char * s )

inline

Definition at line 52 of file dstring.h.

{ return s==nullptr || *s=='\0'; }

References disempty().

Referenced by disempty(), dstrcmp(), and dstrncmp().

disspace()

bool disspace ( char c )

inline

Definition at line 67 of file dstring.h.

{ return c==' ' || c=='\t' || c=='\n' || c=='\r'; }

References disspace().

Referenced by disspace(), AnchorGenerator::generate(), Markdown::Private::processQuotations(), DString::quoted(), removeRedundantWhiteSpace(), DString::removeWhiteSpace(), DString::simplifyWhiteSpace(), DString::stripWhiteSpace(), DString::toLong(), DString::toUInt64(), DString::toULong(), and DotAttributes::updateValue().

dstrcmp() [1/4]

int dstrcmp ( const char * str1, const char * str2 )

inline

Definition at line 55 of file dstring.h.

{ return (str1 && str2) ? strcmp(str1,str2) :     // both non-empty
         (disempty(str1) && disempty(str2)) ? 0 : // both empty
         disempty(str1) ? -1 : 1;                 // one empty, other non-empty
}

References disempty(), and dstrcmp().

Referenced by convertMapFile(), dstrcmp(), dstrcmp(), dstrcmp(), dstrcmp(), dstricmp_sort(), KeywordHash::find(), operator!=(), operator!=(), operator<(), operator<(), operator<(), operator<=(), operator<=(), operator==(), operator==(), operator>(), operator>(), operator>=(), operator>=(), readConfiguration(), startFontClass(), startFontClass(), and startFontClass().

dstrcmp() [2/4]

int dstrcmp ( const char * str1, const DString & str2 )

inline

Definition at line 796 of file dstring.h.

{
  return dstrcmp(str1,str2.data());
}

References DString::data(), and dstrcmp().

dstrcmp() [3/4]

int dstrcmp ( const DString & str1, const char * str2 )

inline

Definition at line 791 of file dstring.h.

{
  return dstrcmp(str1.data(),str2);
}

References DString::data(), and dstrcmp().

dstrcmp() [4/4]

int dstrcmp ( const DString & str1, const DString & str2 )

inline

Definition at line 801 of file dstring.h.

{
  return dstrcmp(str1.data(),str2.data());
}

References DString::data(), and dstrcmp().

dstrcpy()

char * dstrcpy ( char * dst, const char * src )

inline

Definition at line 47 of file dstring.h.

{ return src ? strcpy(dst, src) : nullptr; }

References dstrcpy().

Referenced by dstrcpy(), SymbolResolver::Private::getResolvedTypeRec(), substitute(), and substitute().

dstrdup()

char * dstrdup

(

const char *

s

)

Returns a copy of a string s. Note that memory is passed to the caller, use dstrfree() to release.

Definition at line 415 of file dstring.cpp.

{
  if ( !str ) return nullptr;
  char *dst = new char[dstrlen(str)+1];
  return strcpy( dst, str );
}

References dstrdup(), and dstrlen().

Referenced by dstrdup().

dstrfree()

void dstrfree

(

const char *

s

)

Frees the memory allocated using dstrdup().

Definition at line 422 of file dstring.cpp.

{
  delete [](str);
}

References dstrfree().

Referenced by dstrfree().

dstricmp() [1/4]

int dstricmp	(	const char *	str1,
		const char *	str2 )

Definition at line 435 of file dstring.cpp.

{
  if ( !s1 || !s2 )
  {
    return s1 == s2 ? 0 : static_cast<int>(s2 - s1);
  }
  int res = 0;
  char c = 0;
  for ( ; !(res = ((c=toLowerChar(*s1)) - toLowerChar(*s2))); s1++, s2++ )
  {
    if ( !c ) // strings are equal
    {
      break;
    }
  }
  return res;
}

References dstricmp(), and toLowerChar().

Referenced by compareString(), dstricmp(), dstricmp(), dstricmp(), dstricmp(), dstricmp_sort(), VhdlDocGen::findAllArchitectures(), DocGroup::findExistingGroup(), FlowChart::findLabel(), VhdlDocGen::findVhdlClass(), readConfiguration(), stripFromPath(), transcodeCharacterBuffer(), transcodeCharacterStringToUTF8(), FlowChart::writeFlowLinks(), ClassDefImpl::writeIncludeFilesForSlice(), and VhdlDocGen::writeProcedureProto().

dstricmp() [2/4]

int dstricmp ( const char * str1, const DString & str2 )

inline

Definition at line 811 of file dstring.h.

{
  return dstricmp(str1,str2.data());
}

References DString::data(), and dstricmp().

dstricmp() [3/4]

int dstricmp ( const DString & str1, const char * str2 )

inline

Definition at line 806 of file dstring.h.

{
  return dstricmp(str1.data(),str2);
}

References DString::data(), and dstricmp().

dstricmp() [4/4]

int dstricmp ( const DString & str1, const DString & str2 )

inline

Definition at line 816 of file dstring.h.

{
  return dstricmp(str1.data(),str2.data());
}

References DString::data(), and dstricmp().

dstricmp_sort() [1/4]

int dstricmp_sort ( const char * str1, const char * str2 )

inline

Definition at line 72 of file dstring.h.

{
  int result = dstricmp(str1,str2);
  return result==0 ? dstrcmp(str1,str2) : result;
}

References dstrcmp(), dstricmp(), and dstricmp_sort().

Referenced by buildDirectories(), compareDirDefs(), compareFileDefs(), dstricmp_sort(), dstricmp_sort(), dstricmp_sort(), dstricmp_sort(), genericCompareMembers(), DirDefImpl::matchPath(), parseInput(), searchInputFiles(), FileDefImpl::sortMemberLists(), GroupDefImpl::sortMemberLists(), ModuleDefImpl::sortMemberLists(), NamespaceDefImpl::sortMemberLists(), Requirement::sortReferences(), and HtmlHelpIndex::writeFields().

dstricmp_sort() [2/4]

int dstricmp_sort ( const char * str1, const DString & str2 )

inline

Definition at line 826 of file dstring.h.

{
  return dstricmp_sort(str1,str2.data());
}

References DString::data(), and dstricmp_sort().

dstricmp_sort() [3/4]

int dstricmp_sort ( const DString & str1, const char * str2 )

inline

Definition at line 821 of file dstring.h.

{
  return dstricmp_sort(str1.data(),str2);
}

References DString::data(), and dstricmp_sort().

dstricmp_sort() [4/4]

int dstricmp_sort ( const DString & str1, const DString & str2 )

inline

Definition at line 831 of file dstring.h.

{
  return dstricmp_sort(str1.data(),str2.data());
}

References DString::data(), and dstricmp_sort().

dstrlen()

uint32_t dstrlen ( const char * str )

inline

Returns the length of string str, or 0 if a null pointer is passed.

Definition at line 44 of file dstring.h.

{ return str ? static_cast<uint32_t>(strlen(str)) : 0; }

References dstrlen().

Referenced by DString::contains(), dstrdup(), dstrlen(), DocParser::findDocsForMemberOrCompound(), getArg(), DString::insert(), VhdlDocGen::prepareComment(), DString::rfind_insensitive(), selectBlocks(), substituteKeywords(), writeClassTreeInsideNamespaceElement(), writeNamespaceIndex(), and writeNamespaceTreeElement().

dstrncmp()

int dstrncmp ( const char * str1, const char * str2, size_t len )

inline

Definition at line 61 of file dstring.h.

{ return (str1 && str2) ? strncmp(str1,str2,len) :  // both non-empty
         (disempty(str1) && disempty(str2)) ? 0 :   // both empty
         disempty(str1) ? -1 : 1;                   // one empty other non-empty
}

References disempty(), and dstrncmp().

Referenced by checkBlocks(), DString::contains(), dstrncmp(), Markdown::Private::findEmphasisChar(), Markdown::Private::findEndOfLine(), literal_at(), literal_at(), Markdown::Private::processBlocks(), Markdown::Private::processQuotations(), Markdown::Private::processSpecialCommand(), removeIdsAndMarkers(), selectBlocks(), skipToEndMarker(), substitute(), and substituteKeywords().

dstrncpy()

char * dstrncpy	(	char *	dst,
		const char *	src,
		size_t	len )

Definition at line 427 of file dstring.cpp.

{
  if ( !src ) return nullptr;
  strncpy( dst, src, len );
  if ( len > 0 ) dst[len-1] = '\0';
  return dst;
}

References dstrncpy().

Referenced by dstrncpy().

dstrnicmp() [1/4]

int dstrnicmp	(	const char *	str1,
		const char *	str2,
		size_t	len )

Definition at line 453 of file dstring.cpp.

{
  if ( !s1 || !s2 )
  {
    return static_cast<int>(s2 - s1);
  }
  for ( ; len--; s1++, s2++ )
  {
    char c = toLowerChar(*s1);
    int res = c-toLowerChar(*s2);
    if ( res!=0 ) // strings are not equal
    {
      return res;
    }
    if ( c==0 ) // strings are equal
    {
      break;
    }
  }
  return 0;
}

References dstrnicmp(), and toLowerChar().

Referenced by DString::contains(), dstrnicmp(), dstrnicmp(), dstrnicmp(), dstrnicmp(), and DString::rfind_insensitive().

dstrnicmp() [2/4]

int dstrnicmp ( const char * str1, const DString & str2, size_t len )

inline

Definition at line 842 of file dstring.h.

{
  return dstrnicmp(str1,str2.data(),len);
}

References DString::data(), and dstrnicmp().

dstrnicmp() [3/4]

int dstrnicmp ( const DString & str1, const char * str2, size_t len )

inline

Definition at line 837 of file dstring.h.

{
  return dstrnicmp(str1.data(),str2,len);
}

References DString::data(), and dstrnicmp().

dstrnicmp() [4/4]

int dstrnicmp ( const DString & str1, const DString & str2, size_t len )

inline

Definition at line 847 of file dstring.h.

{
  return dstrnicmp(str1.data(),str2.data(),len);
}

References DString::data(), and dstrnicmp().

operator!=() [1/3]

bool operator!= ( const char * s1, const DString & s2 )

inline

Definition at line 719 of file dstring.h.

{ return dstrcmp(s1,s2.data()) != 0; }

References DString::data(), dstrcmp(), and operator!=().

operator!=() [2/3]

bool operator!= ( const DString & s1, const char * s2 )

inline

Definition at line 716 of file dstring.h.

{ return dstrcmp(s1.data(),s2) != 0; }

References DString::data(), dstrcmp(), and operator!=().

operator!=() [3/3]

bool operator!= ( const DString & s1, const DString & s2 )

inline

Definition at line 713 of file dstring.h.

{ return s1.str() != s2.str(); }

References operator!=(), and DString::str().

operator+() [1/3]

DString operator+ ( const char * s1, const DString & s2 )

inline

Definition at line 762 of file dstring.h.

{
    DString tmp(s1);
    tmp.append(s2);
    return tmp;
}

References DString::append(), and operator+().

operator+() [2/3]

DString operator+ ( const DString & s1, const char * s2 )

inline

Definition at line 755 of file dstring.h.

{
    DString tmp(s1);
    tmp.append(s2);
    return tmp;
}

References DString::append(), and operator+().

operator+() [3/3]

DString operator+ ( const DString & s1, const DString & s2 )

inline

Definition at line 749 of file dstring.h.

{
  return DString(s1.str()+s2.str());
}

References DString::DString(), operator+(), and DString::str().

Referenced by operator+(), operator+(), and operator+().

operator<() [1/3]

bool operator< ( const char * s1, const DString & s2 )

inline

Definition at line 728 of file dstring.h.

{ return dstrcmp(s1,s2.data()) < 0; }

References DString::data(), dstrcmp(), and operator<().

operator<() [2/3]

bool operator< ( const DString & s1, const char * s2 )

inline

Definition at line 725 of file dstring.h.

{ return dstrcmp(s1.data(),s2) < 0; }

References DString::data(), dstrcmp(), and operator<().

operator<() [3/3]

bool operator< ( const DString & s1, const DString & s2 )

inline

Definition at line 722 of file dstring.h.

{ return dstrcmp(s1.data(),s2.data()) < 0; }

References DString::data(), dstrcmp(), and operator<().

Referenced by operator<(), operator<(), and operator<().

operator<<()

std::ostream & operator<< ( std::ostream & os, const DString & s )

inline

Definition at line 867 of file dstring.h.

{
    os << s.str();
    return os;
}

References operator<<(), and DString::str().

Referenced by operator<<().

operator<=() [1/2]

bool operator<= ( const char * s1, const DString & s2 )

inline

Definition at line 734 of file dstring.h.

{ return dstrcmp(s1,s2.data()) <= 0; }

References DString::data(), dstrcmp(), and operator<=().

operator<=() [2/2]

bool operator<= ( const DString & s1, const char * s2 )

inline

Definition at line 731 of file dstring.h.

{ return dstrcmp(s1.data(),s2) <= 0; }

References DString::data(), dstrcmp(), and operator<=().

Referenced by operator<=(), and operator<=().

operator==() [1/3]

bool operator== ( const char * s1, const DString & s2 )

inline

Definition at line 710 of file dstring.h.

{ return dstrcmp(s1,s2.data()) == 0; }

References DString::data(), dstrcmp(), and operator==().

operator==() [2/3]

bool operator== ( const DString & s1, const char * s2 )

inline

Definition at line 707 of file dstring.h.

{ return dstrcmp(s1.data(),s2) == 0; }

References DString::data(), dstrcmp(), and operator==().

operator==() [3/3]

bool operator== ( const DString & s1, const DString & s2 )

inline

Definition at line 704 of file dstring.h.

{ return s1.str() == s2.str(); }

References operator==(), and DString::str().

operator>() [1/2]

bool operator> ( const char * s1, const DString & s2 )

inline

Definition at line 740 of file dstring.h.

{ return dstrcmp(s1,s2.data()) > 0; }

References DString::data(), dstrcmp(), and operator>().

operator>() [2/2]

bool operator> ( const DString & s1, const char * s2 )

inline

Definition at line 737 of file dstring.h.

{ return dstrcmp(s1.data(),s2) > 0; }

References DString::data(), dstrcmp(), and operator>().

Referenced by operator>(), and operator>().

operator>=() [1/2]

bool operator>= ( const char * s1, const DString & s2 )

inline

Definition at line 746 of file dstring.h.

{ return dstrcmp(s1,s2.data()) >= 0; }

References DString::data(), dstrcmp(), and operator>=().

operator>=() [2/2]

bool operator>= ( const DString & s1, const char * s2 )

inline

Definition at line 743 of file dstring.h.

{ return dstrcmp(s1.data(),s2) >= 0; }

References DString::data(), dstrcmp(), and operator>=().

Referenced by operator>=(), and operator>=().

qPrint() [1/3]

const char * qPrint ( const char * s )

inline

Definition at line 769 of file dstring.h.

{
  if (s) return s; else return "";
}

References qPrint().

Referenced by addIncludeFile(), ModuleDefImpl::addMemberToModule(), addModule(), addSubprogram(), DirDefImpl::addUsesDependency(), addVariable(), addXRefItemToEntry(), buildFileList(), Config::checkAndCorrect(), DocParser::checkArgumentName(), cleanupInlineGraph(), XMLCodeGenerator::codify(), codifyLines(), convertCppComments(), createCroppedEPS(), createCroppedPDF(), createDVIFile(), createEPSbboxFile(), createPNG(), createPostscriptFile(), createSVGFromPDF(), createSVGFromPDFviaInkscape(), DebugLex::DebugLex(), dumpDocNodeList(), encodeForOutput(), DocParser::errorHandleDefaultToken(), DocParser::findAndCopyImage(), findGlobalMember(), findMemberLink(), DocTokenizer::findSections(), VhdlDocGen::findVhdlClass(), generateClassMemberLink(), generateClassMemberLink(), generateClassOrGlobalLink(), generateClassOrGlobalLink(), generateFunctionLink(), generateFunctionLink(), generateMemberLink(), generatePHPVariableLink(), generateSqlite3ForClass(), generateSqlite3ForFile(), generateSqlite3ForMember(), DotGfxHierarchyTable::getBaseName(), getLink(), getLinkInScope(), handle_warn_as_error(), handleCommentBlock(), DocParser::handleRef(), handleToc(), mergeArguments(), PerlModDocVisitor::operator()(), PerlModDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), PrintDocVisitor::operator()(), ConfigImpl::parse(), DocMscFile::parse(), DocSecRefList::parse(), LayoutDocManager::parse(), CCodeParser::parseCode(), FortranCodeParser::parseCode(), LexCodeParser::parseCode(), PythonCodeParser::parseCode(), SQLCodeParser::parseCode(), VHDLCodeParser::parseCode(), XMLCodeParser::parseCode(), CommentScanner::parseCommentBlock(), COutlineParser::parseInput(), FortranOutlineParser::parseInput(), LexOutlineParser::parseInput(), parseInput(), PythonOutlineParser::parseInput(), popScope(), FlowChart::printNode(), Markdown::process(), Preprocessor::processFile(), pushBuffer(), pushScope(), qPrint(), qPrint(), qPrint(), readIncludeFile(), DotNode::renumberNodes(), SymbolResolver::resolveSymbol(), runHtmlHelpCompiler(), saveObjCContext(), scanner_abort(), setCallContextForVar(), setClassScope(), setTranslator(), startCodeLine(), stripClassName(), writeDiaGraphFromFile(), DirDefImpl::writeDocumentation(), ClassDiagram::writeFigure(), FileDefImpl::writeIncludedByGraph(), FileDefImpl::writeIncludeGraph(), writeMscGraphFromFile(), writeMultiLineCodeLink(), writeObjCMethodCall(), and DebugLex::~DebugLex().

qPrint() [2/3]

const char * qPrint ( const DString & s )

inline

Definition at line 774 of file dstring.h.

{
  if (!s.empty()) return s.data(); else return "";
}

References DString::data(), DString::empty(), and qPrint().

qPrint() [3/3]

const char * qPrint ( const std::string & s )

inline

Definition at line 779 of file dstring.h.

{
  return s.c_str();
}

References qPrint().

substitute() [1/4]

DString substitute ( const DString & s, char srcChar, char dstChar )

inline

Definition at line 860 of file dstring.h.

{
  std::string ss = s.str();
  std::replace(ss.begin(),ss.end(),srcChar,dstChar);
  return DString(ss);
}

References DString::DString(), DString::str(), and substitute().

substitute() [2/4]

DString substitute	(	const DString &	s,
		const DString &	src,
		const DString &	dst,
		int	skip_seq )

substitute all occurrences of src in s by dst, but skip each consecutive sequence of src where the number consecutive src matches skip_seq; if skip_seq is negative, skip any number of consecutive src

Definition at line 517 of file dstring.cpp.

{
  if (s.empty() || src.empty()) return s;
  const char *p = nullptr, *q = nullptr;
  size_t srcLen = src.length();
  size_t dstLen = dst.length();
  size_t resLen = 0;
  if (srcLen!=dstLen)
  {
    int count = 0;
    for (p=s.data(); (q=strstr(p,src.data()))!=nullptr; p=q+srcLen) count++;
    resLen = s.length()+count*(dstLen-srcLen);
  }
  else // result has same size as s
  {
    resLen = s.length();
  }
  DString result(resLen, DString::ExplicitSize);
  char *r = result.rawData();
  for (p = s.data(); (q=strstr(p,src.data()))!=nullptr; p=q+srcLen)
  {
    // search a consecutive sequence of src
    int seq = 0, skip = 0;
    if (skip_seq)
    {
      for (const char *n=q+srcLen; dstrncmp(n,src.data(),srcLen)==0; seq=1+skip, n+=srcLen)
        ++skip; // number of consecutive src after the current one
 
      // verify the allowed number of consecutive src to skip
      if (skip_seq > 0 && skip_seq != seq)
        seq = skip = 0;
    }
 
    // skip a consecutive sequence of src when necessary
    int l = static_cast<int>((q + seq * srcLen)-p);
    memcpy(r,p,l);
    r+=l;
 
    if (skip)
    {
      // skip only the consecutive src found after the current one
      q += skip * srcLen;
      // the next loop will skip the current src, aka (p=q+srcLen)
      continue;
    }
 
    if (dstLen>0) memcpy(r,dst.data(),dstLen);
    r+=dstLen;
  }
  dstrcpy(r,p);
  result.resize(strlen(result.data()));
  //printf("substitute(%s,%s,%s)->%s\n",s,src,dst,result.data());
  return result;
}

References DString::data(), dstrcpy(), dstrncmp(), DString::empty(), DString::ExplicitSize, DString::length(), DString::rawData(), DString::resize(), and substitute().

substitute() [3/4]

DString substitute ( const DString & str, const char * find, const char * replace )

inline

Definition at line 854 of file dstring.h.

{
  return substitute(str,DString(find),DString(replace));
}

References DString::DString(), and substitute().

substitute() [4/4]

DString substitute	(	const DString &	str,
		const DString &	find,
		const DString &	replace )

substitute all occurrences of src in s by dst

Definition at line 476 of file dstring.cpp.

{
  if (s.empty() || src.empty()) return s;
  const char *q = nullptr, *p = nullptr;
  size_t srcLen = src.length();
  size_t dstLen = dst.length();
  size_t resLen = 0;
  if (srcLen!=dstLen)
  {
    int count = 0;
    for (p = s.data(); (q=strstr(p,src.data()))!=nullptr; p=q+srcLen) count++;
    resLen = s.length()+count*(dstLen-srcLen);
  }
  else // result has same size as s
  {
    resLen = s.length();
  }
  DString result(resLen, DString::ExplicitSize);
  char *r = result.rawData();
  for (p = s.data(); (q=strstr(p,src.data()))!=nullptr; p=q+srcLen)
  {
    int l = static_cast<int>(q-p);
    memcpy(r,p,l);
    r+=l;
 
    if (dstLen>0) memcpy(r,dst.data(),dstLen);
    r+=dstLen;
  }
  if (r)
  {
    dstrcpy(r,p);
  }
  //printf("substitute(%s,%s,%s)->%s\n",s,src,dst,result.data());
  return result;
}

References DString::data(), dstrcpy(), DString::empty(), DString::ExplicitSize, DString::length(), DString::rawData(), and substitute().

Referenced by abbreviate(), addEnumValuesToEnums(), FlowChart::addFlowChart(), addFrom(), addGlobalFunction(), HtmlHelpIndex::addItem(), MemberDefImpl::addListReference(), addMemberFunction(), addMethodToClass(), addModule(), addPageToContext(), Markdown::Private::addStrEscapeUtf8Nbsp(), addVariable(), addVariableToClass(), buildListOfUsingDecls(), buildNamespaceList(), convertFileId2Var(), Portable::correctPath(), MemberDefImpl::displayDefinition(), findDirDocumentation(), DocParser::findDocsForMemberOrCompound(), findGroupScope(), findMember(), findUsingDeclarations(), findUsingDirectives(), fixSpaces(), format_warn(), generateClassOrGlobalLink(), generateClassOrGlobalLink(), generateJSLink(), generateJSNavTree(), RefList::generatePage(), VhdlDocGen::getClassName(), DocPara::handleStartCode(), HtmlGenerator::init(), linkifyText(), linkToText(), makeDisplayName(), makeDisplayName(), matchExcludedSymbols(), Markdown::process(), Markdown::Private::processLink(), resolveRef(), DotFilePatcher::run(), SearchIndex::setCurrentDoc(), stripIndentation(), substitute(), substitute(), substitute(), substitute(), substituteHtmlKeywords(), substituteLatexKeywords(), Portable::system(), ConfigImpl::takeStartComment(), ConfigImpl::takeStoreRepl(), ConfigImpl::takeUserComment(), unescapeCRef(), validatingParseDoc(), warn_line(), MemberDefImpl::warnIfUndocumented(), writeAlphabeticalClassList(), MemberDefImpl::writeDeclaration(), MemberList::writeDeclarations(), writeDefArgumentList(), writeDefaultLayoutFile(), MemberDefImpl::writeDocumentation(), writeJavaScriptSearchIndex(), HtmlGenerator::writeNavigationPath(), PlantumlManager::writePlantUMLSource(), HtmlGenerator::writeSearchData(), HtmlGenerator::writeSearchPage(), and VhdlDocGen::writeVHDLTypeDocumentation().

swap()

void swap ( DString & s1, DString & s2 )

inline

Definition at line 873 of file dstring.h.

{
  s1.swap(s2);
}

References DString::swap(), and swap().

Referenced by swap().

toStdString()

std::string toStdString ( const DString & s )

inline

Definition at line 784 of file dstring.h.

{
  return s.str();
}

References DString::str(), and toStdString().

Referenced by SectionRefs::add(), expandExpression(), replaceFunctionMacro(), and toStdString().