HtmlEntityMapper Class Reference

Singleton helper class to map html entities to other formats. More...

#include <htmlentity.h>

Public Member Functions
DocSymbol::SymType	name2sym (const QCString &symName) const
	Give code of the requested HTML entity name. More...
const char *	utf8 (DocSymbol::SymType symb, bool useInPrintf=FALSE) const
	Access routine to the UTF8 code of the HTML entity. More...
const char *	html (DocSymbol::SymType symb, bool useInPrintf=FALSE) const
	Access routine to the html code of the HTML entity. More...
const char *	xml (DocSymbol::SymType symb) const
	Access routine to the XML code of the HTML entity. More...
const char *	docbook (DocSymbol::SymType symb) const
	Access routine to the docbook code of the HTML entity. More...
const char *	latex (DocSymbol::SymType symb) const
	Access routine to the LaTeX code of the HTML entity. More...
const char *	man (DocSymbol::SymType symb) const
	Access routine to the man code of the HTML entity. More...
const char *	rtf (DocSymbol::SymType symb) const
	Access routine to the RTF code of the HTML entity. More...
const DocSymbol::PerlSymb *	perl (DocSymbol::SymType symb) const
	Access routine to the perl struct with the perl code of the HTML entity. More...
void	writeXMLSchema (FTextStream &t)

Static Public Member Functions
static HtmlEntityMapper *	instance ()
static void	deleteInstance ()

Private Member Functions
void	validate ()
	Routine to check if the entries of the html_entities are numbered correctly. More...
	HtmlEntityMapper ()
	~HtmlEntityMapper ()

Private Attributes
QDict< int > *	m_name2sym

Static Private Attributes
static HtmlEntityMapper *	s_instance = 0

Detailed Description

Singleton helper class to map html entities to other formats.

Definition at line 24 of file htmlentity.h.

Constructor & Destructor Documentation

HtmlEntityMapper::HtmlEntityMapper ( )

private

Definition at line 324 of file htmlentity.cpp.

{
  m_name2sym = new QDict<int>(1009);
  m_name2sym->setAutoDelete(TRUE);
  for (int i = 0; i < g_numHtmlEntities; i++)
  {
    m_name2sym->insert(g_htmlEntities[i].item,new int(g_htmlEntities[i].symb));
  }
  validate();
}

HtmlEntityMapper::~HtmlEntityMapper ( )

private

Definition at line 335 of file htmlentity.cpp.

{
  delete m_name2sym;
}

Member Function Documentation

void HtmlEntityMapper::deleteInstance ( )

static

Deletes the one and only instance of the HTML entity mapper

Definition at line 351 of file htmlentity.cpp.

{
  delete s_instance;
  s_instance=0;
}

const char * HtmlEntityMapper::docbook

(

DocSymbol::SymType

symb

)

const

Access routine to the docbook code of the HTML entity.

Parameters

symb	Code of the requested HTML entity

Returns

the docbook code of the HTML entity, in case the docbook code is unknown NULL is returned.

Definition at line 415 of file htmlentity.cpp.

{
  return g_htmlEntities[symb].docbook;
}

const char * HtmlEntityMapper::html	(	DocSymbol::SymType	symb,
		bool	useInPrintf = FALSE
	)		const

Access routine to the html code of the HTML entity.

Parameters

symb	Code of the requested HTML entity
useInPrintf	If TRUE the result will be escaped such that it can be used in a printf string pattern

Returns

the html representation of the HTML entity, in case the html code is unknown NULL is returned.

Definition at line 386 of file htmlentity.cpp.

{
  if (useInPrintf && symb==DocSymbol::Sym_Percent)
  {
    return "%%"; // escape for printf
  }
  else
  {
    return g_htmlEntities[symb].html;
  }
}

HtmlEntityMapper * HtmlEntityMapper::instance ( )

static

Returns the one and only instance of the HTML entity mapper

Definition at line 341 of file htmlentity.cpp.

{
  if (s_instance==0)
  {
    s_instance = new HtmlEntityMapper;
  }
  return s_instance;
}

const char * HtmlEntityMapper::latex

(

DocSymbol::SymType

symb

)

const

Access routine to the LaTeX code of the HTML entity.

Parameters

symb	Code of the requested HTML entity

Returns

the LaTeX code of the HTML entity, in case the LaTeX code is unknown NULL is returned.

Definition at line 426 of file htmlentity.cpp.

{
  return g_htmlEntities[symb].latex;
}

const char * HtmlEntityMapper::man

(

DocSymbol::SymType

symb

)

const

Access routine to the man code of the HTML entity.

Parameters

symb	Code of the requested HTML entity

Returns

the man of the HTML entity, in case the man code is unknown NULL is returned.

Definition at line 437 of file htmlentity.cpp.

{
  return g_htmlEntities[symb].man;
}

DocSymbol::SymType HtmlEntityMapper::name2sym

(

const QCString &

symName

)

const

Give code of the requested HTML entity name.

Parameters

symName

HTML entity name without & and ;

Returns

the code for the requested HTML entity name, in case the requested HTML item does not exist DocSymbol::Sym_unknown is returned.

Definition at line 471 of file htmlentity.cpp.

{
  int *pSymb = m_name2sym->find(symName);
  return pSymb ? ((DocSymbol::SymType)*pSymb) : DocSymbol::Sym_Unknown;
}

const DocSymbol::PerlSymb * HtmlEntityMapper::perl

(

DocSymbol::SymType

symb

)

const

Access routine to the perl struct with the perl code of the HTML entity.

Parameters

symb	Code of the requested HTML entity

Returns

the pointer to perl struct with the perl code of the HTML entity, in case the perl code does not exists the NULL pointer is entered in the symb field and in the DocSymbol::Perl_unknown in the type field.

Definition at line 460 of file htmlentity.cpp.

{
  return &g_htmlEntities[symb].perl;
}

const char * HtmlEntityMapper::rtf

(

DocSymbol::SymType

symb

)

const

Access routine to the RTF code of the HTML entity.

Parameters

symb	Code of the requested HTML entity

Returns

the RTF of the HTML entity, in case the RTF code is unknown NULL is returned.

Definition at line 448 of file htmlentity.cpp.

{
  return g_htmlEntities[symb].rtf;
}

const char * HtmlEntityMapper::utf8	(	DocSymbol::SymType	symb,
		bool	useInPrintf = FALSE
	)		const

Access routine to the UTF8 code of the HTML entity.

Parameters

symb	Code of the requested HTML entity
useInPrintf	If TRUE the result will be escaped such that it can be used in a printf string pattern

Returns

the UTF8 code of the HTML entity, in case the UTF code is unknown NULL is returned.

Definition at line 366 of file htmlentity.cpp.

{
  if (useInPrintf && symb==DocSymbol::Sym_Percent)
  {
    return "%%"; // escape for printf
  }
  else
  {
    return g_htmlEntities[symb].UTF8;
  }
}

void HtmlEntityMapper::validate ( )

private

Routine to check if the entries of the html_entities are numbered correctly.

in case of a mismatch a warning message is given.

Definition at line 493 of file htmlentity.cpp.

{
  for (int i = 0; i < g_numHtmlEntities; i++)
  {
    if (i != g_htmlEntities[i].symb)
    {
      warn_uncond("Internal inconsistency, htmlentries code %d (item=%s)\n",i,g_htmlEntities[i].item);
    }
  }
}

void HtmlEntityMapper::writeXMLSchema

(

FTextStream &

t

)

Definition at line 477 of file htmlentity.cpp.

{
  for (int i=0;i<g_numHtmlEntities - g_numberHtmlMappedCmds;i++)
  {
    QCString bareName = g_htmlEntities[i].xml;
    if (!bareName.isEmpty() && bareName.at(0)=='<' && bareName.right(2)=="/>")
    {
      bareName = bareName.mid(1,bareName.length()-3); // strip < and />
      t << "      <xsd:element name=\"" << bareName << "\" type=\"docEmptyType\" />\n";
    }
  }
}

const char * HtmlEntityMapper::xml

(

DocSymbol::SymType

symb

)

const

Access routine to the XML code of the HTML entity.

Parameters

symb	Code of the requested HTML entity

Returns

the XML code of the HTML entity, in case the XML code is unknown NULL is returned.

Definition at line 404 of file htmlentity.cpp.

{
  return g_htmlEntities[symb].xml;
}

Member Data Documentation

QDict<int>* HtmlEntityMapper::m_name2sym

private

Definition at line 44 of file htmlentity.h.

HtmlEntityMapper * HtmlEntityMapper::s_instance = 0

staticprivate

Definition at line 43 of file htmlentity.h.

---

The documentation for this class was generated from the following files:

• doxygen-1.8.11/src/htmlentity.h
• doxygen-1.8.11/src/htmlentity.cpp