gum::prm::o3prm::O3prmReader< GUM_SCALAR > Class Template Reference

This class read O3PRM files and creates the corresponding gum::prm::PRM. More...

#include <agrum/PRM/o3prm/O3prmReader.h>

Collaboration diagram for gum::prm::o3prm::O3prmReader< GUM_SCALAR >:

Public Member Functions
	O3prmReader ()
	O3prmReader (PRM< GUM_SCALAR > &prm)
	O3prmReader (const O3prmReader &src)
	O3prmReader (O3prmReader &&src)
	~O3prmReader ()
O3prmReader &	operator= (const O3prmReader &src)
O3prmReader &	operator= (O3prmReader &&src)
Size	readFile (const std::string &file, const std::string &module="")
	Read file and load its content using a PRMFactory. The package parameter set the file's content package. More...
Size	readString (const std::string &string)
	With readString method, you must set the current path to search from import yourself, using addClassPath. More...
void	parseStream (std::istream &input, std::ostream &output, std::string module="")
void	setClassPath (const std::string &class_path)
	This methods defines the list of paths to look for o3prm files. More...
void	addClassPath (const std::string &class_path)
	Add a list of paths to look for o3prm files. More...
gum::prm::PRM< GUM_SCALAR > *	prm ()
const gum::prm::PRM< GUM_SCALAR > *	prm () const
Size	errors () const
	publishing Errors API More...
Size	warnings () const
	of errors More...
const ErrorsContainer &	errorsContainer () const
	publishing Errors API More...
Idx	errLine (Idx i) const
	line of ith error or warning More...
Idx	errCol (Idx i) const
	col of ith error or warning More...
std::wstring	errFilename (Idx i) const
	filename of ith error or warning More...
bool	errIsError (Idx i) const
	type of ith error or warning More...
std::string	errMsg (Idx i) const
	message of ith error or warning More...
void	showElegantErrors (std::ostream &o=std::cerr) const
	send on std::cerr the list of errors More...
void	showElegantErrorsAndWarnings (std::ostream &o=std::cerr) const
	send on std::cerr the list of errors or warnings More...
void	showErrorCounts (std::ostream &o=std::cerr) const
	send on std::cerr the number of errors and the number of warnings More...

Detailed Description

template<typename GUM_SCALAR>
class gum::prm::o3prm::O3prmReader< GUM_SCALAR >

This class read O3PRM files and creates the corresponding gum::prm::PRM.

Template Parameters

GUM_SCALAR

The scalar type to use with the gum::prm::PRM.

Definition at line 68 of file O3prmReader.h.

Constructor & Destructor Documentation

O3prmReader() [1/4]

template<typename GUM_SCALAR >

INLINE gum::prm::o3prm::O3prmReader< GUM_SCALAR >::O3prmReader

(

)

Definition at line 136 of file O3prmReader_tpl.h.

                                                    :
          _prm_(new PRM< GUM_SCALAR >()), _o3_prm_(std::unique_ptr< O3PRM >(new O3PRM())) {
        GUM_CONSTRUCTOR(O3prmReader);
      }

O3prmReader() [2/4]

template<typename GUM_SCALAR>

INLINE gum::prm::o3prm::O3prmReader< GUM_SCALAR >::O3prmReader ( PRM< GUM_SCALAR > &  prm )

explicit

Definition at line 142 of file O3prmReader_tpl.h.

                                                                          :
          _prm_(&prm), _o3_prm_(std::unique_ptr< O3PRM >(new O3PRM())) {
        GUM_CONSTRUCTOR(O3prmReader);
      }

O3prmReader() [3/4]

template<typename GUM_SCALAR>

INLINE gum::prm::o3prm::O3prmReader< GUM_SCALAR >::O3prmReader

(

const O3prmReader< GUM_SCALAR > &

src

)

Definition at line 148 of file O3prmReader_tpl.h.

                                                                          :
          _prm_(src._prm_), _o3_prm_(std::unique_ptr< O3PRM >(new O3PRM(*(src._o3_prm_)))),
          _class_path_(src._class_path_), _imported_(src._imported_), _errors_(src._errors_) {
        GUM_CONS_CPY(O3prmReader);
      }

O3prmReader() [4/4]

template<typename GUM_SCALAR>

INLINE gum::prm::o3prm::O3prmReader< GUM_SCALAR >::O3prmReader

(

O3prmReader< GUM_SCALAR > &&

src

)

Definition at line 155 of file O3prmReader_tpl.h.

                                                                     :
          _prm_(std::move(src._prm_)), _o3_prm_(std::move(src._o3_prm_)),
          _class_path_(std::move(src._class_path_)), _imported_(std::move(src._imported_)),
          _errors_(std::move(src._errors_)) {
        GUM_CONS_CPY(O3prmReader);
      }

~O3prmReader()

template<typename GUM_SCALAR >

INLINE gum::prm::o3prm::O3prmReader< GUM_SCALAR >::~O3prmReader

(

)

Definition at line 163 of file O3prmReader_tpl.h.

                                                     {
        GUM_DESTRUCTOR(O3prmReader);
      }

Member Function Documentation

_clean_()

template<typename GUM_SCALAR >

INLINE std::string gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_clean_ ( std::string  text ) const

private

Definition at line 36 of file O3prmReader_tpl.h.

                                                                              {
        // This could be way more faster with regex but there are not implemented
        // with gcc-4.8 !
        text = replace(text, "Syntax error", "Error");

        text = replace(text, "LABEL_OR_STAR_LIST", "declaration");

        text = replace(text, "ARRAY_REFERENCE_SLOT", "declaration");
        text = replace(text, "FLOAT_AS_LABEL", "declaration");
        text = replace(text, "FLOAT_OR_INT", "declaration");
        text = replace(text, "INTEGER_AS_FLOAT", "declaration");
        text = replace(text, "INTEGER_AS_LABEL", "declaration");
        text = replace(text, "INT_TYPE_DECLARATION", "declaration");
        text = replace(text, "LABEL_OR_INT", "declaration");
        text = replace(text, "LABEL_OR_STAR", "declaration");
        text = replace(text, "NAMED_CLASS_ELEMENT", "declaration");
        text = replace(text, "REAL_TYPE_DECLARATION", "declaration");

        text = replace(text, "AGGREGATE_PARENTS", "declaration");
        text = replace(text, "CLASS_BODY", "declaration");
        text = replace(text, "CLASS_DECLARATION", "declaration");
        text = replace(text, "CLASS_ELEMENT", "declaration");
        text = replace(text, "CLASS_PARAMETER", "declaration");
        text = replace(text, "CLASS_UNIT", "declaration");
        text = replace(text, "FLOAT_LIST", "declaration");
        text = replace(text, "FORMULA_LIST", "declaration");
        text = replace(text, "IDENTIFIER_LIST", "declaration");
        text = replace(text, "IMPORT_BODY", "declaration");
        text = replace(text, "IMPORT_DECLARATION", "declaration");
        text = replace(text, "IMPORT_UNIT", "declaration");
        text = replace(text, "INTERFACE_BODY", "declaration");
        text = replace(text, "INTERFACE_DECLARATION", "declaration");
        text = replace(text, "INTERFACE_UNIT", "declaration");
        text = replace(text, "LABEL_LIST", "declaration");
        text = replace(text, "PARAMETER_LIST", "declaration");
        text = replace(text, "PREFIXED_LABEL", "declaration");
        text = replace(text, "RAW_CPT", "declaration");
        text = replace(text, "REFERENCE_SLOT", "declaration");
        text = replace(text, "RULE_CPT", "declaration");
        text = replace(text, "SYSTEM_BODY", "declaration");
        text = replace(text, "SYSTEM_DECLARATION", "declaration");
        text = replace(text, "SYSTEM_UNIT", "declaration");
        text = replace(text, "TYPE_DECLARATION", "declaration");
        text = replace(text, "TYPE_LABEL", "declaration");
        text = replace(text, "TYPE_UNIT", "declaration");
        text = replace(text, "TYPE_VALUE_LIST", "declaration");

        text = replace(text, "AGGREGATE", "declaration");
        text = replace(text, "ARRAY", "declaration");
        text = replace(text, "ATTRIBUTE", "declaration");
        text = replace(text, "CAST", "declaration");
        text = replace(text, "CHAIN", "declaration");
        text = replace(text, "CLASS", "declaration");
        text = replace(text, "FLOAT", "declaration");
        text = replace(text, "FORMULA", "declaration");
        text = replace(text, "IDENTIFIER", "declaration");
        text = replace(text, "INT", "declaration");
        text = replace(text, "INTEGER", "declaration");
        text = replace(text, "INTERFACE", "declaration");
        text = replace(text, "LABEL", "declaration");
        text = replace(text, "LINK", "declaration");
        text = replace(text, "MAP", "declaration");
        text = replace(text, "PARAMETER", "declaration");
        text = replace(text, "REAL", "declaration");
        text = replace(text, "RULE", "declaration");
        text = replace(text, "TYPE", "declaration");
        text = replace(text, "UNIT", "declaration");

        return text;
      }

_copyImports_()

template<typename GUM_SCALAR >

INLINE std::vector< const O3Import *> gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_copyImports_ ( )

private

Definition at line 393 of file O3prmReader_tpl.h.

                                                                                   {
        auto copy = std::vector< const O3Import* >();
        for (const auto& i: _o3_prm_->imports()) {
          if (!_imported_.exists(i->import().label())) { copy.push_back(i.get()); }
        }
        return copy;
      }

_parseImport_()

template<typename GUM_SCALAR >

INLINE void gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_parseImport_ ( const O3Import &  i, const std::string &  module_path  )

private

Definition at line 351 of file O3prmReader_tpl.h.

                                                                                    {
        if (!_imported_.exists(i.import().label())) {
          _imported_.insert(i.import().label());

          auto module_path = module;
          std::replace(module_path.begin(), module_path.end(), '.', '/');

          auto path = i.import().label();
          std::replace(path.begin(), path.end(), '.', '/');

          auto imported = false;
          for (const auto& cp: _class_path_) {
            auto          file_path = cp + path + ".o3prm";
            std::ifstream file(file_path);

            if (file.is_open()) {
              _parseStream_(file, file_path, i.import().label());
              imported = true;
              break;
            }

            file_path = cp + module + path + ".o3prm";
            std::ifstream file2(file_path);

            if (file2.is_open()) {
              _parseStream_(file2, file_path, module + "." + i.import().label());
              imported = true;
              break;
            }
          }

          if (!imported) {
            const auto&       pos = i.import().position();
            std::stringstream msg;
            msg << "Import error: could not resolve import " << i.import().label();
            _errors_.addError(msg.str(), pos.file(), pos.line(), pos.column());
          }
        }
      }

_parseStream_()

template<typename GUM_SCALAR >

INLINE void gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_parseStream_ ( std::istream &  input, const std::string &  filename, const std::string &  module  )

private

Definition at line 336 of file O3prmReader_tpl.h.

                                                                                    {
        auto sBuff  = _readStream_(input);
        auto buffer = std::unique_ptr< unsigned char[] >(new unsigned char[sBuff.length() + 1]);
        strcpy((char*)buffer.get(), sBuff.c_str());
        auto s = o3prm_scanner(buffer.get(), int(sBuff.length() + 1), filename);
        auto p = o3prm_parser(&s);
        p.set_prm(_o3_prm_.get());
        p.set_prefix(module);
        p.Parse();
        _errors_ += p.errors();
      }

_print_()

template<typename GUM_SCALAR >

INLINE std::string gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_print_ ( const ParseError &  err ) const

private

Definition at line 108 of file O3prmReader_tpl.h.

                                                                                     {
        std::stringstream s;
        s << err.filename << "|" << err.line << " col " << err.column << "| " << _clean_(err.msg);
        return s.str();
      }

_readStream_() [1/2]

template<typename GUM_SCALAR >

INLINE void gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_readStream_ ( std::istream &  input, const std::string &  file, std::string  module = ""  )

private

Definition at line 402 of file O3prmReader_tpl.h.

                                                                                   {
        if (module.size() > 0 && module.back() != '.') { module.append("."); }

        _parseStream_(input, file, module);

        auto imports = _copyImports_();
        do {
          for (auto i: imports) {
            _parseImport_(*i, module);
          }
          imports = _copyImports_();
        } while (imports.size() > 0);


        if (_errors_.error_count == 0) {
          auto solver       = O3NameSolver< GUM_SCALAR >(*_prm_, *_o3_prm_, _errors_);
          auto type_factory = O3TypeFactory< GUM_SCALAR >(*_prm_, *_o3_prm_, solver, _errors_);

          auto interface_factory
             = O3InterfaceFactory< GUM_SCALAR >(*_prm_, *_o3_prm_, solver, _errors_);
          auto class_factory = O3ClassFactory< GUM_SCALAR >(*_prm_, *_o3_prm_, solver, _errors_);

          auto system_factory = O3SystemFactory< GUM_SCALAR >(*_prm_, *_o3_prm_, solver, _errors_);

          try {
            type_factory.build();
            interface_factory.buildInterfaces();
            class_factory.buildClasses();
            interface_factory.buildElements();
            class_factory.buildImplementations();
            class_factory.buildParameters();
            class_factory.buildReferenceSlots();
            class_factory.declareAttributes();
            class_factory.declareAggregates();
            class_factory.completeAggregates();
            class_factory.completeAttributes();
            system_factory.build();
          } catch (Exception&) {
            if (_errors_.count() == 0) { _errors_.addException("an unknown error occured", file); }
          } catch (...) { _errors_.addException("an unknown exception occured", file); }
        }
      }

_readStream_() [2/2]

template<typename GUM_SCALAR >

INLINE std::string gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_readStream_ ( std::istream &  input )

private

Definition at line 115 of file O3prmReader_tpl.h.

                                                                                   {
        if (inputstr) {
          inputstr.seekg(0, inputstr.end);
          int length = int(inputstr.tellg());
          inputstr.seekg(0, inputstr.beg);

          auto str = std::string();
          str.resize(length, ' ');
          auto begin = &*str.begin();

          inputstr.read(begin, length);

          return str;
        }
        GUM_ERROR(OperationNotAllowed, "Could not open file")
      }

addClassPath()

template<typename GUM_SCALAR >

void gum::prm::o3prm::O3prmReader< GUM_SCALAR >::addClassPath

(

const std::string &

class_path

)

Add a list of paths to look for o3prm files.

Use / for path separator ! Even on Windows !

Parameters

class_path

A semicolon separated list of paths.

Definition at line 211 of file O3prmReader_tpl.h.

                                                                              {
        auto path = class_path;
        if (path[path.size() - 1] != '/') { path.append("/"); }
        auto dir = Directory(path);

        if (!dir.isValid()) {
          _errors_.addException("could not resolve class path", path);
        } else {
          _class_path_.push_back(std::move(path));
        }
      }

errCol()

template<typename GUM_SCALAR >

INLINE Idx gum::prm::o3prm::O3prmReader< GUM_SCALAR >::errCol

(

Idx

i

)

const

col of ith error or warning

Definition at line 229 of file O3prmReader_tpl.h.

                                                              {
        return _errors_.error(i).column;
      }

errFilename()

template<typename GUM_SCALAR >

INLINE std::wstring gum::prm::o3prm::O3prmReader< GUM_SCALAR >::errFilename

(

Idx

i

)

const

filename of ith error or warning

Definition at line 234 of file O3prmReader_tpl.h.

                                                                          {
        return widen(_errors_.error(i).filename);
      }

errIsError()

template<typename GUM_SCALAR >

INLINE bool gum::prm::o3prm::O3prmReader< GUM_SCALAR >::errIsError

(

Idx

i

)

const

type of ith error or warning

Definition at line 239 of file O3prmReader_tpl.h.

                                                                   {
        return _errors_.error(i).is_error;
      }

errLine()

template<typename GUM_SCALAR >

INLINE Idx gum::prm::o3prm::O3prmReader< GUM_SCALAR >::errLine

(

Idx

i

)

const

line of ith error or warning

Definition at line 224 of file O3prmReader_tpl.h.

                                                               {
        return _errors_.error(i).line;
      }

errMsg()

template<typename GUM_SCALAR >

INLINE std::string gum::prm::o3prm::O3prmReader< GUM_SCALAR >::errMsg

(

Idx

i

)

const

message of ith error or warning

Definition at line 244 of file O3prmReader_tpl.h.

                                                                    {
        return _errors_.error(i).msg;
      }

errors()

template<typename GUM_SCALAR >

INLINE Size gum::prm::o3prm::O3prmReader< GUM_SCALAR >::errors

(

)

const

publishing Errors API

of errors

Definition at line 270 of file O3prmReader_tpl.h.

                                                          {
        return _errors_.error_count;
      }

errorsContainer()

template<typename GUM_SCALAR >

INLINE const ErrorsContainer & gum::prm::o3prm::O3prmReader< GUM_SCALAR >::errorsContainer

(

)

const

publishing Errors API

of errors

Definition at line 280 of file O3prmReader_tpl.h.

                                                                                     {
        return _errors_;
      }

operator=() [1/2]

template<typename GUM_SCALAR >

INLINE O3prmReader< GUM_SCALAR > & gum::prm::o3prm::O3prmReader< GUM_SCALAR >::operator=

(

const O3prmReader< GUM_SCALAR > &

src

)

Definition at line 169 of file O3prmReader_tpl.h.

                                                                    {
        if (this == &src) { return *this; }
        _prm_        = src._prm_;
        _o3_prm_     = std::unique_ptr< O3PRM >(new O3PRM(*(src._o3_prm_)));
        _class_path_ = src._class_path_;
        _imported_   = src._imported_;
        _errors_     = src._errors_;
        return *this;
      }

operator=() [2/2]

template<typename GUM_SCALAR >

INLINE O3prmReader< GUM_SCALAR > & gum::prm::o3prm::O3prmReader< GUM_SCALAR >::operator=

(

O3prmReader< GUM_SCALAR > &&

src

)

Definition at line 180 of file O3prmReader_tpl.h.

                                                                                              {
        if (this == &src) { return *this; }
        _prm_        = std::move(src._prm_);
        _o3_prm_     = std::move(src._o3_prm_);
        _class_path_ = std::move(src._class_path_);
        _imported_   = std::move(src._imported_);
        _errors_     = std::move(src._errors_);
        return *this;
      }

parseStream()

template<typename GUM_SCALAR >

INLINE void gum::prm::o3prm::O3prmReader< GUM_SCALAR >::parseStream	(	std::istream &	input,
		std::ostream &	output,
		std::string	module = ""
	)

Definition at line 327 of file O3prmReader_tpl.h.

                                                                             {
        _readStream_(input, "", module);

        showElegantErrorsAndWarnings(output);
      }

prm() [1/2]

template<typename GUM_SCALAR>

gum::prm::PRM< GUM_SCALAR >* gum::prm::o3prm::O3prmReader< GUM_SCALAR >::prm ( )

inline

Definition at line 107 of file O3prmReader.h.

{ return _prm_; }

prm() [2/2]

template<typename GUM_SCALAR>

const gum::prm::PRM< GUM_SCALAR >* gum::prm::o3prm::O3prmReader< GUM_SCALAR >::prm ( ) const

inline

Definition at line 108 of file O3prmReader.h.

{ return _prm_; }

readFile()

template<typename GUM_SCALAR >

INLINE Size gum::prm::o3prm::O3prmReader< GUM_SCALAR >::readFile	(	const std::string &	file,
		const std::string &	module = ""
	)

Read file and load its content using a PRMFactory. The package parameter set the file's content package.

Definition at line 292 of file O3prmReader_tpl.h.

                                                                               {
        try {
          auto lastSlashIndex = file.find_last_of('/');

          auto dir = Directory(file.substr(0, lastSlashIndex + 1));

          if (!dir.isValid()) {
            _errors_.addException("could not find file", file);
            return _errors_.count();
          }

          auto basename    = file.substr(lastSlashIndex + 1);
          auto absFilename = dir.absolutePath() + basename;

          std::ifstream input(absFilename);
          if (input.is_open()) {
            _readStream_(input, file, module);
          } else {
            _errors_.addException("could not open file", file);
          }

          return _errors_.count();

        } catch (gum::Exception& e) {
          GUM_SHOWERROR(e);
          _errors_.addException(e.errorContent(), file);
          return _errors_.count();
        } catch (...) {
          _errors_.addException("unknown error", file);
          return _errors_.count();
        }
      }

readString()

template<typename GUM_SCALAR >

INLINE Size gum::prm::o3prm::O3prmReader< GUM_SCALAR >::readString

(

const std::string &

string

)

With readString method, you must set the current path to search from import yourself, using addClassPath.

Definition at line 285 of file O3prmReader_tpl.h.

                                                                            {
        std::stringstream sBuff(str);
        _readStream_(sBuff, "");
        return _errors_.count();
      }

setClassPath()

template<typename GUM_SCALAR >

void gum::prm::o3prm::O3prmReader< GUM_SCALAR >::setClassPath

(

const std::string &

class_path

)

This methods defines the list of paths to look for o3prm files.

Use / for path separator ! Even on Windows !

Parameters

class_path

A semicolon separated list of paths.

Definition at line 191 of file O3prmReader_tpl.h.

                                                                              {
        _class_path_ = std::vector< std::string >();
        size_t i     = 0;
        size_t j     = class_path.find(';');

        while (j != std::string::npos) {
          addClassPath(class_path.substr(i, j - i));
          i = j + 1;

          if (i < class_path.size()) {
            j = class_path.find(';', i);
          } else {
            j = std::string::npos;
          }
        }

        if (i < class_path.size()) { addClassPath(class_path.substr(i, std::string::npos)); }
      }

showElegantErrors()

template<typename GUM_SCALAR >

INLINE void gum::prm::o3prm::O3prmReader< GUM_SCALAR >::showElegantErrors

(

std::ostream &

o = std::cerr

)

const

send on std::cerr the list of errors

Definition at line 249 of file O3prmReader_tpl.h.

                                                                                  {
        for (Idx i = 0; i < _errors_.count(); ++i) {
          auto err = _errors_.error(i);
          if (err.is_error) { o << _print_(err) << std::endl; }
        }
      }

showElegantErrorsAndWarnings()

template<typename GUM_SCALAR >

INLINE void gum::prm::o3prm::O3prmReader< GUM_SCALAR >::showElegantErrorsAndWarnings

(

std::ostream &

o = std::cerr

)

const

send on std::cerr the list of errors or warnings

Definition at line 257 of file O3prmReader_tpl.h.

                                                                                             {
        for (Idx i = 0; i < _errors_.count(); ++i) {
          auto err = _errors_.error(i);
          o << _print_(err) << std::endl;
        }
      }

showErrorCounts()

template<typename GUM_SCALAR >

INLINE void gum::prm::o3prm::O3prmReader< GUM_SCALAR >::showErrorCounts

(

std::ostream &

o = std::cerr

)

const

send on std::cerr the number of errors and the number of warnings

Definition at line 265 of file O3prmReader_tpl.h.

                                                                                {
        _errors_.syntheticResults(o);
      }

warnings()

template<typename GUM_SCALAR >

INLINE Size gum::prm::o3prm::O3prmReader< GUM_SCALAR >::warnings

(

)

const

of errors

Definition at line 275 of file O3prmReader_tpl.h.

                                                            {
        return _errors_.warning_count;
      }

Member Data Documentation

_class_path_

template<typename GUM_SCALAR>

std::vector< std::string > gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_class_path_

private

Definition at line 145 of file O3prmReader.h.

_errors_

template<typename GUM_SCALAR>

ErrorsContainer gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_errors_

private

Definition at line 149 of file O3prmReader.h.

_imported_

template<typename GUM_SCALAR>

Set< std::string > gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_imported_

private

Definition at line 146 of file O3prmReader.h.

_o3_prm_

template<typename GUM_SCALAR>

std::unique_ptr< O3PRM > gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_o3_prm_

private

Definition at line 144 of file O3prmReader.h.

_prm_

template<typename GUM_SCALAR>

PRM< GUM_SCALAR >* gum::prm::o3prm::O3prmReader< GUM_SCALAR >::_prm_

private

Definition at line 143 of file O3prmReader.h.

---

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

• agrum/PRM/o3prm/O3prmReader.h
• agrum/PRM/o3prm/O3prmReader_tpl.h