JPH02281335A - Ｃ言語プログラム・ソース・ブロッカ - Google Patents

Abstract

(57)【要約】本公報は電子出願前の出願データであるた
め要約のデータは記録されません。

Description

【発明の詳細な説明】 （技術分前） 本発明は、コンピニータ・プログラミング技術に関し、
特にｒＣＪで書かれたプログラムのソース・コード・リ
ストの判り易さを改善するプログラミング注釈ツールに
関する。

（背景技術） コンピュータ・プログラミング技術に習熟する者には周
知の如く、ソース・コード・リストの検討によりプログ
ラムの構造および流れを追跡することは困難である。例
え自分自身の労作を調べる場合であっても、もしプログ
ラムがその「フィロソフィ」が記憶に新しくない過去に
書かれたものであるならば、困難に遭遇することがある
。しかし、部分的あるいは全体が他人により書かれたプ
ログラムのソース・コード・リストの検討を行うことは
特に困難であるが、これは各プログラマがプログラムを
書く際自分自身のスタイルおよび思考過程を有するため
である。

更に、（生産性の要求の故に、あるいは更に劣悪な規律
の故に）おそらくは、プログラムが日常的に詳細なフロ
ーチャートの用意の如き高レベルの書類作りを経ず、そ
の結果他人の仕事に止まらず自分自身のプログラムを検
査することの難しさが更に追い打ちをかけることが不幸
な事実である。

職業的プログラマならびにアマチュア・プログラマの間
で広く使用される１つの高く評価されているプログラミ
ング言語は［Ｃ１である。

よく書かれた「Ｃ」プログラムは、しばしば、いくつか
のレベルに「入れ子」になり得るコード・ブロックを使
用し、過去において作られあるいは他人により作られた
ソース・コード・リストを調べる際、コード・ブロック
の初めと終りおよび入れ子のレベルを判定することは厄
介である。

当業者には、ｒＣＪソース・コード・リストにおいて、
リストされたプログラムのコード・ブロックおよび入れ
子構造を追従する際リストの精読を助ける注釈を提供す
ることが非常に望ましいことが理解されようし、また本
発明が目的とするものもこのことである。

（発明の目的） 従って、本発明の広い目的は、リストされたプログラム
の構造およびシーケンスの追跡を容易にするため、ソー
ス・コード・リストに対する注釈ツールを提供すること
にある。

本発明の別の目的は、ｒＣＪンース・コードでのリスト
作成と関連する使用に特に適用し得る如きツールの提供
にある。

本発明の更に特定の目的は、全てのコード・ブロックか
ら各コード・ブロックおよび入れ子の関係を簡明かつ追
跡が容易な表示において目で識別するｒＣＪソース・コ
ード・リスト作成のための注釈ツールの提供にある。

（発明の要約） 要約すれば、本発明の上記および他の目的は、最初にタ
ブ付け文字として使用されるソース・コード言語におい
て小さな使用文字（チルデ「〜」の如き）を選択し、次
いで選択された文字の代わりにソース・コードに専用の
ストリングを置換することにより、処理されたｒＣＪソ
ース・コード・リストに集積された複数の入れ子ブロッ
ク間の関係の図式的な表示を行うためのプログラミング
・ツールにより達成される。次に、ブロックの初めの記
号「（」を含むコードの各行毎に、チルデおよび外に向
いた矢印（ハイフンの後に「大なり」不等記号を付すこ
とにより似せることができる）が付随される。同様に、
ブロックの終りの記号「）」を含むコードの各行毎に、
チルデと内に向いた矢印（「小なり」不等記号の後にハ
イフンを続けることにより似せること”６＜できる）が
付随される。チルデをタブ付け文字として用いて、内向
きおよび外向き矢印が縦方向に揃うようにタブ付けされ
る。次に、最初の行から部分的に処理されたソース・コ
ードを順次調べながら、外向き矢印を持つ行がある時は
深さの番号の増分を行い、内向き矢印を持つ与えられた
行がある時は次の行の初めの深さ番号の値に対して深さ
番号の減分を行うことにより、内向きまたは外向きの矢
印を持つ各行に対して「深さ番号」が生成される。この
深さ番号、ならびに１つ以上の（ある行に対する深さ番
号により示される如き）右揃えされた垂直線分が、外向
きあるいは内向きの矢印を持つ行に付随される。行間に
は、もしこれが外向きであれば最後の矢印付と同じ数の
垂直線分、またもしこれが内向きであれば最後の矢印線
より１つ少ない垂直線分が付される。次いで、水平線分
記号が、外向きあるいは内向きの矢印を持つある行内の
深さの番号と最も左側の垂直線分との間のスペースに入
れられる。望ましくは、見た目に良く見えかつ明瞭であ
るように、深さ番号と外向き矢印を持つ行にある最も左
側の垂直線分との間に入れられた水平記号はハイフン記
号であり、深さ番号と内向き矢印を持つ行の最も左側の
垂直線分との間に入れられた水平記号は下線記号である
。

本発明の主題は、特に本明細書の頭書において特に指摘
され明瞭に謳われている。しかし、本発明は、構成およ
び使用方法の双方に関して、頭書の特許請求の範囲およ
び添付図面に関して以降の記述を参照することによりよ
く理解することができよう。

（実施例） 第１図においては、簡単な例示のｒＣＪプログラムがソ
ース・コードでリストされる。基本的なことであるが、
このプログラムは、特にもしプログラムが他人により書
かれたり、検討者／プログラマがプログラムを書いた自
分の方法を忘れる程過去に書かれたならば、最初の検査
では全く追跡が容易でないように、いくつかのコード・
ブロックおよびい（つかの入れ子階層を使用している。

従って、プログラムのブロッカの発明に従って例示のプ
ログラムを処理することが望ましい。

プログラム・ブロッカの発明は、望ましい実施態様にお
いては、３パス構造を持ち、第２図は段階１のフローチ
ャートである。イ′ブロッカ・プログラムの初めに、ブ
ロッカされるべきｒＣＪプログラムの全てのパス名、即
ち記憶装置におけるその時の記憶場所に対して質問が提
起される。

ｒＣＪプログラムの作業コピーを（安全のため、読出し
専用モードのみ）取得して、その時のディレクトリ即ち
、本ブロッカ・プログラムが置かれるディレクトリにお
けるファイル「、ｒａｗｃ、Ｊに格納する。ファイル、
ｒａｗｃ。

は次にランダム・アクセス・メモリー（ＲＡＭ）にロー
ドされて実際の処理を開始し、メツセージ「フォーマッ
ト作業開始」が表示される。

「Ｃ」プログラム・ソース・コードの各行が次々に検査
される。もしチルデ「〜」が１つ以上の事例に存在する
ならば、一義的な文字ストリング（チルデを表わすため
選定）が発生毎に置換される。このため、以下において
更に明らかになるようにブロッカ・プログラムの実行中
、チルデ自体を内部のタブ付け等に留保することを可能
にする。ｒＣＪプログラミングに習熟する者は、このチ
ルデがｒＣＪにおいてほとんど使用されない演算子の１
つであり、事例において前記理由のため選定されたこと
が理解されようが、本ブロッカ・プログラムにおける特
殊目的の要件に対して他のめったに使用されない演算子
を選定することもできる。

各行は、次に「Ｃ」の「ブロックの初め」を表示する記
号「（」の存在について検査される。

もし文字「（」が与えられた行内に存在するならば、タ
ブ付けされた外向きの矢印「〜−〉」（即ち、チルデの
後にハイフォンと「大なり」不等記号が続く）がこの行
に付随される。同様に、各行は次に「ブロックの終り」
を示す記号「）」の存在について調べられ、もし存在す
るならば、タブ付きの内向きの矢印ｒ〜＜−」（チルデ
の後に「小なり」不等記号とハイフォンが続く）がこの
行に付随される。従って、各チルデをタブ記号と解釈し
て、内向きおよび外向きの契印がその時の右側のマージ
ンに押し付けられて、右側に「ビーチ・ヘッド」を確立
する。

次に、「深さ番号」が、右側マージンにおける内向きお
よび外向きの矢印を持っ各線に付随される。このような
各線の深さ番号は、外向きの矢印「−〉」を持つ線に遭
遇する時深さ番号の増分を行うことにより、また内向き
の矢印「＜−」を持つ与えられた線に遭遇する時は次の
線の初めの深さ番号の値に対して深さ番号の減分を行う
ことにより得られる。このように、深さ番号は、全ての
コード・ブロックの初め、終りおよび入れ子の深さを表
示するのに役立つ。

段取り機能として、この時不要なチルデが削除される。

（しかし、選択された一義的なストリングがそのままの
位置にあるため、チルデはブロッカ・プログラムにおい
て使用されるため使用可能状態を維持することが判るで
あろう。）この時メツセージ「矢印が所定位置にある」
が表示され、ブロッカ・プログラムの段階２に入ること
ができる。

第３図においては、各線に対して、ブロッカ・グラフィ
ックの垂直部分を収容するに充分な「空白」が付され、
矢印の行には、深さ番号が表示すると同じ数の垂直線分
が付される。中間の行は、もし直前の矢印行が外向きの
矢印ならばその矢印行と同じ数の垂直線分が付され、あ
るいはもし内向きの矢印ならばその矢印行より１つ少な
い垂直線分が付される。現在望ましい実施態様において
は、隣接する垂直線が美的あるいは明瞭化の目的のため
空白によって分離されることが望ましい。例えば、（７
段の深さの入れ子および矢印と垂直線間に少なくとも２
つのスペースが最大限度とすれば）もし「−ン６」を持
つ線が見出されるとすると、４つのスペースと６つの水
平方向に間隔をおいた垂直線（１つのスペースを介在さ
せることにより分離される）が付される。直後の続く線
が矢印を付されない場合は、これもまた４つのスペース
と６つの水平方向に間隔をおいた垂直線が付される。し
かし、もし次の行が「く−５」のエントリを有するなら
ば、６つのスペースと５つの水平方向に間隔をおいた垂
直線が付される。このように、ソース・コードの各線と
関連を有する垂直線のグループがこのような操作により
指向されて、これらが右側で揃えられるように付され、
これにより垂直線分が垂直方向に揃えられるようにする
ことは重要である。このプロセスにおいて、同じ行で始
まり終わるブロックは無視される。更に、縦のグラフィ
ックの領域に伸びるソース・コードの異常に長い線の場
合は、人の［１がこのような長い線に「沿って」グラフ
ィックの縦の流れに容易に従い得るため、垂直線は入れ
られない。

この時、メツセージ「縦線が引かれた」が表示され、再
び不要なチルデが除かれ、ブロッカ・プログラムの段階
３に入る。段階３の目的は、第４図から明らかなように
、ブロッカ・グラフィックの水平方向成分を置くことで
ある。このタスクは、収容される入れ子の深さ（望まし
い本実施態様においては７段）の２倍に等しい充分な数
の大域置換バスを用いることにより容易に行われる。最
初の一連の大域バスにおいて、ハイフン記号が各外向き
の矢印と最初の垂直線間でその右側に現れる各スペース
に置き換えられる。

次いで、第２の一連の大域パスが、各内向きの矢印と最
初の垂直線間でその右側に現れる各スペースを下線記号
即ち「−」で置換するように働（。（この目的のための
下線記号の選択は、単に外観をよくして明瞭にするため
である。）次いでメツセージ「水平成分終了」が表示さ
れ、ブロックされたソース・コードが再びファイル「、
ｒａｗｃＪに格納され、その旨のメツセージ（「出力が
、ＲＡＷＣで待機中」）が表示される。

第１図に示される事例のｒＣＪソース・プログラムがこ
の時第５図に示されるようにブロッキング・グラフィッ
クを所定位置において見ることができる。当業者は、本
ブロッカ・ツールによるリスト表示の処理が獲得した明
瞭性ならびに判り易さにおける劇的な改善を直ちに認め
るられよう。また、第５図を検討することにより、なぜ
垂直線が実際に右揃えされる、即ち、ある深さで与えら
れたブロックがより大きな番号を付したブロックの右側
およびより小さな番号を付したブロックの左側に繰り込
み、深さ番号１を持つブロックが最も右側の位置の垂直
線を持つようにするかが明らかになるであろう。このよ
うな構成は、［ＣＪ言語のプログラマが直感的にコード
・ブロックの関係に従うよう形成しようとする「心証」
に従おうとする傾向を有する。

以上のように、本発明の原理が実施例において明瞭にな
ったが、当業者には、かかる原理から逸脱することなく
特定の理境ならびに使用要件に特に適応される本発明の
実施に際して使用されるプログラム構造および構成の多
くの変更が容易に明瞭となろう。

【図面の簡単な説明】

第１図は通常見られる如き例示的な簡単な「Ｃ」ソース
・コード・リスト、第２図は本ブロッカ・プログラムの
第１段階における第１図の「Ｃ」プログラムの処理シー
ケンスを示すフローチャート、第３図は本ブロッカ・プ
ログラムの第２段階における第１図のｒＣＪプログラム
の処理シーケンスを示すフローチャート、第４図は本ブ
ロッカ・プログラムの第３段階における第１図の「Ｃ」
プログラムの処理シーケンスを示すフローチャート、お
よび第５図は探索後のコード・ブロックの識別および入
れ子の注釈を提供する本ブロッカ・プログラムにより処
理された後の第１図のｒＣＪプログラムのリスト作業を
示す図Ｍｉｎ□ ＦＩＧ、　１ ＦＩＧ、　５ ３つ＃＊＃ｌ劃Ｍ！側→９ Φ ３つ一丙、ＲＷ１２２開慢９ 會 ！ ７、ｋＡｗらをシードし、井ｎｔめ１１ｕ門へψ 同じ線上で間如７４７シソク１搬イ危 ψ ＦＩＧ、　３ φ ＲｆｔＪへ速Ｌ゛

Claims (1)

1. 【特許請求の範囲】 １、処理されたソース・コード・リストに統合される複
   数の入れ子にされたブロック間の関係の図形的表示を行
   うプログラミング・ツールにおいて、 Ａ）処理されないソース・コード・リストを取得し、 Ｂ）タブ付け記号として使用されるソース・コード言語
   における文字を選択し、 Ｃ）ステップＢ）において選択された文字をソース・コ
   ードにおける専用ストリングで置換し、 Ｄ）「ブロックの初め」の文字を含むソース・コードの
   各行毎に、ステップＢ）において選択された如きタブ付
   け文字および外向きの矢印を付し、 Ｅ）ブロックの終りの文字を含むソース・コードの各行
   毎に、ステップＢ）において選択された如きタブ付け文
   字および内向きの矢印を付し、Ｆ）外向きおよび内向き
   の矢印を縦方向に整合するようタブ付けし、 Ｇ）最初の行から部分的に処理されたソース・コードを
   順次調べる間、内向きあるいは外向きの矢印を持つ各行
   毎に、 １）外向きの矢印を持つ行に遭遇する時は、深さ番号の
   増分を行い、 ２）内向きの矢印を持つ与えられた行に 遭遇する時は、次の行の初めの深さ番号値に対する深さ
   番号の減分を行うことにより、「深さ番号」を生成し、 Ｈ）ステップＨ）において得た深さ番号を外向きあるい
   は内向きの矢印を持つ行に付し、 Ｉ）外向きあるいは内向きの矢印を持つ各行毎に、この
   行に対する深さ番号により表わされる数の垂直線分を付
   し、 Ｊ）矢印を付した行の間の、行毎に １）もし外向きの矢印を持つ行に続くならば、前記の矢
   印を付した行と同じ数の垂直線分を付し、 ２）もし内向きの矢印を持つ行に続くならば、前記の矢
   印を付した行の垂直線分の数より１つ少ない数の垂直線
   分を付し、 Ｋ）全ての垂直線分を右側に揃え、 Ｌ）外向きあるいは内向きの矢印を持つ各行毎に、深さ
   番号と最も左側の垂直線分との間のスペースに水平線分
   文字を入れる ステップを実行することを特徴とするプログラミング・
   ツール。 ２、ステップＬ）において、 Ａ）前記深さ番号と外向きの矢印を持つ行における最も
   左側の垂直線分との間に入れられた水平方向文字がハイ
   フン記号であり、 Ｂ）前記深さ番号と内向きの矢印を持つ行における最も
   左側の垂直線分との間に入れらえた水平方向文字が下線
   記号であることを特徴とする請求項１記載のプログラミ
   ング・ツール。 ３、処理された「Ｃ」言語ソース・コード・リストに統
   合される複数の入れ子にされた ブロック間の関係の図形的表示を行うプログラミング・
   ツールにおいて、 Ａ）処理されないソース・コード・リストを取得し、 Ｂ）タブ付け記号として使用されるソース・コード言語
   における文字を選択し、 Ｃ）ステップＢ）において選択された文字をソース・コ
   ードにおける専用ストリングで 置換し、 Ｄ）「（」記号を含むソース・コードの各行毎に、ステ
   ップＢ）において選択された如きタブ付け文字および外
   向きの矢印を付し、 Ｅ）「）」を含むソース・コードの各行毎に、ステップ
   Ｂ）において選択された如きタブ付け文字および内向き
   の矢印を付し、 Ｆ）外向きおよび内向きの矢印を縦方向に整合するよう
   タブ付けし、 Ｇ）最初の行から部分的に処理されたソース・コードを
   順次調べる間、内向きあるいは外向きの矢印を持つ各行
   毎に、 １）外向きの矢印を持つ行に遭遇する時は、深さ番号の
   増分を行い、 ２）内向きの矢印を持つ与えられた行に遭遇する時は、
   次の行の初めの深さ番号値に対する深さ番号の減分を行
   うことにより、「深さ番号」を生成し、 Ｈ）ステップＨ）において得た深さ番号を外向きあるい
   は内向きの矢印を持つ行に付し、 Ｉ）外向きあるいは内向きの矢印を持つ各行毎に、この
   行に対する深さ番号により表わされる数の垂直線分を付
   し、 Ｊ）矢印を付した行の間の行毎に、 １）もし外向きの矢印を持つ行に続くならば、前記の矢
   印を付した行と同じ数の垂直線分を付し、 ２）もし内向きの矢印を持つ行に続くならば、前記の矢
   印を付した行の垂直線分の数より１つ少ない数の垂直線
   分を付し、 Ｋ）全ての垂直線分を右側に揃え、 Ｌ）外向きあるいは内向きの矢印を持つ各行毎に、深さ
   番号と最も左側の垂直線分との間のスペースに水平線分
   文字を入れる ステップを実行することを特徴とするプログラミング・
   ツール。 ４、Ａ）ステップＢ）において選択された文字がチルデ
   「〜」であり、 Ｂ）前記外向きの矢印が、文字「大なり」が続くハイフ
   ン記号により似せられ、 Ｃ）前記内向きの矢印が、ハイフン記号が続く文字「小
   なり」により似せられることを特徴とする請求項３記載
   のプログラミング・ツール。 ５、ステップＬ）において、 Ａ）前記深さ番号と外向きの矢印を持つ行における最も
   左側の垂直線分との間に入れられる水平方向の文字がハ
   イフン記号であり、 Ｂ）前記深さ番号と内向きの矢印を持つ行における最も
   左側の垂直線分との間に入れられる水平方向の文字が下
   線記号であることを特徴とする請求項４記載のプログラ
   ミング・ツール。