home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 2001 June / VPR0106A.BIN / OLS / JED194V / JEDDOC.LZH / JEDMAC.DOC < prev    next >
Text File  |  1996-09-21  |  30KB  |  787 lines
  1.      [JED Macro programming guide]
  2.  
  3.    ******************************************************************
  4.   *                                                                  *
  5.  *                 ＪＥＤマクロプログラミングガイド                   *
  6.  *                       [98版]/[DOS/V版]共通                         *
  7.  *                        (JED Ver1.90以降)                           *
  8.  *                                                                    *
  9.  *                  Copyright (C) 1993-  H.Orikawa                    *
  10.   *                                                                  *
  11.    ******************************************************************
  12. 　　　　　　　　　　1993. 3.28　初版
  13. 　　　　　　　　　　     11.16　改訂
  14. 　　　　　　　　　　     12.15　改訂
  15. 　　　　　　　　　　1994. 7.28　誤記訂正
  16. 　　　　　　　　　　1996. 8. 7　一部改訂
  17. 　　　　　　　　　　      9.21　一部改訂
  18.  
  19.  
  20.  
  21.  
  22.  
  23. ■０．目次
  24. ----------------------------------------------------------------------
  25. 　　　１．はじめに
  26. 　　　　１－１　ＪＥＤとＶZ のマクロ
  27. 　　　　１－２　ＪＥＤのマクロの制限
  28.  
  29. 　　　２．文法説明
  30. 　　　　２－１　【演算子】
  31. 　　　　　２－１－１　優先順位
  32. 　　　　　２－１－２　単項演算子
  33. 　　　　　２－１－３　二項演算子
  34. 　　　　２－２　【制御コマンド】
  35. 　　　　　２－２－１　コマンド
  36. 　　　　　２－２－２　制御構文
  37.  
  38. 　　　３．機能説明
  39. 　　　　３－１　【変数】
  40. 　　　　　３－１－１　内部変数
  41. 　　　　　３－１－２　システム変数
  42. 　　　　３－２　【関数】
  43. 　　　　　３－２－１　標準関数
  44. 　　　　　３－２－２　システム関数
  45. 　　　　　３－２－３　コマンド関数
  46.  
  47. 　　　４．補足
  48.  
  49. 　　　５．おわりに
  50. ----------------------------------------------------------------------
  51.  
  52.  
  53.  
  54. ■１．はじめに
  55.  
  56. 　ＪＥＤのマクロは条件分岐、ループ制御機能を持ったプログラム実行が可能
  57. な構造化マクロで、その基本的な仕様はＶZ(*)のマクロに準じています。
  58. 　但し、プログラム実行に最低限必要な機能に絞ってあるため、ＶZ に完全準
  59. 拠ではありません。そのためＶZ 用のマクロをそのまま実行しようとしてもま
  60. ず動作しませんので、あらかじめご了承願います。
  61. 　解凍ファイルに含まれているサンプルマクロには、できるだけ詳しいコメン
  62. トを付けてありますので、本マニュアルと照らし合わせながらご覧になること
  63. をおすすめします。
  64.  
  65.  
  66. □　１－１　ＪＥＤとＶZ のマクロ
  67.  
  68. 　ＪＥＤとＶZ のマクロの違いはそのマクロ定義書式にあります。
  69.  
  70. 　（例）
  71. 　　　 　　　　ＶZ 　　　　　|　　　　ＪＥＤ
  72. 　　 　----------------------+----------------------
  73. 　　 　　* M マクロ　　　　　|　　←不要
  74. 　　 　　  (プログラム部分)　|　　(プログラム部分)
  75. 　　 　　* 　　　　　　　　　|　　←不要
  76.  
  77. 　ＶZ では一つのXXX.DEF 形式のファイルにカスタマイズデータやマクロデー
  78. タを混在記述できるため、各データの識別のために[*] で始まるヘッダ、フッ
  79. タ部分を付けることになっています。
  80. 　しかしＪＥＤではマクロファイルは独立した物になっているので、そのよう
  81. なヘッダ、フッタは不要です（というか、付いていると誤動作します）。
  82.  
  83.  
  84. □　１－２　ＪＥＤのマクロの制限
  85.  
  86. 　ＪＥＤのマクロの欠点として、ＪＥＤでは一つのマクロファイルに複数のマ
  87. クロを定義できないことがあげられます。ＶZ のようにポップアップメニュー
  88. を開けて、その中から必要なマクロを実行させるといったことができません。
  89. 　ただし添付の"TEXTFORM.MCR"のように、ポップアップメニューからサブルー
  90. チンコールの形でローカルマクロを呼び出す、といった手法はあります。
  91.  
  92.  
  93. 　(*)ＶZ は（株）Village Centerの市販エディタです。
  94.  
  95.  
  96.  
  97. ■２．文法説明
  98.  
  99. 　　　　ここではマクロに使用する演算子やコマンドの基本的な仕様について
  100. 　　　説明します。
  101.  
  102. □　２－１　【演算子】
  103.  
  104. 　　　　演算子は書式、優先順位とも基本的にＣ言語の仕様に準じています。
  105. 　　　以下ではＣ言語の仕様と異なる部分を中心に説明します。
  106. 　　　　以下の説明の中で「変数」とは、２バイト(１６ビット)の符号付き整
  107. 　　　数を格納した変数を意味します。
  108.  
  109. ○　　２－１－１　優先順位
  110.  
  111. 　　　　演算子の優先順位は下表の通りです。従って、
  112. 　　　　　　a = 3 - 2 * 5 + 1,
  113. 　　　の a の計算結果は(6)ではなく(-6)となります。しかし、この例のよう
  114. 　　　な簡単な場合は別として、正確を期するためには
  115. 　　　　　　a = 3 - (2 * 5) + 1,
  116. 　　　のように括弧を用いて優先順位を明示した方が無難でしょう。
  117. 　　　（括弧は全ての演算子に優先するものとして式の評価を行います）
  118.  
  119. 　　　　　　|　（高）　←　優先順位　→　（低）　　　　演算の種類
  120. 　　　------+--------------------------------------+-----------------
  121. 　　　　　　| (1)  ++  --  ~   !   !!  +  -             単項演算
  122. 　　　（高）| 
  123. 　　　　　　| (2)  [   ]
  124. 　　　　　　| 
  125. 　　　　↑　| (3)  .   ..                               ポインタ演算
  126. 　　　　　　| 
  127. 　　　　　　| (4)  *   /   %                            乗除算
  128. 　　　　優　| 
  129. 　　　　　　| (5)  +   -                                加減算
  130. 　　　　先　| 
  131. 　　　　　　| (6)  <<  >>                               ビットシフト
  132. 　　　　順　| 
  133. 　　　　　　| (7)  <   <=  >   >=                       比較演算
  134. 　　　　位　| 
  135. 　　　　　　| (8)  ==  !=
  136. 　　　　　　| 
  137. 　　　　↓　| (9)  &   ^   |                            ビット演算
  138. 　　　　　　| 
  139. 　　　　　　| (10) &&  ||                               論理演算
  140. 　　　（低）| 
  141. 　　　　　　| (11) =   *=  /=  %=  +=  -=  &=  ^=  |=   代入演算
  142.             | 
  143.  
  144. ○　　２－１－２　単項演算子
  145.  
  146. 　　　　これは１個の変数に対する演算で、結果はその変数に直ちに代入され
  147. 　　　ます。
  148.  
  149. 　　　a[　　　|　　変数a をスタックにプッシュ
  150. 　　　a]　　　|　　変数a をスタックからポップ
  151. 　　　　　　　|　　（注）スタックのネストは１０段まで
  152. 　　　　　　　|　　
  153. 　　　a++ 　　|　　変数a に　１を加算(a = a + 1, と同じ)
  154. 　　　a-- 　　|　　変数a から１を減算(a = a - 1, と同じ)
  155. 　　　　　　　|　　（注）Ｃのような前置記法(++a,--a)はない
  156. 　　　　　　　|　　
  157. 　　　a~　　　|　　変数a のビット反転
  158. 　　　a!　　　|　　変数a のＮＯＴ
  159. 　　　　　　　|　　　a == 0のとき1 、それ以外では0 を返す
  160. 　　　　　　　|　　（注）Ｃの記法(!a)とは異なる
  161. 　　　　　　　|　　
  162. 　　　a!! 　　|　　変数a の上・下位バイトを反転する
  163. 　　　　　　　|　　
  164. 　　　a+  　　|　　変数a に１を代入(a = 1 と同じ)
  165. 　　　　　　　|　　
  166. 　　　a-  　　|　　変数a に０を代入(a = 0 と同じ)
  167. 　　　　　　　|　　
  168.  
  169. ○　　２－１－３　二項演算子
  170.  
  171. 　　　　これは２個の変数に対する演算で、結果は内部レジスタに、また代入
  172. 　　　演算の場合はさらに左辺の変数に格納されます。
  173. 　　　(*) 内部レジスタ....右辺値計算結果の格納や条件分岐、ループ制御時
  174. 　　　　　　　　　　　　　に参照される変数で、ユーザーはアクセスできな
  175. 　　　　　　　　　　　　　い。
  176.  
  177. 　　　a.ofs 　|　　a をポインタとしてofs バイト先のバイトデータを返す
  178. 　　　　　　　|　　（例）a = "12345", として、
  179. 　　　　　　　|　　　　　c = (a.2), は変数c に文字'3'の値(33h)を返す
  180. 　　　　　　　|　　
  181. 　　　a..ofs　|　　a をポインタとしてofs ワード先のワードデータを返す
  182. 　　　　　　　|　　（例）a = "あいうえお", として、
  183. 　　　　　　　|　　　　　c = (a..2), は変数c に文字'う'の値(A482h)を返
  184. 　　　　　　　|　　　　　す(シフトＪＩＳ漢字コードの上／下位が反転して
  185. 　　　　　　　|　　　　　いることに注意)
  186. 　　　　　　　|　　　　　実際の使用例は添付の"ZENHAN.MCR" を参照のこと
  187. 　　　　　　　|　　
  188.  
  189.  
  190. □　２－２　【制御コマンド】
  191.  
  192. ○　　２－２－１　コマンド
  193.  
  194. 　　　［記号の意味］
  195. 　　　　　A     ラベル名（半角英大文字 A ～ Z）
  196. 　　　　　nn    ローカルマクロ番号（２桁の数字。２桁に満たない場合は先
  197. 　　　　　　　　頭を0 で埋める(01,02など)）
  198. 　　　　　n     整数値
  199.  
  200. ◆　　ラベル ---------------------------------------------------------
  201. 　　　:A            ラベル（分岐命令の飛び先指定用）
  202. 　　　nn:           ラベル（ローカルマクロ、ポップアップメニュー用）
  203.  
  204. ◆　　関数呼び出し ---------------------------------------------------
  205. 　　　#nn           nn番の標準関数呼び出し
  206. 　　　              nnには予め定義済みの短縮文字も使用可（#d,#mなど）
  207. 　　　&nn           nn番のローカルマクロ呼び出し
  208. 　　　&a            システム関数呼び出し（３－２－２項参照）
  209.  
  210. ◆　　分岐（ジャンプ）命令 -------------------------------------------
  211. 　　　>A            ジャンプ（ＧＯＴＯ）
  212. 　　　>^            現在実行中のローカルマクロの先頭に戻る
  213. 　　　>>            次のマクロにジャンプ
  214. 　　　>+n, >-n      n 番目のマクロにジャンプ
  215.  
  216. ◆　　ポップアップメニュー -------------------------------------------
  217. 　　　!nn           nn番のポップアップメニューを呼び出す
  218.                     但し、内部的な呼び出し手順はローカルマクロに準じる
  219.                     ので、マクロ番号と重複しないこと
  220.                     結果は内部変数 [r] に格納される
  221.  
  222.                         r >  0  選択されたメニュー項目番号
  223.                         r = -1  [ESC]キーによりキャンセルされた場合
  224.  
  225.                     ［メニューの記述形式］
  226.  
  227.                      +- メニュー番号（コロン[:]が必ず必要）
  228.                      |      +- メニュータイトル（省略時は "" とする）
  229.                      |      |       +- メニューの幅
  230.                      |      |       |   +- 項目数
  231.                      |      |       |   |
  232.                     01: "タイトル", 20, 3
  233.                         "項目　１"
  234.                         "項目　２"
  235.                         "項目　３"
  236.                         .
  237.                         |
  238.                         +- ピリオド（必ず必要）
  239.  
  240.  
  241. ◆　　その他 ---------------------------------------------------------
  242. 　　　.             現在実行中のマクロ、ポップアップメニューから呼び出
  243. 　　　              し元に戻る
  244. 　　　/             マクロを終了させる
  245. 　　　'a'           文字a
  246. 　　　"string"      文字列string
  247. 　　　式,           「式」を評価、実行（最後に','(ｶﾝﾏ)を付けること）
  248.  
  249. （注）文字（列）中に[']["]及び[\]を入れる時は、[\]を用いて
  250. 　　　　　　'\''
  251. 　　　　　　"\'\""
  252. 　　　　　　'\\'
  253. 　　　などのように記述してください。
  254.  
  255.  
  256. ○　　２－２－２　制御構文
  257.  
  258. 　　　　以下の説明の中で「ブロック」とは、
  259. 　　　　　{ }、( )、' '、" "　で囲まれた式、文字、文字列等
  260. 　　　　　# 、& 　　　　　　　で始まる関数
  261. 　　　を指します。
  262.  
  263. ◆　　ループ制御（Ｃのwhile文 に相当） -------------------------------
  264. 　　　(式){ブロック}
  265. 　　　                      「式」の回数だけ「ブロック」を実行
  266. 　　　                      「式」が最初から 0 でも一度は実行する
  267. 　　　　　　　　　　　　　　「式」を -1 とすると無限ループとなる
  268. 　　　                       （例）(5){#d}      カーソル右移動を５回
  269.  
  270. ◆　　条件分岐　（Ｃのif文に相当） -----------------------------------
  271. 　　　(式)?{ブロック}
  272. 　　　                      「式」の結果が真（非0） の時ブロックを実行
  273.  
  274. 　　　(式)??{ブロック}
  275. 　　　                      「式」の結果が偽（0） の時ブロックを実行
  276.  
  277. 　　　(式)?{ブロック1}?{ブロック2}
  278. 　　　                      「式」の結果が真（非0）ならブロック1を
  279. 　　　                                    偽（0）  ならブロック2を実行
  280.  
  281. ◆　　多重分岐　（Ｃのswitch文に相当） -------------------------------
  282. 　　　(式)>?{ブロック, ...}
  283. 　　　                      「式」の値に対応したブロック内のコマンドを
  284. 　　　　　　　　　　　　　　実行
  285. 　　　　　　　　　　　　　　「式」が0 の時はスキップする
  286. 　　　                      （例）(n)>?{#d #s {#x #d}}
  287. 　　　　　　　　　　　　　　　　　n が1の時#d、2の時#s、3の時{#x #d}を
  288. 　　　　　　　　　　　　　　　　　実行
  289. 　　　　　　　　　　　　　　ブロック中で、引数をとる関数（&b(0)など）を
  290. 　　　　　　　　　　　　　　記述する場合は( )で囲って下さい。
  291. 　　　　　　　　　　　　　　（例）{ &b(0) a = 1 #m ..... }       ×
  292. 　　　　　　　　　　　　　　　　　{ (&b(0)) (a = 1) #m ..... }   ○
  293.  
  294.  
  295. （注）これら３つの構文は、ネストさせると期待した動作をしないことがあり
  296. 　　　ます。
  297.  
  298.  
  299.  
  300. ■３．機能説明
  301.  
  302. 　　　ここではマクロで使用可能な変数及び関数群について説明します。
  303.  
  304. □　３－１　【変数】
  305.  
  306. ○　　３－１－１　内部変数
  307.  
  308. 　　　　ユーザーが自由に使用できる変数で、変数名として
  309. 　　　　　[a]  ～ [z]
  310. 　　　　　[aa] ～ [zz]
  311. 　　　　　[fa] ～ [fd], [fx], [fy]
  312. 　　　の計５８個が使用できます。
  313. 　　　　このうち、[r] はシステム関数の戻り値格納用として使用されますの
  314. 　　　で、特別な理由がない限りこれに値を代入することは避けて下さい。
  315.  
  316.  
  317. ○　　３－１－２　システム変数
  318.  
  319. 　　　　システムがマクロコマンド実行後に値を設定する専用の変数で、以下
  320. 　　　の１７個が定義されています。
  321. 　　　　これらの変数はマクロプログラム側から参照できますが、ユーザーが
  322. 　　　設定することはできません。つまり、比較演算(==,<,など) だけが可能
  323. 　　　となっています(ここがＶZ と異なる点です)。
  324. 　　　　なおシステム変数は、参照される毎にその定義内容に従った値を算出
  325. 　　　するようになっています。
  326.  
  327. 　　　変数名　|　　　　　　　　内　容
  328. 　　----------+-----------------------------------------------------
  329. 　　　　ks　　|　　　シフトキー押し下げ状態
  330. 　　　　　　　|　　　下に示す８ビット数値について各キーに対応した
  331. 　　　　　　　|　　　ビットがたつ。
  332. 　　　　　　　|　　　[98版]
  333. 　　　　　　　|　　　(MSB)                                     (LSB)
  334. 　　　　　　　|　　　　7     6     5     4     3     2     1     0
  335. 　　　　　　　|　　　　-     -     -    CTRL  GRPH   ｶﾅ   CAPS SHIFT
  336. 　　　　　　　|　　　
  337. 　　　　　　　|　　　[DOS/V版]
  338. 　　　　　　　|　　　(MSB)                                     (LSB)
  339. 　　　　　　　|　　　　7     6     5     4     3     2     1     0
  340. 　　　　　　　|　　　　-     -     -     -    ALT   CTRL SHIFT SHIFT
  341. 　　　　　　　|　　　
  342. 　　　　　　　|　　　複数のキーが押された場合はそれらに対応するビッ
  343. 　　　　　　　|　　　トの論理和（ＯＲ）となる。
  344. 　　　　　　　|　　　（例）
  345. 　　　　　　　|　　　        [98版]           [DOS/V版]
  346. 　　　　　　　|　　　　0  =　(シフトキー類は押されていない)
  347. 　　　　　　　|　　　　1  =　[SHIFT]             --
  348. 　　　　　　　|　　　　2  =　[CAPS]              --
  349. 　　　　　　　|　　　　3  =　[CAPS]+[SHIFT]   [SHIFT]
  350. 　　　　　　　|　　　　4  =　[ｶﾅ]             [CTRL]
  351. 　　　　　　　|　　　　8  =　[GRPH]           [ALT]
  352. 　　　　　　　|　　　　12 =　[GRPH]+[ｶﾅ]      [ALT]+[CTRL]
  353. 　　　　　　　|　　　
  354. 　　　　cd　　|　　　カーソル位置の文字コード
  355. 　　　　　　　|　　　　0Dh(13) =　[CR]
  356. 　　　　　　　|　　　　0Ah(10) =　[EOF]
  357. 　　　　　　　|　　　　その他  =　文字コード
  358. 　　　　　　　|　　　
  359. 　　　　ck　　|　　　カーソル位置の文字種
  360. 　　　　　　　|　　　　0  =　半角(１バイト文字)
  361. 　　　　　　　|　　　　1  =　漢字(２バイト文字)
  362. 　　　　　　　|　　　
  363. 　　　　ct　　|　　　カーソル位置の文字タイプ
  364. 　　　　　　　|　　　　0  =　[EOF]
  365. 　　　　　　　|　　　　1  =　[CR]
  366. 　　　　　　　|　　　　2  =　半角／全角空白、制御記号
  367. 　　　　　　　|　　　　3  =　半角／全角記号
  368. 　　　　　　　|　　　　4  =　ひらがな
  369. 　　　　　　　|　　　　5  =　全角文字
  370. 　　　　　　　|　　　　6  =　半角文字
  371. 　　　　　　　|　　　
  372. 　　　　ht　　|　　　現編集テキストのタブカラム数
  373. 　　　　　　　|　　　
  374. 　　　　lh　　|　　　論理行先頭からのカーソルの相対Ｙ位置　(1～)
  375. 　　　　　　　|　　　（行折り返しのある場合）
  376. 　　　　　　　|　　　
  377. 　　　　ln　　|　　　カーソル位置の論理行番号　(1～)
  378. 　　　　　　　|　　　
  379. 　　　　lx　　|　　　カーソルのカラム位置　(0～)
  380. 　　　　　　　|　　　
  381. 　　　　ly　　|　　　カーソルのウィンドウ内Ｙ座標　(0～)
  382. 　　　　　　　|　　　
  383. 　　　　mi　　|　　　挿入／上書モード
  384. 　　　　　　　|　　　　0  =　挿入
  385. 　　　　　　　|　　　　1  =　上書き
  386. 　　　　　　　|　　　
  387. 　　　　mr　　|　　　テキスト修正フラグ
  388. 　　　　　　　|　　　　0  =　修正なし
  389. 　　　　　　　|　　　　1  =　　　あり
  390. 　　　　　　　|　　　
  391. 　　　　we　　|　　　現編集テキストの表示カラム数
  392. 　　　　　　　|　　　
  393. 　　　　wn　　|　　　現編集テキスト番号
  394. 　　　　　　　|　　　　0  =　クリップボード
  395. 　　　　　　　|　　　　1～ 　テキスト
  396. 　　　　　　　|　　　
  397. 　　　　wt　　|　　　画面分割モード
  398. 　　　　　　　|　　　　0  =　全画面
  399. 　　　　　　　|　　　　2  =　横分割の上側
  400. 　　　　　　　|　　　　3  =　　　　　下側
  401. 　　　　　　　|　　　　4  =　縦分割の左側
  402. 　　　　　　　|　　　　5  =　　　　　右側
  403. 　　　　　　　|　　　
  404. 　　　　wx　　|　　　ウィンドウ横幅(枠を含まない)
  405. 　　　　　　　|　　　
  406. 　　　　wy　　|　　　ウィンドウ縦幅(枠を含まない)
  407. 　　　　　　　|　　　
  408. 　　　　pc　　|　　　ＪＥＤ起動パス名へのポインタ
  409. 　　　　　　　|　　　
  410. 　　　　pi　　|　　　マクロ読み込みパス名へのポインタ
  411. 　　　　　　　|　　　　-m<ﾏｸﾛﾌｧｲﾙ名> をつけて起動した時のみ有効
  412. 　　　　　　　|　　　
  413. 　　　　pw　　|　　　入力文字バッファへのポインタ
  414. 　　　　　　　|　　　　後述のシステム関数 &g での入力結果が格納される
  415.  
  416.  
  417. □　３－２　【関数】
  418.  
  419. ○　　３－２－１　標準関数
  420.  
  421. 　　　　この関数は
  422. 　　　　　# + '２桁の数字'もしくは'英１文字'
  423. 　　　で表記され、ＪＥＤの編集機能の全てを実現できます。
  424. 　　　　詳細はＪＥＤマニュアル(JED.DOC)３－２項を参照して下さい。
  425.  
  426.  
  427. ○　　３－２－２　システム関数
  428.  
  429. 　　　　標準関数以外にマクロプログラム専用に用意された関数群です。
  430. 　　　　　& + '英小文字'
  431. 　　　で表記され、一部の関数では引数をとります。
  432.  
  433. 　　　引数表現の中では、
  434. 　　　"文字列"：半角６４文字以内
  435. 　　　　　　　　　p = "文字列",
  436. 　　　　　　　　として、p を代用しても良い
  437. 　　　　　　　　（この場合p は文字列へのポインタとなります）
  438. 　　　n 　　　：整数値、式または変数
  439. 　　　　　　　　１６進数値の場合は先頭に'$' 記号を付ける($1Bなど)
  440. 　　　　　　　　このときA ～F は必ず大文字で記述すること
  441. 　　　c 　　　：文字
  442.  
  443.  
  444. ----------------------------------------------------------------------
  445. ◆ &a("文字列") .................... Alarm with message
  446. ----------------------------------------------------------------------
  447. 　　　"文字列"で示されるメッセージを表示する
  448. 　　　入力されたキーに対応して内部変数[r] に下記の値が格納される
  449.  
  450. 　　　　　r = 1　　　　　[Y] キーが押された
  451. 　　　　　r = -1 　　　　[ESC] キーが押された
  452. 　　　　　r = 0　　　　　上記以外のキーが押された
  453.  
  454. 　　　（例）&a("なにかキーを押して下さい")
  455.  
  456.  
  457. ----------------------------------------------------------------------
  458. ◆ &b(n) ........................... Beep
  459. ----------------------------------------------------------------------
  460. 　　　n が0 以外のときビープ音を鳴らす
  461. 　　　（例）&b(1)     ;”ピー”と音がする
  462.  
  463.  
  464. ----------------------------------------------------------------------
  465. ◆ &c .............................. Console I/O
  466. ----------------------------------------------------------------------
  467. 　　　キーボードからの入力をそのまま出力する
  468. 　　　入力が文字以外の時はキー定義に従った機能を実行する
  469. 　　　入力されたコードは内部変数[r] に格納される
  470.  
  471. 　　　　　r <  $100(256)　文字コード
  472. 　　　　　r >= $100 　　　機能番号 + $100(256)
  473.  
  474. 　　　後出の&p &o(r)を続けて実行した場合と同じ動作である
  475.  
  476.  
  477. ----------------------------------------------------------------------
  478. ◆ &d .............................. Display
  479. ----------------------------------------------------------------------
  480. 　　　画面を強制的に再描画する（デフォルト）
  481. 　　　このコマンド実行後は機能終了毎に画面表示を行なう
  482. 　　　通常&sと組み合わせて使用する
  483.  
  484.  
  485. ----------------------------------------------------------------------
  486. ◆ &e("文字列") .................... Execute macro
  487. ----------------------------------------------------------------------
  488. 　　　"文字列"で示されるマクロを実行する
  489. 　　　但し、&c &p &l  といったコンソール入力を伴うシステム関数は不可
  490. 　　　（例）&e("#d#d#d")    ;カーソルを右に３つ移動
  491.  
  492.  
  493. ----------------------------------------------------------------------
  494. ◆ &f(c, "文字列") ................. Find
  495. ----------------------------------------------------------------------
  496. 　　　"文字列"の中からc と一致する文字を検索する
  497. 　　　結果は内部変数[r] に格納される
  498.  
  499. 　　　　　r >= 0　見つかった位置（"文字列"の先頭を０としたときのオフセ
  500. 　　　　　　　　　ット）
  501. 　　　　　r = -1　見つからない時
  502.  
  503. 　　　（例）&f('c', "abcdef")
  504. 　　　　　　&m("cは%d番目にありました", r)
  505.  
  506.  
  507. ----------------------------------------------------------------------
  508. ◆ &g("文字列") .................... Get string with message
  509. ----------------------------------------------------------------------
  510. 　　　"文字列"をタイトルに入力用ウィンドウを開く
  511. 　　　入力文字種に従って内部変数[r] に値が設定される
  512.  
  513. 　　　　　r = -1　　　　　[ESC] キーが押された
  514. 　　　　　r = -2　　　　　[CR]  キーが押された
  515. 　　　　　r = 0 　　　　　数字以外が入力された
  516. 　　　　　r = (上記以外)　入力数値
  517.  
  518. 　　　文字列はシステム変数pwに格納される
  519. 　　　（例）&g("文字を入力して！")
  520. 　　　　　　&m("文字は[%s]です", pw)
  521.  
  522.  
  523. ----------------------------------------------------------------------
  524. ◆ &h .............................. Hexadecimal
  525. ----------------------------------------------------------------------
  526. 　　　カーソル以降の１語を１６進数値とみなして、内部変数[r] に格納
  527. 　　　（例）&h
  528. 　　　　　　&m("数値は%xです", r)
  529.  
  530.  
  531. ----------------------------------------------------------------------
  532. ◆ &k .............................. Key input
  533. ----------------------------------------------------------------------
  534. 　　　ＤＯＳのファンクションコールを使って、コンソール入力を行なう
  535. 　　　キー入力待ちはしない
  536. 　　　入力コードは内部変数[r] に格納される
  537. 　　　（例）:A  &k                ;[ESC]が押されるまでループ
  538. 　　　　　　　　(r != $1B) ? >A
  539.  
  540.  
  541. ----------------------------------------------------------------------
  542. ◆ &l .............................. Line input
  543. ----------------------------------------------------------------------
  544. 　　　[CR]または[ESC]が入力されるまでキーボードからの入力を受付ける
  545. 　　　（例）&m("[CR]キーを押すまで入力します")
  546. 　　　　　　&l
  547. 　　　　　　&m("入力を終了しました          ")
  548.  
  549.  
  550. ----------------------------------------------------------------------
  551. ◆ &m("書式文字列"<,ﾊﾟﾗﾒｰﾀ,...>) ... Message
  552. ----------------------------------------------------------------------
  553. 　　　指定した書式に従って数値や文字列を画面左下隅に表示する
  554. 　　　パラメータの数は最大５個まで
  555. 　　　"書式文字列"に記述できる書式指定子はＣのprintf関数で使用するもの
  556. 　　　とほぼ同じで、
  557. 　　　　　%[-][n]  (nは整数値)
  558. 　　　の後に下記の記号を付加する
  559.  
  560. 　　　　　d   |    符号付き１０進数
  561. 　　　　　u   |    符号無し１０進数
  562. 　　　　　x   |    １６進数
  563. 　　　　　s   |    文字列
  564. 　　　　　c   |    文字
  565.  
  566. 　　　n はフィールド幅で、前に'-' を付けるとそのフィールド内で左詰めで
  567. 　　　表示する（'-' を指定しないときは右詰め）
  568. 　　　（例）&m("a=%5d",  123) ---> 実行結果は　a=__123
  569. 　　　　　　&m("a=%-5d", 123) ---> 実行結果は　a=123__
  570.  
  571. 　　　またn の前に'0' を付けると余白を'0' で埋める．
  572. 　　　（例）&m("a=%05d", 123) ---> 実行結果は　a=00123
  573.  
  574. 　　　'%' 自身を出力する場合は&m("%%") のように２つ続けて記述する
  575.  
  576.  
  577. ----------------------------------------------------------------------
  578. ◆ &?("文字列") .................... output string
  579. ----------------------------------------------------------------------
  580. 　　　文字列を現カーソル位置に出力する
  581. 　　　（例）p = "ABCXYZ",
  582. 　　　　　　&?(p)
  583.  
  584.  
  585. ----------------------------------------------------------------------
  586. ◆ &n .............................. Numeric
  587. ----------------------------------------------------------------------
  588. 　　　カーソル以降の１語を１０進数値とみなして、内部変数[r] に格納
  589. 　　　（例）&n
  590. 　　　　　　&m("数値は%dです", r)
  591.  
  592.  
  593. ----------------------------------------------------------------------
  594. ◆ &o(c) ........................... Output
  595. ----------------------------------------------------------------------
  596. 　　　引き数(c) の値に応じて文字出力または機能実行する
  597.  
  598. 　　　　　c <  $100(256)　文字コードとみなし文字を出力
  599. 　　　　　c >= $100 　　　機能番号 + $100(256)とみなし番号に対応した機
  600. 　　　　　　　　　　　　　能を実行
  601.  
  602. 　　　（例）&o('a')       ;文字'a' を出力
  603. 　　　　　　&o(256+12)    ;行末へジャンプ(機能番号#12を実行)
  604. 　　　　　　　または
  605. 　　　　　　&o($10C)
  606.  
  607.  
  608. ----------------------------------------------------------------------
  609. ◆ &p .............................. Pause
  610. ----------------------------------------------------------------------
  611. 　　　キーボードから１文字入力されるまで待つ
  612. 　　　入力された文字は内部変数[r] に格納される
  613. 　　　[r] に設定されるデータの意味については&cの項を参照のこと
  614. 　　　（例）&p                      ;キー入力を待ち
  615. 　　　　　　(r < $100) ? { &o(r) }  ;機能コード以外なら出力
  616.  
  617.  
  618. ----------------------------------------------------------------------
  619. ◆ &q .............................. Quit
  620. ----------------------------------------------------------------------
  621. 　　　現在実行中のローカルマクロ(*)を中断してメインループに戻る
  622. 　　　(*)ローカルマクロ：サブルーチンとして呼ばれたマクロ
  623.  
  624.  
  625. ----------------------------------------------------------------------
  626. ◆ &s .............................. Silent
  627. ----------------------------------------------------------------------
  628. 　　　画面表示及びカーソル表示を停止する
  629. 　　　マクロ実行中の画面のチラつきを防ぐために使用する
  630. 　　　&dが実行されるまで継続する
  631.  
  632.  
  633. ----------------------------------------------------------------------
  634. ◆ &t .............................. Trace
  635. ----------------------------------------------------------------------
  636. 　　　マクロを１ステップずつ実行する（マクロのデバッグに使用）
  637. 　　　次に&tに出会うか、[CR]キーが押されるまで継続される
  638. 　　　現在のマクロ実行位置を画面右下に表示する
  639. 　　　次のステップに進むときは[CR]以外のキーを押す
  640.  
  641.  
  642. ----------------------------------------------------------------------
  643. ◆ &u(c) ........................... change to Upper character
  644. ----------------------------------------------------------------------
  645. 　　　文字c が英小文字の場合にこれを大文字に変換し、内部変数[r] に返す
  646. 　　　（例）&u('a')
  647. 　　　　　　&m("aの大文字は%cです", r)
  648.  
  649.  
  650. ----------------------------------------------------------------------
  651. ◆ &v(n) ........................... cursor View
  652. ----------------------------------------------------------------------
  653. 　　　カーソル表示制御
  654. 　　　　n = 0　表示オフ
  655. 　　　　    1　表示オン
  656.  
  657.  
  658. ----------------------------------------------------------------------
  659. ◆ &x(n) ........................... cursor location X
  660. ----------------------------------------------------------------------
  661. 　　　ウィンドウの左端を0 としてカーソルをn の位置に移動する
  662. 　　　（注）行末以降には移動しない
  663.  
  664.  
  665. ----------------------------------------------------------------------
  666. ◆ &y(n) ........................... cursor location Y
  667. ----------------------------------------------------------------------
  668. 　　　ウィンドウの上端を0 としてカーソルをn の位置に移動する
  669. 　　　（注）最終行（ＥＯＦ行）以降には移動しない
  670.  
  671.  
  672. ----------------------------------------------------------------------
  673. ◆ &z(n) ........................... FEP control
  674. ----------------------------------------------------------------------
  675. 　　　FEP制御
  676. 　　　　n = 0　FEP オフ
  677. 　　　　    1　FEP オン
  678. 　　　　   -1　FEP 状態取得
  679. 　　　実行後、内部変数[r] には
  680. 　　　　n = 0/1 の時、直前の FEP状態（0 = OFF, 1 = ON）
  681. 　　　　    -1  の時、現在の FEP状態
  682. 　　　が格納される
  683.  
  684.  
  685.  
  686. ○　　３－２－３　コマンド関数
  687.  
  688. 　　　　標準関数以外にマクロプログラム専用に用意された関数群です
  689. 　　　　　& + # + '数字' or '英小文字' + (引数)
  690. 　　　で表記されます
  691.  
  692. ----------------------------------------------------------------------
  693. ◆ &#r(n) .......................... scroll up
  694. ----------------------------------------------------------------------
  695. 　　　引数 n の行数分だけ文頭方向にスクロールする
  696. 　　　（注）文頭以前には移動しない
  697.  
  698.  
  699. ----------------------------------------------------------------------
  700. ◆ &#c(n) .......................... scroll down
  701. ----------------------------------------------------------------------
  702. 　　　引数 n の行数分だけ文末方向にスクロールする
  703. 　　　（注）文末以降には移動しない
  704.  
  705.  
  706. ----------------------------------------------------------------------
  707. ◆ &#J(n) .......................... Jump
  708. ----------------------------------------------------------------------
  709. 　　　引数 n で示される行番号にジャンプする
  710. 　　　（注）n が現テキストの最大行数を越える場合は最終行にジャンプ
  711.  
  712.  
  713. ----------------------------------------------------------------------
  714. ◆ &#T(n) .......................... change Text
  715. ----------------------------------------------------------------------
  716. 　　　引数 n 番のテキストに移動する
  717. 　　　n = 0 の時はクリップボード
  718.  
  719.  
  720. ----------------------------------------------------------------------
  721. ◆ &#Y(n) .......................... split type
  722. ----------------------------------------------------------------------
  723. 　　　引数 n に応じて画面分割形式を変更する
  724. 　　　n = 0 : 全画面
  725. 　　　　　2 : 上下分割
  726. 　　　　　4 : 左右分割
  727.  
  728.  
  729. ----------------------------------------------------------------------
  730. ◆ D(n) ......................... output space
  731. ----------------------------------------------------------------------
  732. 　　　現カーソル位置から n カラムまでスペース（半角空白）を出力する
  733. 　　　（注）n がカーソル位置より小さい時は何もしない(n = 0～)
  734.  
  735.  
  736.  
  737. ■４．補足
  738.  
  739. 　　・実際のマクロ作成に際しては、同梱の下記サンプルマクロを参考にして
  740. 　　　下さい。
  741. 　　　　　AUTOKETA.MCR    自動桁折り
  742. 　　　　　BLOCK   .MCR    矩形ブロック編集
  743. 　　　　　CSCONV  .MCR    英大文字、小文字相互変換
  744. 　　　　　GAME    .MCR    テトリスもどきゲーム
  745. 　　　　　KEISEN  .MCR    簡易罫線描画
  746. 　　　　　OUTLINEJ.MCR    アウトライン作成用
  747. 　　　　　OUTLINET.MCR    同上、インデント対応版
  748. 　　　　　TABSPC  .MCR    タブ←→空白変換
  749. 　　　　　TEXTFORM.MCR    文書整形支援
  750. 　　　　　ZENHAN  .MCR    全角半角相互変換
  751. 　　　　　PAD     .MCR    ＰＡＤファイル作成　（中井正博氏　作）
  752. 　　　　　PRT     .MCR    ＰＲＴ＋＋用文字装飾（　　　同　　　）
  753. 　　　　　REFORM  .MCR    段落整形（T.Tanomura氏　原作、Ari-P氏　作）
  754.  
  755. 　　・マクロバッファサイズは約５ＫＢで固定です。
  756.  
  757. 　　・^OR     マクロの読み込み
  758. 　　　^\      マクロの実行
  759.  
  760. 　　　　　　　なお、マクロの第１行目に
  761. 　　　　　　　　　?.
  762. 　　　　　　　を記述することで、２回目に^\が押された時に実行中のマクロ
  763. 　　　　　　　を終了させることができます。
  764.  
  765. 　　・マクロ実行中にループに入ってしまった時（暴走ともいう）は、
  766.  
  767. 　　　　　　[CTRL]+[GRPH]/[ALT]（場合によっては　+[任意のキー]）
  768.  
  769. 　　　　を押すことで大抵の場合強制終了させられます。それでもダメな時は
  770. 　　　　残念ですがリセットボタンを押す準備をして下さい。
  771.  
  772.  
  773.  
  774. ■５．おわりに
  775.  
  776. 　　　　本マニュアルではＪＥＤのマクロの基本的な機能を説明しました。実
  777. 　　　際のプログラミングについての詳細は市販のＶZ エディタのマクロ解説
  778. 　　　本が参考になると思います(^^)。
  779.  
  780. 　　　　マクロに関して不明の点がありましたら、下記まで連絡下さい。私に
  781. 　　　わかる範囲で(^^;) 説明いたします。
  782.  
  783. 　　　ＮＩＦＴＹ－Ｓｅｒｖｅ
  784. 　　　　　　　ＦＧＡＬＤＣ　１０番会議室（エディタ・ワープロ）
  785.  
  786. 　　　ＭＨＧ０００１７　折川（ｏｒｉｋ）浩
  787.