message.h File Reference

#include <fmt/core.h>
#include <fmt/compile.h>
#include "types.h"
#include "dstring.h"

Include dependency graph for message.h:

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

Go to the source code of this file.

Classes
struct	fmt::formatter< T >
struct	fmt::formatter< DString >
	adds support for formatting DString More...
struct	fmt::formatter< Protection >
	adds support for formatting Protected More...
struct	fmt::formatter< Specifier >
	adds support for formatting Specifier More...
struct	fmt::formatter< MethodTypes >
	adds support for formatting MethodTypes More...
struct	fmt::formatter< RelatesType >
	adds support for formatting RelatesType More...
struct	fmt::formatter< Relationship >
	adds support for formatting RelationShip More...
struct	fmt::formatter< SrcLangExt >
	adds support for formatting SrcLangExt More...
struct	fmt::formatter< MemberType >
	adds support for formatting MemberType More...
struct	fmt::formatter< TypeSpecifier >
	adds support for formatting TypeSpecifier More...
struct	fmt::formatter< EntryType >
	adds support for formatting EntryType More...
struct	fmt::formatter< MemberListType >
	adds support for formatting MemberListType More...

Namespaces
namespace	fmt

Macros
#define	msg_no_newline_allowed(x)
#define	msg_newline_required(x)
#define	msg(fmt, ...)
#define	warn(file, line, fmt, ...)
#define	warn_undoc(file, line, fmt, ...)
#define	warn_incomplete_doc(file, line, fmt, ...)
#define	warn_doc_error(file, line, fmt, ...)
#define	warn_layout(file, line, fmt, ...)
#define	warn_uncond(fmt, ...)
#define	err(fmt, ...)
#define	err_full(file, line, fmt, ...)
#define	term(fmt, ...)

Enumerations
enum class	WarningType {   Generic , Undocumented , IncompleteDoc , DocError ,   Layout }

Functions
void	msg_ (fmt::string_view fmt, fmt::format_args args)
void	warn_ (WarningType type, const DString &file, int line, fmt::string_view fmt, fmt::format_args args)
void	warn_uncond_ (fmt::string_view fmt, fmt::format_args args)
void	err_ (fmt::string_view fmt, fmt::format_args args)
void	err_full_ (const DString &file, int line, fmt::string_view fmt, fmt::format_args args)
void	term_ (fmt::string_view fmt, fmt::format_args args)
DString	warn_line (const DString &file, int line)
void	initWarningFormat ()
void	warn_flush ()
void	finishWarnExit ()
template<typename ... Args>
void	err_fmt (fmt::format_string< Args... > fmt, Args &&... args)
template<typename ... Args>
void	err_full_fmt (const DString &file, int line, fmt::format_string< Args... > fmt, Args &&... args)
template<typename ... Args>
void	term_fmt (fmt::format_string< Args... > fmt, Args &&... args)
template<typename ... Args>
void	msg_fmt (fmt::format_string< Args... > fmt, Args &&... args)
template<typename ... Args>
void	warn_fmt (WarningType type, const DString &file, int line, fmt::format_string< Args... > fmt, Args &&... args)
template<typename ... Args>
void	warn_uncond_fmt (fmt::format_string< Args... > fmt, Args &&... args)
template<std::size_t N>
constexpr bool	has_newline_at_end (const char(&str)[N])

Macro Definition Documentation

err

#define err	(		fmt,
			... )

Value:

  do {                   \
  msg_newline_required(fmt);              \
  err_fmt(FMT_STRING(fmt),##__VA_ARGS__); \
} while (0)

Definition at line 127 of file message.h.

Referenced by MemberDefImpl::_writeReimplements(), FileDefImpl::acquireFileVersion(), DefinitionImpl::addInnerCompound(), DotManager::addJob(), addValidAliasToMap(), adjustBoolSetting(), adjustColorStyleSetting(), adjustConfiguration(), adjustStringSetting(), RTFGenerator::beginRTFDocument(), bindIntParameter(), bindTextParameter(), Config::checkAndCorrect(), checkFileName(), checkList(), checkPngResult(), classInheritedProtectionLevel(), convertMapFile(), DotFilePatcher::convertMapFile(), copyExtraFiles(), copyFile(), copyIcon(), copyLatexStyleSheet(), copyLogo(), ResourceMgr::copyResourceAs(), copyStyleSheet(), MemberList::countDecMembers(), createCroppedEPS(), createCroppedPDF(), createDVIFile(), createEPSbboxFile(), PerlModGenerator::createOutputDir(), PerlModGenerator::createOutputFile(), createPNG(), createPostscriptFile(), HtmlHelp::Private::createProjectFile(), FlowChart::createSVG(), createSVGFromPDF(), createSVGFromPDFviaInkscape(), RTFGenerator::decIndentLevel(), NamespaceLinkedRefMap::declVisible(), elemIsVisible(), Htags::execute(), extractBoundingBox(), fileToString(), DocParser::findAndCopyImage(), FlowChart::findLabel(), finishWarnExit(), generateDEF(), generateFormula(), generateOutput(), CitationManager::generatePage(), generateSqlite3(), generateXML(), generateXMLForClass(), generateXMLForConcept(), generateXMLForDir(), generateXMLForFile(), generateXMLForGroup(), generateXMLForModule(), generateXMLForNamespace(), generateXMLForPage(), generateXMLForRequirement(), generateXMLForRequirements(), FilterCache::getFileContentsPipe(), DocPara::handleShowDate(), hasNonReferenceNestedGroupRec(), hasNonReferenceNestedNamespaceRec(), hasNonReferenceSuperClassRec(), LatexDocVisitor::incIndentLevel(), RTFDocVisitor::incIndentLevel(), RTFGenerator::incIndentLevel(), RTFGenerator::init(), initializeTables(), initializeViews(), initWarningFormat(), CitationManager::insertCrossReferencesForBibFile(), FileDefImpl::insertMember(), GroupDefImpl::insertMember(), NamespaceDefImpl::insertMember(), ClassDefImpl::internalInsertMember(), ClassDefImpl::isBaseClass(), ClassDefImpl::isSubClass(), VhdlDocGen::isSubClass(), loadExtensions(), Htags::loadFilemap(), loadStylesheet(), openDbConnection(), DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), PerlModDocVisitor::operator()(), PerlModDocVisitor::operator()(), PerlModDocVisitor::operator()(), RTFDocVisitor::operator()(), TextDocVisitor::operator()(), XmlDocVisitor::operator()(), DotGraph::prepareDotFile(), prepareStatement(), preProcessFile(), RTFGenerator::preProcessFileInplace(), DotRunner::readBoundingBox(), readCodeFragment(), readConfiguration(), readInputFile(), readTagFile(), readTextFileByName(), FileDefImpl::removeMember(), GroupDefImpl::removeMember(), replaceVariables(), resetPDFSize(), DotFilePatcher::run(), DotRunner::run(), runHtmlHelpCompiler(), runQHelpGenerator(), StyleData::setStyle(), showDate(), SysTimeKeeper::stop(), testRTFOutput(), updateEPSBoundingBox(), updateLanguageMapping(), SearchIndexExternal::write(), ResourceMgr::writeCategory(), writeCombineScript(), MemberDefImpl::writeDeclaration(), writeDefaultLayoutFile(), FileDefImpl::writeDetailedDescription(), writeDiaGraphFromFile(), ConceptDefImpl::writeDocumentation(), DirDefImpl::writeDocumentation(), FileDefImpl::writeDocumentation(), GroupDefImpl::writeDocumentation(), MemberList::writeDocumentation(), ModuleDefImpl::writeDocumentation(), NamespaceDefImpl::writeDocumentation(), ClassDefImpl::writeDocumentationContents(), HtmlGenerator::writeExternalSearchPage(), ClassDiagram::writeFigure(), FlowChart::writeFlowChart(), writeInlineGraph(), writeJavasScriptSearchDataPage(), MemberList::writePlainDeclarations(), HtmlGenerator::writeSearchPage(), DefinitionImpl::writeSourceDef(), HtmlGenerator::writeStyleInfo(), and writeTagFile().

err_full

#define err_full	(		file,
			line,
			fmt,
			... )

Value:

  do {                   \
  msg_no_newline_allowed(fmt);                             \
  err_full_fmt(file,line,FMT_STRING(fmt),##__VA_ARGS__); \
} while (0)

Definition at line 132 of file message.h.

Referenced by NamespaceDefImpl::compoundTypeString(), do_mscgen_generate(), DotRunner::run(), runMermaid(), runPlantumlContent(), writeDiaGraphFromFile(), MermaidManager::writeMermaidSource(), and writeMscGraphFromFile().

msg

#define msg	(		fmt,
			... )

Value:

msg_fmt(FMT_STRING(fmt),##__VA_ARGS__)

Definition at line 94 of file message.h.

Referenced by MemberDefImpl::_writeCallerGraph(), MemberDefImpl::_writeCallGraph(), FileDefImpl::acquireFileVersion(), adjustConfiguration(), Statistics::begin(), checkAndUpdatePath(), checkWarnMessage(), devUsage(), anonymous_namespace{tagreader.cpp}::TagFileParser::error(), LayoutParser::error(), exitDoxygen(), format_warn(), generateConceptDocs(), generateConfigFile(), generateDocsForClassList(), generateExampleDocs(), generateFileDocs(), generateFileSources(), generateFormula(), generateNamespaceClassDocs(), generateNamespaceConceptDocs(), generateNamespaceDocs(), generateOutput(), generatePageDocs(), generateSqlite3(), generateXML(), generateXMLForClass(), LayoutDocManager::init(), FormulaManager::initFromRepository(), initializeTables(), initializeViews(), loadExtensions(), loadStylesheet(), LayoutDocManager::parse(), XMLParser::parse(), parseFile(), parseFilesMultiThreading(), parseInput(), VHDLOutlineParser::parseInput(), parseMain(), parseMain(), parseMain(), parseMain(), parseTagFile(), Statistics::print(), Debug::printFlags(), processData(), readConfiguration(), readDir(), readIncludeFile(), readTagFile(), reportError(), DotManager::run(), DotRunner::run(), runMermaid(), runPlantumlContent(), AutoTrace::setExit(), setTranslator(), SymbolResolver::showCacheUsage(), stopDoxygen(), LayoutNavEntry::url(), usage(), version(), DirDefImpl::writeDirectoryGraph(), ClassDefImpl::writeDocumentationForInnerClasses(), and GroupDefImpl::writeGroupGraph().

msg_newline_required

#define msg_newline_required

(

x

)

Value:

static_assert(has_newline_at_end(x),"text: \"" x "\" should have \\n at end");

Definition at line 91 of file message.h.

msg_no_newline_allowed

#define msg_no_newline_allowed

(

x

)

Value:

static_assert(!has_newline_at_end(x),"text: \"" x "\" should not have \\n at end");

Definition at line 88 of file message.h.

term

#define term	(		fmt,
			... )

Value:

  do {                   \
  msg_newline_required(fmt);               \
  term_fmt(FMT_STRING(fmt),##__VA_ARGS__); \
} while (0)

Definition at line 137 of file message.h.

Referenced by SearchIndexInfo::add(), Qhp::addContentsItem(), addTillEndOfComment(), addTillEndOfString(), adjustConfiguration(), checkPageRelations(), compareDoxyfile(), computePageRelations(), createOutputDirectory(), createSubDirs(), generateConfigFile(), FormulaManager::generateImages(), generateOutput(), DocbookGenerator::init(), HtmlGenerator::init(), LatexGenerator::init(), ManGenerator::init(), RTFGenerator::init(), Crawlmap::initialize(), DocSets::initialize(), EclipseHelp::initialize(), HtmlHelp::initialize(), HtmlHelpRecoder::initialize(), Qhp::initialize(), Sitemap::initialize(), parseInput(), DotGraph::prepareDotFile(), processUntilMatchingTerminator(), OutputGenerator::startPlainFile(), transcodeCharacterBuffer(), writeDotGraphFromFile(), writeDotImageMapFromFile(), ClassDiagram::writeFigure(), DotGfxHierarchyTable::writeGraph(), writeJavasScriptSearchDataPage(), writeLatexMakefile(), and writeMakeBat().

warn

#define warn	(		file,
			line,
			fmt,
			... )

Value:

  do {                                        \
  msg_no_newline_allowed(fmt);                                            \
  warn_fmt(WarningType::Generic,file,line,FMT_STRING(fmt),##__VA_ARGS__); \
} while (0)

Definition at line 97 of file message.h.

Referenced by addAnchor(), addClassToGroups(), addConceptToGroups(), addDirToGroups(), ModuleManager::addDocs(), addExampleToGroups(), addGroupToGroups(), addIncludeFile(), addMemberDocs(), addMemberFunction(), addMemberToGroups(), addModuleToGroups(), addNamespaceToGroups(), addRelatedPage(), addRequirementId(), RequirementManager::addRequirementRefsForSymbol(), addSection(), addXRefItemToEntry(), buildExampleList(), buildFileList(), buildFunctionList(), buildGroupListFiltered(), buildInterfaceAndServiceList(), checkBlocks(), checkFormula(), DocGroup::close(), convertCppComments(), decrLevel(), endCondSection(), endCondSection(), DocGroup::enterCompound(), anonymous_namespace{tagreader.cpp}::TagFileParser::error(), Markdown::Private::extractTitleId(), findClassRelation(), findDefineDocumentation(), findDirDocumentation(), findEnumDocumentation(), findGlobalMember(), findMainPage(), findMember(), getConfig(), getConvertLatexMacro(), MemberDefImpl::getOutputFileBase(), DocParser::handleCite(), DocPara::handleCommand(), DocPara::handleDoxyConfig(), handleElse(), handleElseIf(), handleEndIf(), handleEndParBlock(), handleExample(), handleFileInfoResult(), handleInheritanceGraph(), handleMemberOf(), vhdl::parser::VhdlErrorHandler::handleOtherError(), handleParBlock(), vhdl::parser::VhdlErrorHandler::handleParseError(), handleRelated(), handleRelatedAlso(), handleSubpage(), handleToc(), vhdl::parser::VhdlErrorHandler::handleUnexpectedToken(), CitationManager::insertCrossReferencesForBibFile(), ClassDefImpl::internalInsertMember(), isFencedCodeBlock(), DocGroup::leaveFile(), vhdl::parser::VhdlTokenManagerErrorHandler::lexicalError(), vhdl::parser::VhdlTokenManagerErrorHandler::lexicalError(), loadExtensions(), loadStylesheet(), otherCaseDone(), CondParser::parse(), CommentScanner::parseCommentBlock(), parseIncludeOptions(), parseMain(), parsePrototype(), parsePrototype(), pop_state(), pop_state(), pop_state(), popBlockState(), Preprocessor::processFile(), Markdown::Private::processQuotations(), processSection(), readIncludeFile(), resolveClassNestingRelations(), subrHandleCommentBlock(), substituteKeywords(), tryAddEnumDocsToGroupMember(), MemberDefImpl::virtualness(), MemberDefImpl::warnIfUndocumented(), writeDirTreeNode(), and writeExceptionListImpl().

warn_doc_error

#define warn_doc_error	(		file,
			line,
			fmt,
			... )

Value:

  do {                               \
  msg_no_newline_allowed(fmt);                                             \
  warn_fmt(WarningType::DocError,file,line,FMT_STRING(fmt),##__VA_ARGS__); \
} while (0)

Definition at line 112 of file message.h.

Referenced by DocParser::checkArgumentName(), DocParser::checkRetvalName(), DocParser::checkUnOrMultipleDocumentedParams(), DocParser::defaultHandleToken(), DocAnchor::DocAnchor(), DocCite::DocCite(), DocEmoji::DocEmoji(), DocFormula::DocFormula(), DocHtmlCaption::DocHtmlCaption(), DocRef::DocRef(), DocParser::errorHandleDefaultToken(), DocParser::findAndCopyImage(), DocParser::handleAHref(), DocParser::handleAnchor(), DocParser::handleCite(), DocPara::handleCommand(), DocPara::handleDoxyConfig(), DocPara::handleEmoji(), DocPara::handleFile(), DocPara::handleHtmlEndTag(), DocPara::handleHtmlStartTag(), DocParser::handleIFile(), DocParser::handleILine(), DocParser::handleImage(), DocParser::handleImg(), DocPara::handleInclude(), DocPara::handleIncludeOperator(), DocParser::handleInternalRef(), DocPara::handleLink(), DocParser::handleLinkedWord(), DocParser::handlePrefix(), DocParser::handleRef(), DocPara::handleSection(), DocPara::handleShowDate(), DocPara::handleStartCode(), DocParser::handleStyleArgument(), DocParser::handleStyleLeave(), DocParser::handleUnclosedStyleCommands(), DocDiaFile::parse(), DocDotFile::parse(), DocHRef::parse(), DocHtmlBlockQuote::parse(), DocHtmlCaption::parse(), DocHtmlDescList::parse(), DocHtmlDescTitle::parse(), DocHtmlDetails::parse(), DocHtmlHeader::parse(), DocHtmlList::parse(), DocHtmlRow::parse(), DocHtmlSummary::parse(), DocHtmlTable::parse(), DocInclude::parse(), DocIncOperator::parse(), DocIndexEntry::parse(), DocInternal::parse(), DocLink::parse(), DocMermaidFile::parse(), DocMscFile::parse(), DocPara::parse(), DocParamList::parse(), DocPlantUmlFile::parse(), DocRef::parse(), DocRoot::parse(), DocSecRefItem::parse(), DocSecRefList::parse(), DocSection::parse(), DocText::parse(), DocHtmlList::parseXml(), DocHtmlRow::parseXml(), DocParamList::parseXml(), DocParser::processCopyDoc(), readIncludeFile(), DocParser::readTextFileByName(), skipSpacesForTable(), and MemberDefImpl::warnIfUndocumentedParams().

warn_incomplete_doc

#define warn_incomplete_doc	(		file,
			line,
			fmt,
			... )

Value:

  do {                               \
  msg_no_newline_allowed(fmt);                                                  \
  warn_fmt(WarningType::IncompleteDoc,file,line,FMT_STRING(fmt),##__VA_ARGS__); \
} while (0)

Definition at line 107 of file message.h.

Referenced by DocParser::checkUnOrMultipleDocumentedParams().

warn_layout

#define warn_layout	(		file,
			line,
			fmt,
			... )

Value:

  do {                               \
  msg_no_newline_allowed(fmt);                                             \
  warn_fmt(WarningType::Layout,file,line,FMT_STRING(fmt),##__VA_ARGS__); \
} while (0)

Definition at line 117 of file message.h.

Referenced by LayoutParser::error(), mergeDocEntryLists(), LayoutParser::startElement(), and LayoutParser::startNavEntry().

warn_uncond

#define warn_uncond	(		fmt,
			... )

Value:

  do {                   \
  msg_newline_required(fmt);                      \
  warn_uncond_fmt(FMT_STRING(fmt),##__VA_ARGS__); \
} while (0)

Definition at line 122 of file message.h.

Referenced by MemberDefImpl::_writeCallerGraph(), MemberDefImpl::_writeCallGraph(), Config::checkAndCorrect(), checkMarkdownMainfile(), computeVerifiedDotPath(), getCurrentDateTime(), FormulaManager::initFromRepository(), minClassDistance(), parseInput(), readDir(), readFileOrDirectory(), searchInputFiles(), Config::updateObsolete(), HtmlEntityMapper::validate(), ClassDefImpl::writeCollaborationGraph(), GroupDefImpl::writeGroupGraph(), FileDefImpl::writeIncludedByGraph(), FileDefImpl::writeIncludeGraph(), and ClassDefImpl::writeInheritanceGraph().

warn_undoc

#define warn_undoc	(		file,
			line,
			fmt,
			... )

Value:

  do {                                       \
  msg_no_newline_allowed(fmt);                                                 \
  warn_fmt(WarningType::Undocumented,file,line,FMT_STRING(fmt),##__VA_ARGS__); \
} while (0)

Definition at line 102 of file message.h.

Referenced by computeClassRelations(), findMember(), MemberDefImpl::warnIfUndocumented(), and warnUndocumentedNamespaces().

Enumeration Type Documentation

WarningType

enum class WarningType

strong

Enumerator
Generic
Undocumented
IncompleteDoc
DocError
Layout

Definition at line 25 of file message.h.

{
  Generic,
  Undocumented,
  IncompleteDoc,
  DocError,
  Layout
};

Function Documentation

err_()

void err_	(	fmt::string_view	fmt,
		fmt::format_args	args )

Definition at line 169 of file message.cpp.

{
  {
    std::unique_lock<std::mutex> lock(g_mutex);
    if (checkWarnMessage(g_errorStr+fmt::vformat(fmt,args))) fmt::print(g_warnFile,"{}{}",g_errorStr,fmt::vformat(fmt,args));
  }
  handle_warn_as_error();
}

References checkWarnMessage(), err_(), g_errorStr, g_mutex, g_warnFile, and handle_warn_as_error().

Referenced by err_(), and err_fmt().

err_fmt()

template<typename ... Args>

void err_fmt	(	fmt::format_string< Args... >	fmt,
		Args &&...	args )

Definition at line 46 of file message.h.

{
  err_(fmt,fmt::make_format_args(args...));
}

References err_(), and err_fmt().

Referenced by err_fmt().

err_full_()

void err_full_	(	const DString &	file,
		int	line,
		fmt::string_view	fmt,
		fmt::format_args	args )

Definition at line 180 of file message.cpp.

{
  format_warn(file,line,g_errorStr+fmt::vformat(fmt,args));
}

References err_full_(), format_warn(), and g_errorStr.

Referenced by err_full_(), and err_full_fmt().

err_full_fmt()

template<typename ... Args>

void err_full_fmt	(	const DString &	file,
		int	line,
		fmt::format_string< Args... >	fmt,
		Args &&...	args )

Definition at line 52 of file message.h.

{
  err_full_(file,line,fmt,fmt::make_format_args(args...));
}

References err_full_(), and err_full_fmt().

Referenced by err_full_fmt().

finishWarnExit()

void finishWarnExit

(

)

Definition at line 289 of file message.cpp.

{
  fflush(stdout);
  if (g_warnBehavior == WARN_AS_ERROR_t::FAIL_ON_WARNINGS_PRINT && g_warnlogFile != "-")
  {
    Portable::fclose(g_warnFile);
    g_warnFile = nullptr;
  }
  if (g_warnStat && g_warnBehavior == WARN_AS_ERROR_t::FAIL_ON_WARNINGS_PRINT && g_warnlogFile != "-")
  {
 
    std::ifstream warnFile = Portable::openInputStream(g_warnlogFile);
    if (!warnFile.is_open())
    {
      g_warnFile = stderr;
      err("Cannot open warnings file '{}' for reading\n",g_warnlogFile);
    }
    else
    {
      std::string line;
      while (getline(warnFile,line))
      {
        fmt::print(stderr,"{}\n",line);
      }
      warnFile.close();
    }
  }
 
  if (g_warnlogTemp) Portable::unlink(g_warnlogFile);
 
  if (g_warnStat && (g_warnBehavior == WARN_AS_ERROR_t::FAIL_ON_WARNINGS ||
                     g_warnBehavior == WARN_AS_ERROR_t::FAIL_ON_WARNINGS_PRINT))
  {
    exit(1);
  }
}

References err, Portable::fclose(), finishWarnExit(), g_warnBehavior, g_warnFile, g_warnlogFile, g_warnlogTemp, g_warnStat, Portable::openInputStream(), and Portable::unlink().

Referenced by finishWarnExit(), and generateOutput().

has_newline_at_end()

template<std::size_t N>

bool has_newline_at_end ( const char(&) str[N] )

constexpr

Definition at line 83 of file message.h.

{
  return str[N-2]=='\n';
}

References has_newline_at_end().

Referenced by has_newline_at_end().

initWarningFormat()

void initWarningFormat

(

)

Definition at line 231 of file message.cpp.

{
  g_warnFormat     = Config_getString(WARN_FORMAT);
  g_warnLineFormat = Config_getString(WARN_LINE_FORMAT);
  g_warnBehavior   = Config_getEnum(WARN_AS_ERROR);
  g_warnlogFile    = Config_getString(WARN_LOGFILE);
  if (g_warnlogFile.empty() && g_warnBehavior == WARN_AS_ERROR_t::FAIL_ON_WARNINGS_PRINT)
  {
    uint32_t pid = Portable::pid();
    g_warnlogFile.sprintf("doxygen_warnings_temp_%d.tmp",pid);
    g_warnlogTemp = true;
  }
 
  if (!g_warnlogFile.empty())
  {
    if (g_warnlogFile == "-")
    {
      g_warnFile = stdout;
    }
    else
    {
      FileInfo fi(g_warnlogFile.str());
      Dir d(fi.dirPath());
      if (!d.exists() && !d.mkdir(fi.dirPath()))
      {
        // point it to something valid, because warn() relies on it
        g_warnFile = stderr;
        err("Cannot create directory for '{}', redirecting 'WARN_LOGFILE' output to 'stderr'\n",g_warnlogFile);
      }
      else if (!(g_warnFile = Portable::fopen(g_warnlogFile,"w")))
      {
        // point it to something valid, because warn() relies on it
        g_warnFile = stderr;
        err("Cannot open '{}' for writing, redirecting 'WARN_LOGFILE' output to 'stderr'\n",g_warnlogFile);
      }
    }
  }
  else
  {
    g_warnFile = stderr;
  }
  if (g_warnBehavior != WARN_AS_ERROR_t::NO)
  {
    g_warningStr = g_errorStr;
  }
 
  // make sure the g_warnFile is closed in case we call exit and it is still open
  std::atexit([](){
      if (g_warnFile && g_warnFile!=stderr && g_warnFile!=stdout)
      {
        Portable::fclose(g_warnFile);
        g_warnFile = nullptr;
      }
  });
}

References Config_getEnum, Config_getString, FileInfo::dirPath(), DString::empty(), err, Dir::exists(), Portable::fclose(), Portable::fopen(), g_errorStr, g_warnBehavior, g_warnFile, g_warnFormat, g_warningStr, g_warnLineFormat, g_warnlogFile, g_warnlogTemp, initWarningFormat(), Dir::mkdir(), Portable::pid(), DString::sprintf(), and DString::str().

Referenced by checkConfiguration(), and initWarningFormat().

msg_()

void msg_	(	fmt::string_view	fmt,
		fmt::format_args	args )

Definition at line 124 of file message.cpp.

{
  if (!Config_getBool(QUIET))
  {
    std::unique_lock<std::mutex> lock(g_mutex);
    if (Debug::isFlagSet(Debug::Time))
    {
      fmt::print("{:.3f} sec: ",(static_cast<double>(Debug::elapsedTime())));
    }
    fmt::print("{}",fmt::vformat(fmt,args));
  }
}

References Config_getBool, Debug::elapsedTime(), g_mutex, Debug::isFlagSet(), msg_(), and Debug::Time.

Referenced by msg_(), and msg_fmt().

msg_fmt()

template<typename ... Args>

void msg_fmt	(	fmt::format_string< Args... >	fmt,
		Args &&...	args )

Definition at line 64 of file message.h.

{
  msg_(fmt,fmt::make_format_args(args...));
}

References msg_(), and msg_fmt().

Referenced by msg_fmt().

term_()

void term_	(	fmt::string_view	fmt,
		fmt::format_args	args )

Definition at line 187 of file message.cpp.

{
  {
    std::unique_lock<std::mutex> lock(g_mutex);
    if (checkWarnMessage(g_errorStr+fmt::vformat(fmt,args))) fmt::print(g_warnFile, "{}{}", g_errorStr, fmt::vformat(fmt,args));
    if (g_warnFile != stderr)
    {
      size_t l = strlen(g_errorStr);
      for (size_t i=0; i<l; i++) fmt::print(g_warnFile, " ");
      fmt::print(g_warnFile, "{}\n", "Exiting...");
      if (!Config_getBool(QUIET))
      {
        // cannot use `msg` due to the mutex
        fmt::print("See '{}' for the reason of termination.\n",g_warnlogFile);
      }
    }
  }
  exit(1);
}

References checkWarnMessage(), Config_getBool, g_errorStr, g_mutex, g_warnFile, g_warnlogFile, and term_().

Referenced by term_(), and term_fmt().

term_fmt()

template<typename ... Args>

void term_fmt	(	fmt::format_string< Args... >	fmt,
		Args &&...	args )

Definition at line 58 of file message.h.

{
  term_(fmt,fmt::make_format_args(args...));
}

References term_(), and term_fmt().

Referenced by term_fmt().

warn_()

void warn_	(	WarningType	type,
		const DString &	file,
		int	line,
		fmt::string_view	fmt,
		fmt::format_args	args )

Definition at line 139 of file message.cpp.

{
  bool enabled = false;
  switch (type)
  {
    case WarningType::Generic:       enabled = Config_getBool(WARNINGS);               break;
    case WarningType::Undocumented:  enabled = Config_getBool(WARN_IF_UNDOCUMENTED);   break;
    case WarningType::IncompleteDoc: enabled = Config_getBool(WARN_IF_INCOMPLETE_DOC); break;
    case WarningType::DocError:      enabled = Config_getBool(WARN_IF_DOC_ERROR);      break;
    case WarningType::Layout:        enabled = Config_getBool(WARN_LAYOUT_FILE);       break;
  }
  if (enabled)
  {
    do_warn(file, line, g_warningStr, fmt, args);
  }
}

References Config_getBool, do_warn(), DocError, g_warningStr, Generic, IncompleteDoc, Layout, Undocumented, and warn_().

Referenced by warn_(), and warn_fmt().

warn_flush()

void warn_flush

(

)

Definition at line 224 of file message.cpp.

{
  fflush(g_warnFile);
}

References g_warnFile, and warn_flush().

Referenced by Statistics::end(), and warn_flush().

warn_fmt()

template<typename ... Args>

void warn_fmt	(	WarningType	type,
		const DString &	file,
		int	line,
		fmt::format_string< Args... >	fmt,
		Args &&...	args )

Definition at line 70 of file message.h.

{
  warn_(type,file,line,fmt,fmt::make_format_args(args...));
}

References warn_(), and warn_fmt().

Referenced by warn_fmt().

warn_line()

DString warn_line	(	const DString &	file,
		int	line )

Definition at line 209 of file message.cpp.

{
  DString fileSubst = file.empty() ? "<unknown>" : file;
  DString lineSubst; lineSubst.setNum(line);
  return  substitute(
            substitute(
              g_warnLineFormat,
              "$file",fileSubst
            ),
            "$line",lineSubst
          );
}

References DString::empty(), g_warnLineFormat, DString::setNum(), substitute(), and warn_line().

Referenced by addMemberFunction(), checkPageRelations(), computePageRelations(), findGlobalMember(), and warn_line().

warn_uncond_()

void warn_uncond_	(	fmt::string_view	fmt,
		fmt::format_args	args )

Definition at line 158 of file message.cpp.

{
  {
    std::unique_lock<std::mutex> lock(g_mutex);
    if (checkWarnMessage(g_errorStr+fmt::vformat(fmt,args))) fmt::print(g_warnFile,"{}{}",g_warningStr,vformat(fmt,args));
  }
  handle_warn_as_error();
}

References checkWarnMessage(), g_errorStr, g_mutex, g_warnFile, g_warningStr, handle_warn_as_error(), and warn_uncond_().

Referenced by warn_uncond_(), and warn_uncond_fmt().

warn_uncond_fmt()

template<typename ... Args>

void warn_uncond_fmt	(	fmt::format_string< Args... >	fmt,
		Args &&...	args )

Definition at line 76 of file message.h.

{
  warn_uncond_(fmt,fmt::make_format_args(args...));
}

References warn_uncond_(), and warn_uncond_fmt().

Referenced by warn_uncond_fmt().