cfg_contents.hpp

FDMP the body of the kernel, the Information-Technology Promotion Agency (IPA) adopted by the unexpl

/*
 *  TOPPERS/FDMP Kernel
 *      Toyohashi Open Platform for Embedded Real-Time Systems/
 *      Function Distributed Multiprocessor Kernel
 *
 *  Copyright (C) 2005 by Takagi Nobuhisa
 * 
 *  忋婰挊嶌尃幰偼丆埲壓偺 (1)乣(4) 偺忦審偐丆Free Software Foundation 
 *  偵傛偭偰岞昞偝傟偰偄傞 GNU General Public License 偺 Version 2 偵婰
 *  弎偝傟偰偄傞忦審傪枮偨偡応崌偵尷傝丆杮僜僼僩僂僃傾乮杮僜僼僩僂僃傾
 *  傪夵曄偟偨傕偺傪娷傓丏埲壓摨偠乯傪巊梡丒暋惢丒夵曄丒嵞攝晍乮埲壓丆
 *  棙梡偲屇傇乯偡傞偙偲傪柍彏偱嫋戻偡傞丏
 *  (1) 杮僜僼僩僂僃傾傪僜乕僗僐乕僪偺宍偱棙梡偡傞応崌偵偼丆忋婰偺挊嶌
 *      尃昞帵丆偙偺棙梡忦審偍傛傃壓婰偺柍曐徹婯掕偑丆偦偺傑傑偺宍偱僜乕
 *      僗僐乕僪拞偵娷傑傟偰偄傞偙偲丏
 *  (2) 杮僜僼僩僂僃傾傪丆儔僀僽儔儕宍幃側偳丆懠偺僜僼僩僂僃傾奐敪偵巊
 *      梡偱偒傞宍偱嵞攝晍偡傞応崌偵偼丆嵞攝晍偵敽偆僪僉儏儊儞僩乮棙梡
 *      幰儅僯儏傾儖側偳乯偵丆忋婰偺挊嶌尃昞帵丆偙偺棙梡忦審偍傛傃壓婰
 *      偺柍曐徹婯掕傪宖嵹偡傞偙偲丏
 *  (3) 杮僜僼僩僂僃傾傪丆婡婍偵慻傒崬傓側偳丆懠偺僜僼僩僂僃傾奐敪偵巊
 *      梡偱偒側偄宍偱嵞攝晍偡傞応崌偵偼丆師偺偄偢傟偐偺忦審傪枮偨偡偙
 *      偲丏
 *    (a) 嵞攝晍偵敽偆僪僉儏儊儞僩乮棙梡幰儅僯儏傾儖側偳乯偵丆忋婰偺挊
 *        嶌尃昞帵丆偙偺棙梡忦審偍傛傃壓婰偺柍曐徹婯掕傪宖嵹偡傞偙偲丏
 *    (b) 嵞攝晍偺宍懺傪丆暿偵掕傔傞曽朄偵傛偭偰丆TOPPERS僾儘僕僃僋僩偵
 *        曬崘偡傞偙偲丏
 *  (4) 杮僜僼僩僂僃傾偺棙梡偵傛傝捈愙揑傑偨偼娫愙揑偵惗偠傞偄偐側傞懝
 *      奞偐傜傕丆忋婰挊嶌尃幰偍傛傃TOPPERS僾儘僕僃僋僩傪柶愑偡傞偙偲丏
 * 
 *  杮僜僼僩僂僃傾偼丆柍曐徹偱採嫙偝傟偰偄傞傕偺偱偁傞丏忋婰挊嶌尃幰偍
 *  傛傃TOPPERS僾儘僕僃僋僩偼丆杮僜僼僩僂僃傾偵娭偟偰丆偦偺揔梡壜擻惈傕
 *  娷傔偰丆偄偐側傞曐徹傕峴傢側偄丏傑偨丆杮僜僼僩僂僃傾偺棙梡偵傛傝捈
 *  愙揑傑偨偼娫愙揑偵惗偠偨偄偐側傞懝奞偵娭偟偰傕丆偦偺愑擟傪晧傢側偄丏
 * 
 */

/*!
 *  \file   toppers/itron/cfg_contents.hpp
 *  \brief  僐儞僼傿僊儏儗乕僔儑儞僼傽僀儖偺僐儞僥儞僣偵娭偡傞愰尵掕媊
 *
 *  偙偺僼傽僀儖偱掕媊偝傟傞僋儔僗
 *  \code
 *  class cfg_contents;
 *  \endcode
 */
#ifndef TOPPERS_ITRON_CFG_CONTENTS_HPP_
#define TOPPERS_ITRON_CFG_CONTENTS_HPP_

#include "toppers/itron/cfg_group.hpp"
#include <vector>
#include <string>

namespace toppers
{
  namespace itron
  {

    class kernel_object;

    /*!
     *  \class  cfg_contents cfg_contents.hpp "toppers/itron/cfg_contents.hpp"
     *  \brief  僐儞僼傿僊儏儗乕僔儑儞僼傽僀儖偺僐儞僥儞僣傪奿擺偡傞偨傔偺僋儔僗
     *  \image  html class_diagram__cfg_contents.png
     */
    class cfg_contents
    {
    public:
      typedef std::vector<boost::shared_ptr<cfg_group> > group_container;
      typedef const boost::shared_ptr<cfg_contents> ( *builder_type )( text::const_iterator&, text::const_iterator, bool, codeset_t );

      /*!
       *  \brief  僐儞僗僩儔僋僞
       *  \param  ucn     崙嵺暥帤柤傪桳岠偵偡傞応崌偼 true 傪巜掕
       *  \param  codeset 暥帤僐乕僪
       */
      explicit cfg_contents( bool ucn = false, codeset_t codeset = ascii ) : ucn_( ucn ), codeset_( codeset ) {}
      /*!
       *  \brief  僐儞僗僩儔僋僞
       *  \param  name    僐儞僥儞僣柤
       *  \param  ucn     崙嵺暥帤柤傪桳岠偵偡傞応崌偼 true 傪巜掕
       *  \param  codeset 暥帤僐乕僪
       */
      explicit cfg_contents( const std::string& name, bool ucn = false, codeset_t codeset = ascii ) : name_( name ), ucn_( ucn ), codeset_( codeset ) {}
      /*!
       *  \brief  僨僗僩儔僋僞
       */
      virtual ~cfg_contents() {}

      void swap( cfg_contents& other ) throw();
      /*!
       *  \brief  僌儖乕僾楍傊偺嶲徠偺庢摼
       *  \return 僌儖乕僾楍傊偺嶲徠傪曉偡
       */
      group_container& groups() { return groups_; }
      /*!
       *  \brief  僌儖乕僾楍傊偺嶲徠偺庢摼
       *  \return 僌儖乕僾楍傊偺嶲徠傪曉偡
       */
      const group_container& groups() const { return groups_; }
      /*!
       *  \brief  僌儖乕僾楍偺愝掕
       *  \param  container 愝掕偡傞僌儖乕僾楍
       */
      void groups( const group_container& container ) { groups_ = container; }
      /*!
       *  \brief  僐儞僥儞僣柤偺愝掕
       *  \param  str   僐儞僥儞僣柤偲偟偰愝掕偡傞暥帤楍
       */
      void name( const std::string& str ) { name_ = str; }
      /*!
       *  \brief  僐儞僥儞僣柤偺庢摼
       *  \return 僐儞僥儞僣柤傪昞偡暥帤楍傊偺嶲徠傪曉偡
       */
      const std::string& name() const { return name_; }
      /*!
       *  \brief  僐儞僥儞僣撪梕偺暘椶
       *  \return 暘椶屻偺僐儞僥儞僣楍傊偺僗儅乕僩億僀儞僞傪曉偡
       *
       *  偙偺娭悢偼丄僐儞僥儞僣撪偺僌儖乕僾傪僇乕僱儖庬暿偵墳偠偨婯懃偵偟偨偑偭偰暘椶偟丄
       *  偦偺暘椶偝傟偨扨埵傪怴偨側僐儞僥儞僣偲偟偰攝楍傪惗惉偟傑偡丅\n
       *  椺偊偽丄儅儖僠僾儘僙僢僒岦偗僇乕僱儖偺応崌丄儘乕僇儖僋儔僗偵懳墳偟偨奺僌儖乕僾
       *  傪怴偨側僐儞僥儞僣偲偟丄儀僋僞偵奿擺偟傑偡丅
       *
       *  classify 娭悢偑惗惉偡傞僐儞僥儞僣偼丄嵟廔揑偵偼堦慻偺 kernel_id.h 偲 kernel_cfg.c
       *  傪惗惉偡傞偨傔偺忣曬偲側傝傑偡丅\n
       *  偟偨偑偭偰丄儊儌儕曐岇奼挘偺僪儊僀儞偺傛偆偵丄暋悢偺僌儖乕僾傪帩偮僐儞僥儞僣偱
       *  偁偭偰傕丄嵟廔揑偵堦慻偺 kernel_id.h 偲 kerenl_cfg.c 偟偐惗惉偡傞昁梫偑側偄応崌偼丄
       *  classify 娭悢偱惗惉偝傟傞儀僋僞偺梫慺傕侾偮偩偗偵側傝傑偡丅
       */
      const boost::shared_ptr<std::vector<boost::shared_ptr<cfg_contents> > > classify() const { return do_classify( ucn_, codeset_ ); }
      /*!
       *  \brief  僜乕僗僥僉僗僩偺峔暥夝愅
       *  \param  next  夝愅懳徾偺愭摢埵抲
       *  \param  last  夝愅懳徾偺廔抂埵抲+1
       */
      bool parse( text::const_iterator& next, text::const_iterator last );
    protected:
      virtual const boost::shared_ptr<std::vector<boost::shared_ptr<cfg_contents> > > do_classify( bool ucn, codeset_t codeset ) const;
      virtual bool do_parse( text::const_iterator& next, text::const_iterator last, bool ucn, codeset_t codeset );
    private:
      group_container groups_;
      std::string name_;
      bool ucn_;
      codeset_t codeset_;
    };

  }
}

#endif  // ! TOPPERS_ITRON_CFG_CONTENTS_HPP_