Changeset 321 for EcnlProtoTool/trunk/asp3_dcre/tecsgen/tecslib/plugin/ThroughPlugin.rb

Timestamp:

Aug 23, 2017, 9:27:43 AM (7 years ago)

Author:

coas-nagasima

Message:

文字コードを設定

File:

• EcnlProtoTool/trunk/asp3_dcre/tecsgen/tecslib/plugin/ThroughPlugin.rb (modified) (13 diffs, 1 prop)

EcnlProtoTool/trunk/asp3_dcre/tecsgen/tecslib/plugin/ThroughPlugin.rb

@@ -6 +6 @@
 #   Copyright (C) 2008-2014 by TOPPERS Project
 #--
-#   上記著作権è€
-は，以下の(1)～(4)ã®æ¡ä»¶ã‚’æº€ãŸã™å ´åˆã«é™ã‚Šï¼Œæœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§
-#   ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
-#   変・再é
-å¸ƒï¼ˆä»¥ä¸‹ï¼Œåˆ©ç”¨ã¨å‘¼ã¶ï¼‰ã™ã‚‹ã“とを無償で許諾する．
-#   (1) æœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã‚’ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã®å½¢ã§åˆ©ç”¨ã™ã‚‹å ´åˆã«ã¯ï¼Œä¸Šè¨˜ã®è‘—ä½œ
-#       権表示，この利用条件および下記の無保証規定が，そのままの形でソー
-#       スコード中に含まれていること．
-#   (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
-#       用できる形で再é
-å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œå†é
-å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨
-#       è€
-マニュアルなど）に，上記の著作権表示，この利用条件および下記
-#       の無保証規定を掲載すること．
-#   (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
-#       用できない形で再é
-å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œæ¬¡ã®ã„ずれかの条件を満たすこ
-#       と．
-#     (a) 再é
-å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨è€
-マニュアルなど）に，上記の著
-#         作権表示，この利用条件および下記の無保証規定を掲載すること．
-#     (b) 再é
-å¸ƒã®å½¢æ
-‹ã‚’，別に定める方法によって，TOPPERSプロジェクトに
-#         å ±å‘Šã™ã‚‹ã“ã¨ï¼Ž
-#   (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
-#       害からも，上記著作権è€
-およびTOPPERSプロジェクトをå
-è²¬ã™ã‚‹ã“と．
-#       また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
-#       由に基づく請求からも，上記著作権è€
-およびTOPPERSプロジェクトを
-#       å
-è²¬ã™ã‚‹ã“と．
+#   上記著作権者は，以下の(1)～(4)の条件を満たす場合に限り，本ソフトウェ
+#   ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
+#   変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
+#   (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
+#       権表示，この利用条件および下記の無保証規定が，そのままの形でソー
+#       スコード中に含まれていること．
+#   (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
+#       用できる形で再配布する場合には，再配布に伴うドキュメント（利用
+#       者マニュアルなど）に，上記の著作権表示，この利用条件および下記
+#       の無保証規定を掲載すること．
+#   (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
+#       用できない形で再配布する場合には，次のいずれかの条件を満たすこ
+#       と．
+#     (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
+#         作権表示，この利用条件および下記の無保証規定を掲載すること．
+#     (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
+#         報告すること．
+#   (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
+#       害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+#       また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
+#       由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
+#       免責すること．
 #  
-#   本ソフトウェアは，無保証で提供されているものである．上記著作権è€
-お
-#   よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
-#   に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
-#   アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
-#   ã®è²¬ä»»ã‚’è² ã‚ãªã„ï¼Ž
+#   本ソフトウェアは，無保証で提供されているものである．上記著作権者お
+#   よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
+#   に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
+#   アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
+#   の責任を負わない．
 #  
-#   $Id: ThroughPlugin.rb 1011 2016-07-11 02:20:01Z coas-nagasima $
+#   $Id$
 #++
 
-# mikan through plugin: namespace が考æ
-®ã•ã‚Œã¦ã„ない
-
-#==  スループラグインのå
-±é€šã®è¦ªã‚¯ãƒ©ã‚¹ã€€ã‹ã¤ （何もせず）スルーするセルを挿å
-¥ã™ã‚‹ã‚¹ãƒ«ãƒ¼ãƒ—ラグイン
-#    スループラグインは ThroughPlugin の子クラスとして定義する
+# mikan through plugin: namespace が考慮されていない
+
+#==  スループラグインの共通の親クラス　かつ （何もせず）スルーするセルを挿入するスループラグイン
+#    スループラグインは ThroughPlugin の子クラスとして定義する
 class ThroughPlugin < Plugin
-#@cell_name::      Symbol             ç”Ÿæˆã™ã‚‹ã‚»ãƒ«åï¼ˆè¤‡æ•°ã‚»ãƒ«ã‚’ç”Ÿæˆã™ã‚‹å ´åˆã€å—ã‘å£å´ã®ã‚»ãƒ«ï¼‰
-#@plugin_arg_str:: string             through で指定された引数
-#@next_cell:: Cell                    呼び口を結合するセル
-#@next_cell_port_name:: Symbol       呼び口を結合する受口の名前
-#@signature::      Signature          シグニチャ
-#@celltype::       Celltype           呼びå
-ˆã®ã‚»ãƒ«ã®ã‚»ãƒ«ã‚¿ã‚¤ãƒ—. through ãŒé€£æŽ¥ã™ã‚‹å ´åˆã€æœ€çµ‚çš„ãªå‘¼ã³å
-ˆã®ã‚»ãƒ«ã®ã‚»ãƒ«ã‚¿ã‚¤ãƒ—
-#@entry_port_name::Symbol             生成するセルの受け口名  "eThroughEntry"
-#@call_port_name:: Symbol             生成するセルの呼び口名  "cCall"
-#@ct_name::        Symbol             生成するセルのセルタイプ名   "t#{self.class.name}_#{@signature.get_global_name}"
-#@plugin_arg_list:: Hash              プラグイン引数をパースした結果のハッシュ変数
-#@caller_cell::    Cell               呼びå
-ƒã®ã‚»ãƒ«ï¼Žthrough ãƒ—ãƒ©ã‚°ã‚¤ãƒ³ãŒé€£æŽ¥ã™ã‚‹å ´åˆã§ã¯ã€æœ€ã‚‚å‘¼ã³å
-ƒã®ã‚»ãƒ«ï¼Ž($source$)
-#                                     through プラグインが合流するケースでは、1つ目の呼びå
-ƒã‚»ãƒ«ã®ã¿å¼•æ•°ã¨ã—て与えられる
-#                                     従って TracePlugin の呼びå
-ƒã®åˆ¤åˆ¥ã«åˆ©ç”¨ã™ã‚‹å ´åˆã¯ã€ç•°ãªã‚‹å‘¼ã³å
-ƒã‹ã‚‰å‘¼ã°ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ることに注意しなくてはならない
-#@callee_cell:: Cell                  呼びå
-ˆã®ã‚»ãƒ«($destination$)
-#@plugin_arg_check_proc_tab:: [string => Proc]  プラグイン引数名⇒チェック関数
-# 以下の変数は、initialize ではなく、後から設定される
-#@start_@region::  Region             始まりのリージョン： caller_cell のリージョンとは異なる可能性がある ($start_region$)
-#@end_region::  Region                終わりのリージョン： next_cell のリージョンとは異なる可能性がある ($end_region$)
-#@region:: Region                     @start_region と @end_region のいずれかで、cell を置くのが好ましいリージョン ($preferred_region$)
-#@through_type:: Symbol              :THROUGH, :TO_THROUGH, :IN_THROUGH, :OUT_THROUGH のいずれか
-
-  # この Plugin が生成したセルタイプのリスト
+#@cell_name::      Symbol             生成するセル名（複数セルを生成する場合、受け口側のセル）
+#@plugin_arg_str:: string             through で指定された引数
+#@next_cell:: Cell                    呼び口を結合するセル
+#@next_cell_port_name:: Symbol       呼び口を結合する受口の名前
+#@signature::      Signature          シグニチャ
+#@celltype::       Celltype           呼び先のセルのセルタイプ. through が連接する場合、最終的な呼び先のセルのセルタイプ
+#@entry_port_name::Symbol             生成するセルの受け口名  "eThroughEntry"
+#@call_port_name:: Symbol             生成するセルの呼び口名  "cCall"
+#@ct_name::        Symbol             生成するセルのセルタイプ名   "t#{self.class.name}_#{@signature.get_global_name}"
+#@plugin_arg_list:: Hash              プラグイン引数をパースした結果のハッシュ変数
+#@caller_cell::    Cell               呼び元のセル．through プラグインが連接する場合では、最も呼び元のセル．($source$)
+#                                     through プラグインが合流するケースでは、1つ目の呼び元セルのみ引数として与えられる
+#                                     従って TracePlugin の呼び元の判別に利用する場合は、異なる呼び元から呼ばれる可能性があることに注意しなくてはならない
+#@callee_cell:: Cell                  呼び先のセル($destination$)
+#@plugin_arg_check_proc_tab:: [string => Proc]  プラグイン引数名⇒チェック関数
+# 以下の変数は、initialize ではなく、後から設定される
+#@start_@region::  Region             始まりのリージョン： caller_cell のリージョンとは異なる可能性がある ($start_region$)
+#@end_region::  Region                終わりのリージョン： next_cell のリージョンとは異なる可能性がある ($end_region$)
+#@region:: Region                     @start_region と @end_region のいずれかで、cell を置くのが好ましいリージョン ($preferred_region$)
+#@through_type:: Symbol              :THROUGH, :TO_THROUGH, :IN_THROUGH, :OUT_THROUGH のいずれか
+
+  # この Plugin が生成したセルタイプのリスト
   @@generated_celltype = {}
 
-  #=== ThroughPlugin の初期化
-  #     through が指定された時点で生成が行われる
-  #         初期化では、指定された引数を記録するに留める
-  #cell_name::      Symbol             生成すべきセル名（受口側）
-  #plugin_arg::     string             through で指定された引数
-  #next_cell::      Cell               呼び口を接続するセル
-  #next_cell_port_name:: Symbol        呼び口を接続する受口の名前
-  #signature::      Signature          シグニチャ
-  #celltype::       Celltype           セルタイプ (呼びå
-ˆã®ã‚»ãƒ«ã®ã‚»ãƒ«ã‚¿ã‚¤ãƒ—)
-  #caller_cell::    Cell               呼びå
-ƒã®ã‚»ãƒ«ï¼Ž@caller_cell のé 
-を参ç
-§
+  #=== ThroughPlugin の初期化
+  #     through が指定された時点で生成が行われる
+  #         初期化では、指定された引数を記録するに留める
+  #cell_name::      Symbol             生成すべきセル名（受口側）
+  #plugin_arg::     string             through で指定された引数
+  #next_cell::      Cell               呼び口を接続するセル
+  #next_cell_port_name:: Symbol        呼び口を接続する受口の名前
+  #signature::      Signature          シグニチャ
+  #celltype::       Celltype           セルタイプ (呼び先のセルのセルタイプ)
+  #caller_cell::    Cell               呼び元のセル．@caller_cell の項を参照
   def initialize( cell_name, plugin_arg, next_cell, next_cell_port_name, signature, celltype, caller_cell )
     super()
-    @cell_name = cell_name                      # 生成すべきセル名（受け口側のセル名）
-                                                # この呼びå
-ˆã«åˆ¥ã‚»ãƒ«ã‚’ç”Ÿæˆã™ã‚‹å ´åˆã€ã“ã®åå‰ã‚’æŽ¥é ­è¾žã¨ã™ã¹ã
-    @next_cell = next_cell                      # 呼びå
-ˆã®ã‚»ãƒ«
+    @cell_name = cell_name                      # 生成すべきセル名（受け口側のセル名）
+                                                # この呼び先に別セルを生成する場合、この名前を接頭辞とすべき
+    @next_cell = next_cell                      # 呼び先のセル
     @next_cell_port_name = next_cell_port_name
     @signature = signature
@@ -121 +89 @@
     @celltype = celltype
     @plugin_arg_str = plugin_arg
-    @plugin_arg_list = {}                       # プラグイン引数をパースした結果のハッシュ変数
+    @plugin_arg_list = {}                       # プラグイン引数をパースした結果のハッシュ変数
     @caller_cell     = caller_cell
-    Join.set_through_info self                  # 引数で渡らない(å¾Œã‹ã‚‰è¿½åŠ ã•ã‚ŒãŸ)ものは set_through_info で設定される
+    Join.set_through_info self                  # 引数で渡らない(後から追加された)ものは set_through_info で設定される
     print( "#{self.class.name}.new( '#{cell_name}', '#{plugin_arg}', '#{next_cell.get_name}', '#{next_cell_port_name}', #{celltype.get_name} )\n" )
   end
 
-  #=== æƒ
-å ±ã‚’è¨­å®šã™ã‚‹
-  # å
-±æœ‰ãƒãƒ£ãƒ³ãƒãƒ«ã®å ´åˆ caller_cell, next_cell のいずれの region でもないケースがある
-  # å¾Œã‹ã‚‰è¿½åŠ ã—ãŸã®ã§ initialize の引数ではなく、別メソッドで設定
-  # このメソッドは、オーバーライドしないでください
-  # Join と ThrougPlugin ã®é–“ã®é€£çµ¡ç”¨ã§ã€ä»Šå¾Œã¨ã‚‚å¼•æ•°ãŒè¿½åŠ ã•ã‚Œã‚‹å¯èƒ½æ€§ãŒã‚ã‚‹ãŸã‚
-  # このメソッドは V1.C.0.34 で位置が移動され、ThroughPlugin#initialize で呼び出される
+  #=== 情報を設定する
+  # 共有チャンネルの場合 caller_cell, next_cell のいずれの region でもないケースがある
+  # 後から追加したので initialize の引数ではなく、別メソッドで設定
+  # このメソッドは、オーバーライドしないでください
+  # Join と ThrougPlugin の間の連絡用で、今後とも引数が追加される可能性があるため
+  # このメソッドは V1.C.0.34 で位置が移動され、ThroughPlugin#initialize で呼び出される
   def set_through_info( start_region, end_region, through_type, join, callee_cell, count )
     @start_region = start_region
@@ -143 +109 @@
     @count = count
 
-    # preferred_region の設定
+    # preferred_region の設定
     case through_type
     when :IN_THROUGH, :THROUGH
@@ -154 +120 @@
   end
 
-  #===  セルの名前を得る
+  #===  セルの名前を得る
   def get_cell_name
     @cell_name
   end
 
-  #=== NamespacePath を得る
-  # 生成するセルの namespace path を生成する
+  #=== NamespacePath を得る
+  # 生成するセルの namespace path を生成する
   def get_cell_namespace_path
 #    nsp = @region.get_namespace.get_namespace_path
@@ -167 +133 @@
   end
 
-  #===  生成されたセルの受け口の名前を得る
+  #===  生成されたセルの受け口の名前を得る
   def get_through_entry_port_name
     @entry_port_name
   end
 
-  #===  宣言コードの生成
-  #      typedef, signature, celltype など（cell 以外）のコードを生成
-  #          é‡è¤‡ã—ã¦ç”Ÿæˆã—ã¦ã¯ãªã‚‰ãªã„ï¼ˆã™ã§ã«ç”Ÿæˆã•ã‚Œã¦ã„ã‚‹å ´åˆã¯å‡ºåŠ›ã—ãªã„ã“ã¨ï¼‰
-  #file::        FILE       生成するファイル
+  #===  宣言コードの生成
+  #      typedef, signature, celltype など（cell 以外）のコードを生成
+  #          重複して生成してはならない（すでに生成されている場合は出力しないこと）
+  #file::        FILE       生成するファイル
   def gen_plugin_decl_code( file )
 
-    # このセルタイプ（同じシグニチャ）は既に生成されているか？
+    # このセルタイプ（同じシグニチャ）は既に生成されているか？
     if @@generated_celltype[ @ct_name ] == nil then
       @@generated_celltype[ @ct_name ] = [ self ]
@@ -223 +189 @@
   end
 
-  #=== CDL ファイルの生成
-  #file::     FILE    生成するファイル
+  #=== CDL ファイルの生成
+  #file::     FILE    生成するファイル
   def gen_cdl_file( file )
     gen_plugin_decl_code( file )
@@ -230 +196 @@
   end
 
-  #===  セルコードの生成
-  #     through 指定により生じるセルコード(CDL)を生成する
-  #file::        FILE       生成するファイル
+  #===  セルコードの生成
+  #     through 指定により生じるセルコード(CDL)を生成する
+  #file::        FILE       生成するファイル
   def gen_through_cell_code( file )
 
@@ -247 +213 @@
   end
 
-  #=== 後ろのコードを生成
-  #プラグインの後ろのコード (CDL) を生成
+  #=== 後ろのコードを生成
+  #プラグインの後ろのコード (CDL) を生成
   #file:: File: 
   def self.gen_post_code( file )
-    # 複数のプラグインの post_code が一つのファイルに含まれるため、以下のような見出しをつけること
+    # 複数のプラグインの post_code が一つのファイルに含まれるため、以下のような見出しをつけること
     # file.print "/* '#{self.class.name}' post code */\n"
   end
 
-  #===  受け口関数の本体(C言語)を生成する
-  #     通常であれば、ジェネレータは受け口関数のテンプレートを生成する
-  #     ãƒ—ãƒ©ã‚°ã‚¤ãƒ³ã®å ´åˆã€å¤‰æ›´ã™ã‚‹å¿
-要のないセルタイプコードを生成する
-  #file::           FILE        出力å
-ˆãƒ•ã‚¡ã‚¤ãƒ«
+  #===  受け口関数の本体(C言語)を生成する
+  #     通常であれば、ジェネレータは受け口関数のテンプレートを生成する
+  #     プラグインの場合、変更する必要のないセルタイプコードを生成する
+  #file::           FILE        出力先ファイル
   #b_singleton::    bool        true if singleton
   #ct_name::        Symbol
@@ -285 +249 @@
     p_cellcb = #{global_ct_name}_GET_CELLCB(idx);
   }else{
-     /* エラー処理コードをここに記述 */
+     /* エラー処理コードをここに記述 */
   }
 
@@ -318 +282 @@
   end
 
-  #=== Through プラグインの引数の名前を置換する
+  #=== Through プラグインの引数の名前を置換する
   def check_plugin_arg( ident, rhs )
     rhs = subst_name rhs
@@ -324 +288 @@
   end
 
-  #=== ThroughPlugin#名前の置換
-  # プラグインオプション引数å†
-の文字列を置換する
-  #   $source$       … 呼びå
-ƒã®ã‚»ãƒ«å
-  #   $destination$  … 呼びå
-ˆã®ã‚»ãƒ«å
-  #   $SOURCE$       … 呼びå
-ƒã®ã‚»ãƒ«å (リージョン名を '_' で連結した global_name)
-  #   $DESTINATION$  … 呼びå
-ˆã®ã‚»ãƒ«å (リージョン名を '_' で連結した global_name)
-  #   $next$         … 次のセル名
-  #                     複数の through ãŒã¤ãªãŒã£ã¦ã„ã‚‹å ´åˆã€ã™ãå¾Œã‚ã«æ¥ã‚‹ã‚‚ã®
-  #   $NEXT$         … 次のセル名 (リージョン名を '_' で連結した global_name)
-  #                     複数の through ãŒã¤ãªãŒã£ã¦ã„ã‚‹å ´åˆã€ã™ãå¾Œã‚ã«æ¥ã‚‹ã‚‚ã®
-  #   $start_region$ … $source$ のセルの存在する region (global_name)
-  #   $end_region$   … $destination$ のセルの存在する region (global_name)
-  #   $preferred_region$  … 適切な region (global_name), start_region または end_region
-  #   $count$        … region 間の through の適用数
-  #   $$             … $ に置換
+  #=== ThroughPlugin#名前の置換
+  # プラグインオプション引数内の文字列を置換する
+  #   $source$       … 呼び元のセル名
+  #   $destination$  … 呼び先のセル名
+  #   $SOURCE$       … 呼び元のセル名 (リージョン名を '_' で連結した global_name)
+  #   $DESTINATION$  … 呼び先のセル名 (リージョン名を '_' で連結した global_name)
+  #   $next$         … 次のセル名
+  #                     複数の through がつながっている場合、すぐ後ろに来るもの
+  #   $NEXT$         … 次のセル名 (リージョン名を '_' で連結した global_name)
+  #                     複数の through がつながっている場合、すぐ後ろに来るもの
+  #   $start_region$ … $source$ のセルの存在する region (global_name)
+  #   $end_region$   … $destination$ のセルの存在する region (global_name)
+  #   $preferred_region$  … 適切な region (global_name), start_region または end_region
+  #   $count$        … region 間の through の適用数
+  #   $$             … $ に置換
   def subst_name( str )
-    # セル名の置換
+    # セル名の置換
     str = str.gsub( /(^|[^\$])\$source\$/, "\\1#{@caller_cell.get_name}" )
     str = str.gsub( /(^|[^\$])\$destination\$/, "\\1#{@callee_cell.get_name}" )
@@ -352 +311 @@
     str = str.gsub( /(^|[^\$])\$next\$/, "\\1#{@next_cell.get_name}" )
     str = str.gsub( /(^|[^\$])\$NEXT\$/, "\\1#{@next_cell.get_global_name}" )
-    # region 名の置換
+    # region 名の置換
     str = str.gsub( /(^|[^\$])\$start_region\$/, "\\1#{@start_region.get_global_name}" )
     str = str.gsub( /(^|[^\$])\$end_region\$/, "\\1#{@end_region.get_global_name}" )
@@ -358 +317 @@
     str = str.gsub( /(^|[^\$])\$count\$/, "\\1#{@count}" )
 
-    str = str.gsub( /\$\$/, "\$" )                       # $$ を $ に置換
+    str = str.gsub( /\$\$/, "\$" )                       # $$ を $ に置換
 
     return str