VZ変数・オプション・スイッチ関連覚書

起動後は常駐フラグとなる

v1.6以降は汎用ユーザ変数wに変更

DOS 5.0ではBf32ではcommand.comも動かないため，Bf64を指定する必要がある。

テキストバッファ(Bt)の指定サイズの128倍の値で指定する。したがって最大値は8192。

Blのサイズを超える論理行を編集しようとしても，「ラインバッファがいっぱいです」とメッセージを表示して編集が続けられない。この場合は一旦編集を止め，適当なところに改行を挿入して論理行を分割し，編集終了後に置換機能を利用して改行を削除すればよい。

また，マクロの組込み時にBlのサイズによる制限も生じる。Bl+256バイト以上のサイズのマクロを組み込もうとすると，ラインバッファに続くテキスト領域(MCB)を破壊してメモリアロケーションエラーを起こす。

参照： Bt

32KBを越えて確保すると，モジュールメニューのフリー表示が負数になってキモチ悪いが実害はない。

確保できる値を越えて指定したり，インクルード（起動時組込：* E その他 の3番への記述）するマクロが多いとメモリ不足として起動できなくなる。この場合はコマンドラインで少なめの数値(0でもよい)を指定して起動し，該当部分を書き換えればよい。

C:\>VZ -bm0[CR]

なお，製品版初期値の8192の指定は，ラインバッファが8000hのアドレスのメモリをまたぐ可能性が高く，再カスタマイズに失敗するなどの不具合を起こしやすいことが知られており，20000〜30000位の値を指定するのが安全で，かつロードしておけるマクロを増やすことができる。

EMSメモリを使えないフロッピーディスクユーザーのためのオプション。

テンポラリファイルは，通常は環境変数TMPで定義された指定ドライブ・指定ディレクトリに作成すべきもので，メインメモリ上やEMS上に作成するような指定は特殊なケースであると言える。

外部記憶装置が大容量かつ安価になり，v1.6(評価版としてはv1.58a)で廃止された。

テキストバッファを大きく取るとメモリの消費量も増える。HP200LXのシステムマネージャからコールするような場合，最小値にしないと起動できないことがある。

Buで確保するバッファの先頭はpu(ユーザーバッファ)が指すマクロ用配列領域であるが，sp(マクロスタックポインタ)が指す末尾からもプッシュ・ポップで使用する。初期値の64はマクロを多用しない初級者用最小値と考えられ，128〜256に増やしておくことが推奨されている。

参照： pu

1を指定すると，EMSメモリの残りページを全部割り当てる。

0は割り当てず，他の数値は割り当てページ数を指定。

指定した場合はEMよりも優先して使用されるメモリ領域で，コンソールバッファ，スクリーン退避バッファ，ディレクトリバッファとして使用された。

他のアプリケーションから使われる可能性のある不安定な領域であるため，v1.60(評価版としてはv1.58a)で廃止された。

paが先頭を指す領域(アプリケーションヒストリーバッファ)のサイズを指定する。

VZの機能からは使用されていないため，一時的なバッファのすり替え先に使われることが多い領域だが，すり替え元のバッファとサイズを合わせる必要はない。

参照： pa

pfが先頭を指す領域(ファイル名ヒストリーバッファ)のサイズを指定する。

参照： pf

prが先頭を指す領域(ヒストリーバッファ)のサイズを指定する。

参照： pr

psが先頭を指す領域(ヒストリーバッファ)のサイズを指定する。

参照： ps

pwが先頭を指す領域(ヒストリーバッファ)のサイズを指定する。

参照： pw

pxが先頭を指す領域(ヒストリーバッファ)のサイズを指定する。

参照： px

pが先頭を指す領域(ヒストリーバッファ)のサイズを指定する。

参照： pt

オープン可能なテキストの数だけテキスト構造体(サイズは228バイト)が起動時に確保されるため，変更後に再起動を要する。

参照項目： WA WB WO WF

0を指定するとその環境での最大値が設定されるため，V-TEXT環境では -WD0 と起動バッチに記述しておけばよい。

参照項目： We vp..13

スクロール中に対応する数字キーで変更可能

テキストのオープン後はht(編集テキストのタブ桁数)で変更する。

参照項目： HT

「*E その他」セクションの第3項に先頭大文字で指定した拡張子に適用

値の設定例はCiを参照のこと

0ならカーソル位置基準で浮動，他の値は次表によるXとYの和になる

XあるいはYのみ指定したときは，指定のない軸はカーソル位置基準で浮動する

各制御文字に割り当てられたビットを立てることによって，通常はAcの属性で表示される制御文字(の代替文字)をAeの属性で表示することができる。初期値は52(4+16+32)で，タブ文字・右マージン・全角スペースの属性が他の制御文字と異なる設定になっている。実際にこれらの代替文字が表示されるためには，各表示スイッチを有効にすることが必要。なお，不正なコードとは漢字等多バイト文字の片割れであることが多い。

単位は約1/60秒で0なら確認しない

高橋版で改善（RM0で再取得失敗に対応）

非公開ではないがマニュアル類(mac16.docにも)から抜けている

kVZ仕様変更

tVZでは初期値(-)でマーカー(*)を表示する。kVZではコードの節約のため初期値に特定のキャラクタを与えずに，具体的に指定を行う仕様に変更された。初期値のままでは表示されないことに注意。

tVZにも移植されている

選択直後の動作をks(シフトキーフラグ)で分岐させることができるが，メニューで特殊キー\[CR]の戻り値を得られなくなるという副作用がある。

このオプションを使用せずに選択直後の分岐を行うには次のような手段がある。

• シフトキーを押しながらショートカットで選択しks&1を評価
• ^Mで選択しks&4(NEC-98はks&16)を評価

互換性のため，通常はマクロ中で変更して使用することが推奨されている

先頭にピリオド('.')のあるファイル名の場合は正常な動作を保証されていない

dVZで先頭にピリオドのあるファイル名にも対応した

マクロ実行中はキー入力がないため，HP200LXではライトスリープが発効してマクロの実行速度が極端に低下することへの対策

原案は成岡知彦氏(絶対アドレス0040:00D6のライトスリープ禁止フラグの制御を実現したDoping.def)

konno K07j

HP200LXの「すだれ」対策で画面左側を1〜2文字分空ける

!OPENイベント等で Ls32, 127, '■', $8140, 等と指定

表示色は AL(行番号の表示属性)と同じ

カーソルがずれる時は &d(再表示)等で正常になる

Konno K07

ファンクションキーラベル行を解放して，編集画面を1行増やす。

kVZ

メッセージ行の表示位置を制御する。

kVZ

日本語の表示をEUC-JPでエンコードする（通常はシフトJIS）

表示のみ対応し編集不可

kVZ

ファイラーの表示速度を上げるために空き容量を計算しない。Free表示は常に0になる。主にHP200LXで100MBを超える大容量フラッシュメモリーを使用する場合に有効にすると，ファイラーの表示速度が劇的に改善する。

また，1以上の設定時はBIT値でファイル選択時のクラスタサイズを指定する。

原案はFHPPCのらん氏(USOFREE.EXE)

【kVZ/廃止】

編集モード以外でもステータスラインに時刻を表示する(SLは廃止→OT廃止に伴いSL更改)

表示色は AL(行番号の表示属性)と同じ

※入力待ち開始から時刻表示するまでのループ回数指定を兼ねる

参照： SL

【kVZ/廃止→更改】

旧仕様（スイッチ）

参照： OT

【注】：高橋版は時刻表示固定で，メモリのフリーエリアを表示しない．

kVZ

ファンクションキー消去・行数指定モード

主にシグマリオン2等で使用

DOSの行数情報を操作しているため物理的な画面行数を越えてはならない

kVZ

FreeDOS NEC-98版で編集画面でのカーソルキー，[CTRL]+ファンクションキー等が使用可能になる(漢字は入力できなくなる)

FWの値を超える数のファイル，サブ・ディレクトリのあるディレクトリは，すべてを表示させることができない。取得できないファイル情報がある場合は，「 *********** (Out of Buf) *******(略)」とファイラー下部に表示され，ファイル数の表示は取得できたファイル情報分の数になる。

複窓ファイラーは双方のファイル数を足した数以上の値が必要で，例えば FW2048 の設定で1300個のファイルがあるディレクトリを複窓ファイラーで同時に表示しようとすると，先に表示した側は1300，後から表示した側は748を示す。

情報の取得からもれたファイルは存在していないという扱いになり，ファイラーで複写や削除等の操作もできない。

※高橋版で長いファイル名を表示する場合は，FV1で上下分割の複窓になる

値はビットフラグを立てるための加算値になっているが，例えばFS12などと矛盾する値にしてもいずれかひとつが有効になる。

また，値を与えると64のビットが立つ振る舞いをする。

ソートメニューにおいては，選択可能項目はひとつに制限されている。

値はビットフラグを立てるための加算値になっているが，通常は「新・古・大・小」のいずれかに「存在」を加える。比較メニューでは複数選択が可能だが，対になっている項目を両方選択しても所期の動作は保証されない。

kVZ仕様変更

Konno k07t3
8.3の短いファイル名もLFNとしてリネームする．
ステータスラインのファイル名もLFNを表示文字数の範囲でそのまま表示する．
Dp+では紛らわしいので，Rf+のときはDp-を推奨．

Konno k07k

ファイラーの行数を数値分減らして下部を空ける

ビュワーマクロ等で使用可能

Konno k07r

非常駐のコマンドラインで空[Enter]を抑止してcommand.comに制御を移さない

原案：おうら

Konno k07r

Konno k07r

上位：システムモード
下位：シフト段数？

※高橋版では残メモリ量の代わりに時刻表示になっている

アンダーライン(NEC-98)／網掛け風(IBM-PC)

Konno K07j

コマンドラインのファンクションキーラベル行を解放して表示行数を増やす。

コマンド#21にアサインされたキー(通常は[TAB]と^I)でタブ桁数分(次のタブ停止位置まで)の半角スペースが出力される。

コマンド関数&#V()/&#68で指定桁位置までスペースを出力するときなどに，タブコードと空白が混在しないようにEuを一時有効にするという利用の仕方が一般的。

例：　#> Eu[+, &#V(50) Eu], #>

参照： #21 &#V()/&68()

タイトルサーチを有効にするスイッチ：+:有効, -:無効

参照： mp ts

文字列入力窓でモードメニューマクロ（製品版は \[F01]）から呼び出される4番(VWX常駐時は5番)メニュー「検索オプション」により変更できる。

文字列入力窓でモードメニューマクロ（製品版は \[F01]）から呼び出される4番(VWX常駐時は5番)メニュー「検索オプション」により変更できる。

参照： Ei

上書きモード形式を従来の文字対応かv1.6で導入された桁対応か選択

参照： mi

コマンド#mで改行したときに行末に余分な半角スペースやタブがあれば自動的に削除する。

Ei(オートインデント)有効の場合に，字下げ位置までのスペース類だけの空行は残る。

ROを有効にすると，以後オープンするファイルはすべてビューモードになり，一切編集はできなくなる。

ビューモードとリードオンリーモードは異なることに注意。詳細はmr(テキスト修正フラグ)の項を参照のこと。

ビューモードでオープンした編集ファイルを通常の編集モードに変更するには，コマンド#67(リードオンリーモード)を実行する。

一旦通常の編集モードに切り替えたファイルをビューモードに戻すには，オープンし直すか，mr(テキスト修正フラグ)に128を代入する必要があり，ビューモードに切り替えるコマンドはない。

参照： mr #67

VWX常駐時のみ意味をもつ。

正規表現モードでなくても，「\x 」を検索文字列に前置することで正規表現を利用した検索は行える。

文字列入力窓でモードメニューマクロ（製品版は \[F01]）から呼び出される5番メニュー「検索オプション」により変更できる。

VWX常駐時のみ意味をもつ。

正規表現モードでなくても，「\z 」を検索文字列に前置することで全半同一視検索は行える。

文字列入力窓でモードメニューマクロ（製品版は \[F01]）から呼び出される5番メニュー「検索オプション」により変更できる。

ZHを有効にした状態では， \l(0Ah) を \n(0D0Ah) に置換することができない。

DOSコマンド実行結果をコンソールファイルに取り込む。

コンソールファイルはコマンド#X(DOS画面出力の参照)により，テキスト番号0の編集ファイルとして参照できる。

コンソールファイルは独自のテキストワークwoを持っておりtc(オープン可能なテキスト数)には含まれないので，常に参照可能である。

Sxを無効にしてもテキストワークwoは確保され，228バイトの領域は消費する。また，Sxが有効であっても，Bo(コンソール出力バッファのサイズ)に0を指定するとコンソールの出力は取り込まれない。

参照： Bo wo #X #95

sVZにあったスイッチのdVZへの移植

参照項目： &z() &Zd() &Zx()

dVZで追加されたマクロデバッグ用スイッチ

参照項目： &Za()

太田亘一氏のFM版から移植

裏テキストのステータスラインはYs,Yo,Yr,Ypを使用する

VZから使用されないバッファであるため，他のバッファを汚さないために「すり替え用バッファ」として頻繁に使用される。したがって保存バッファとしては使用できない。

内部ワークエリア

pv: コマンドテーブルポインタ

#< などの短縮記号からコマンド番号へ変換するテーブルへのポインタ

テーブルの並びは'<'から始まる文字に対応するコマンド番号が格納されている(3Ch〜7Ahの63バイト)

pv+ 0  <=>?@ABC DEFGHIJK LMNOPQRS TUVWXYZ[
pv+32  \]^_`abc defghijk lmnopqrs tuvwxyz

マクロで参照するワークエリアはここにある

ポインタ演算等で使用する

起動時はスタックセグメントを指している

64KBのサイズがあるが，大きなブロックが出し入れされると細かなブロックは掃き出されるため，サイズを有効に使えない場合もある。

関連項目： EX UX

kz:kpでテキストスタックの最新の文字列の末尾を指す

コマンド#51により初期化されるが，kpの指すアドレスを0000hに移動するだけなので，文字列そのものは残っている

マクロでテキストスタックを初期化する場合は，コマンド関数 &#51()を使用する

※高橋版で正確な数値になるよう改善されている

ksはあくまでも参照時の値を示すだけなので，起動時のksの状態を実行過程で反映させるには，変数に保存しなければならない。

例： k=ks&1, … (k)?{ シフト起動処理 }?{ 通常起動処理 }

参照項目： Eo #v

waは表テキスト(現編集テキスト)のローカルワークで，現テキスト固有の編集情報を格納する構造体の先頭を指す。カーソル位置情報などの編集テキスト変数に反映される情報に直接アクセスすることも可能。

参照項目： WB WO WF テキストワーク

wbは裏テキストのローカルワークで，裏テキスト固有の編集情報を格納する構造体の先頭を指す。表テキスト編集状態から，裏テキスト固有の各種情報に直接アクセスすることも可能。

参照項目： WA WO WF テキストワーク

参照項目： WA WB WO テキストワーク

参照項目： WA WB WF テキストワーク

参照項目： テキストワーク

FH≠0 で Hidden，System属性のファイルを表示

「H <Hidden>」の選択マークはシステムメニュー5番の項目数に依存

Hiddenが10番目なら FH=1<<9(=512)

main.asmのCustomizing dataでは，GDATA hidden, dw, 0 ; FH

ビット数はword値で16，マスクアイテムをむやみに増やせるわけではない

マクロ中断時に初期化される

マクロ中断時に初期化される

モード型マクロ実行中にコールされたマクロで有効にされた場合は，そのマクロが終了しても初期化されないので，きちんとプッシュ・ポップすることを推奨する。

メニューや入力窓がどのモードで起動されたかを示す

複数の表示スイッチを一時的に変更したい時に使用する。例えば，一時的に編集テキスト表示エリアの制御文字や代替文字をすべて表示させたい場合，Dc,Dt,De,Djのビットを立てることになるので，Jdに2+4+8+32=46をビットOR（ビット毎の和）する。

例：　Jd[, Jd|=46, …処理… Jd],

参照：td

内部的にテキストの先頭にはCR/LFがあるため，ファイル先頭では2を示す。ただしViewモードでは不定となる。

「*E その他」セクション3番のテキスト拡張子の何番目かを示す。

ほとんど使われていないため，保存変数として使い回すマクロもある。

4/8/16など，べき乗値をとることができる。

その他の半端な数値を与えたとき，所期の動作は得られない。

例：a=id, …テキスト切替… &#T(-a)

テキスト番号wnは小さい番号のファイルが閉じられると順位が繰り上がるので，確実にテキストを切り替えたい場合はテキストIDを用いるのがよい。

サイレント中にkxの値を変更しておくと，任意の位置で再表示できる。

サイレント中に値を変更しておくと，再表示後のカーソル行位置を制御できる。

lyを保存しておき，再表示直前にkyに格納することで，マクロ起動時のカーソル位置の目線のまま再表示することができる。

we幅を越える長さの論理行において，何回目の折り返し行かを示す。

lx==0の位置にあるカーソルが真の行頭にあるか判定するときに利用できる。

16ビットに制限されるため，65535行を越えると0に戻る。

lx==0でも論理行頭と限らないことに注意。

行頭が0からなので，ステータスラインに表示されている値と異なることに注意。

テキスト構造体の「touch flag」（wa.3/Byte）を反映している。元の値がByte値なので下位バイトに納まる。tchf(0=nop,1=modified,-1=RO)

$80(128)を境界として，mr>$80は閲覧，mr<$80は通常モード。2〜127の値を与えられると，一旦ラインバッファから書き戻して修正フラグを立てるが，問い合わせなしにクローズする。

ステータスラインやシステムメニューに表示されるファイル名の前の数字。通常ファイルをオープンした順に番号が振られる。

システム関数&#63()/&#T()の引数として当該ファイルに切り替えることができるが，若い番号のファイルが閉じられると番号が繰り上がって変化するので，ファイルのオープン・クローズが発生する場面ではテキストIDを利用する方が確実。

参照： ID #63 / #T &#63() / &#T()

画面左右分割時はボーダーの位置で変化する

画面上下分割時はボーダーの位置で変化する

矩形ブロックで利用される

通常タイトルサーチに使用される文字列は「* E その他」7番に設定済みだが，バッファを確保して別途設定することができる。tsは設定した文字列の先頭アドレスを指し，終端がヌル(ASCIIZ)であればデータセグメントのどこを指していてもよい。マクロの中では「ts="string",」と指定するだけでよい。

例： (ne=='C'||ne=='H'||ne=='CP')?{ ts="/", qk="{}", }

専らオートセーブマクロで使用される。半角・全角とも1文字としてカウントされる

専ら!Openイベントで記述され，特定の拡張子のファイルでブロック内インデントの自動増減などに利用される。

例： (ne=='C'||ne=='H'||ne=='CP')?{ ts="/", qk="{}", }

※比較はオフセット値で行われるため，常に正しいというわけではない。64KBの敷居をまたぐ可能性がある時に正確な比較をするためには，カーソル位置のロングポインタ（マークで使用）を用いる必要がある。

nmはステータスバーに表示されるファイル名であり，カレントディレクトリからの相対パス名が入る。パスが長いと頭の方からカットされていく。編集モード以外では値が不定となるので，確実にパス名を取得したい場合は編集モード以外からも参照可能なwa+146の使用を推奨。

製品版添付のvz.defサンプルでは初期設定でDf（編集ファイル名をフルパス名で表示）が無効になっている。この状態ではnmにフルパスが入る保証はない。

1 ^\ "" ?.
        #S #m           ;セーブしておくと nm が pr に入る
        df[-,           ;（こいつが曲者）
        #L &?(pr) #m    ;フルパスでオープンしても
        df],            ;（戻す）
        &m(nm)          ;nm はファイル名

参照： wa+146 wa..35 Df

通常は!Openイベントで拡張子毎の設定を行う。2バイトで評価する点に注意。

例：(ne=='DE')?{ ts"*=", td62, qk"{}", } ; .DEF ファイルの設定

!Openイベントで拡張子ごとの設定をするときに便利。

例：(ne=='DE')?{ ts"*=", td62, qk"{}", } ;62=2+4+8+16+32

未使用なので閉じた環境でなら便利に使いまわせるかもしれない。

※起動時は常駐用コマンドラインオプションとして使われる

常駐VZがcommand.comにフリーエリアの開始セグメントを強制的に教え込むため，command.comを書き換えるポインタ。ポインタのセグメントは常駐command.comのセグメント。(dc15#03869_1997/01/07,Hiro)

v1.5x時代にあったサイレントフラグ(ss)がバイトデータになって移動した跡の空き。

[vzt:main.asm]
tbls    dw    offset cgroup:cmdtbl        ; tl..0
        dw    offset cgroup:le_table      ; tl..1
        dw    offset cgroup:tb_sysmacjmp  ; tl..2
        dw    offset cgroup:tb_e2macjmp   ; tl..3
        dw    offset cgroup:tb_e2mac1     ; tl..4
        dw    offset cgroup:tb_xkey       ; tl..5
        dw    offset cgroup:tb_xkeycvt    ; tl..6
IFDEF MG
        dw    offset cgroup:mg_tone+1     ; tl..7
ELSE
        dw    0
ENDIF
        dw    offset cgroup:seektext      ; tl..8
        dw    offset cgroup:nexttext      ; tl..9
        dw    offset cgroup:pretext       ; tl..10
        dw    offset cgroup:readexpr0     ; tl..11
        dw    offset cgroup:sprintf       ; tl..12