第III部〜秀丸マクロのいろはにほへと 秀丸マクロで文字列を編集する

Hidemaru Editor

Hidemaru Q and A

第III部〜秀丸マクロのいろはにほへと
 秀丸マクロで文字列を編集する


●秀丸マクロで文字列を編集する

ここでは、秀丸マクロで文字列を編集するときによく使うコマンドの基本的な解説と、 実際にコマンドを使う上でいくつか注意すべき点をまとめました。
秀丸マクロで文字列を編集するには、大きく分けて、秀丸エディタウィンドウ上でカーソル移動したり範囲選択したり、 直接文字列を挿入したりして処理する方法と、文字列変数に取り込んで変数の中で処理する方法があります。 それらの処理を行うにあたって、範囲選択の方法や、文字列変数に取り込む方法、2バイト文字の扱いなどについて主に説明します。

【1】改行を挿入するには(insertreturn; とinsert “\n”;)
【2】カーソル位置の文字が何かを知るには(code, unicodeキーワード)
【3】任意の座標にある文字が何かを判断するには(moveto,カーソル移動系コマンド)
【4】範囲選択するには
【5】範囲選択を解除するには
【6】文字列型変数に取り込むには:その1(gettext文)
【7】範囲選択されているかどうか判断するには(selectingキーワード)
【8】文字列型変数に取り込むには:その2(クリップボード経由)
【9】変数内の文字が何かを知るには(ascii関数)
【10】文字列中の先頭以外の文字が1バイト文字か2バイト文字かを区別するには(midstr文等への注意事項)

【1】改行を挿入するには(insertreturn; とinsert “\n”;)

秀丸マクロで改行を挿入するには、どうすればよいでしょうか?。

その名もずばり、insertreturnという命令があります。
insertreturn文は、「改行キーを押したのと全く同じ働き」をします。
秀丸エディタヘルプの「挿入系文」にも説明されているように、insertreturn文は現在のモードが上書きモードか挿入モードかによって動作が異なります。
上書きモードの場合、「動作環境」-「編集」-「高度な編集1」の「上書きモード時のリターン」の設定によって動作が変わります。 「カーソル移動する」が選択されていると、改行は挿入されず、カーソルが次行行頭に移動します。
また「ファイルタイプ別の設定」-「体裁」-「インデント」の、自動インデントに関する設定に従った動作を行います。

「改行キーを押したのと全く同じ働き」をさせたい場合は、insertreturn文が便利ですが、 上書きモードでも挿入モードでも必ず改行を挿入したい場合はどうするのが良いでしょうか?。
insert文で改行文字を挿入するのが簡単です。

(例) 改行を挿入するには

insert "\n";

 または

insert "\x0a";

または、上書きモードの時、一旦、挿入モードに変えて、insertreturnしてまた上書きモードに戻してあげる方法もあります。
この場合、インデントの設定に従った動作を行います。

if(overwrite){
    overwriteswitch;
    insertreturn;
    overwriteswitch;
} else {
    insertreturn;
}

【2】カーソル位置の文字が何かを知るには(code, unicodeキーワード)

現在のカーソル位置にある文字が、1バイト文字か、2バイト文字かを調べるにはどうすれば良いでしょうか?。

codeというキーワードがあります。
codeキーワードは、カーソル位置の文字コードを表します。
このキーワードは2バイト文字に対応しており、2バイト文字の場合は2バイトのコード(Shift_JIS)を返します。 例えば全角空白の場合は0x8140になります。
カーソル位置の文字のunicodeを取得したい場合には、unicodeキーワードを使用します。

  • codeキーワードは、編集中のテキストのエンコードに関係なく、Shift_JISの文字コードを返します。 その為、Shift_JISに含まれない文字の場合は、「0」を返します。

(例)現在のカーソル位置にある文字が、1バイト文字か、2バイト文字かをメッセージボックスで表示する

if (code > 0xff) {
    message "2バイト文字です";
} else {
    message "1バイト文字です";
}

秀丸マクロの数値型は4バイトであり、0x8000以降も正の値となるので、上記の書き方でOKです。

(例) または、以下でもOK

if (code && 0xff00 != 0) {
    message "2バイト文字です";
} else {
    message "1バイト文字です";
}

ここで他の特殊文字の例も見ましょう。

(例) 改行文字を判定する

if (code == 0x0d) {
    message "改行文字です";
}

以下の書き方では改行文字と判定できません。insert文で改行を挿入する場合との違いに注意しましょう。

if (code == 0x0a) {
if (code == '\n') {
if (code == ascii("\n")) {
if (code == ascii("\r")) { // これもなぜか ascii("\r") == 10 となり駄目

※秀丸マクロでは、\rも 0x0a として処理されます。

(例) 文末を判定する
eofキーワードが文末を示します。

if (code == eof) {
    message "文末です";
}

(例) タブ文字の判定

if (code == 0x09) {
    message "タブ文字です";
}

【3】任意の座標にある文字が何かを判断するには(moveto,カーソル移動系コマンド)

任意の座標にある文字が何かを判断するにはどうすれば良いでしょうか。
簡単な方法としては、カーソル移動系コマンドのmovetoでカーソルを移動してから、codeキーワードを使います。

ここで疑問が出てきます。movetoで2バイト文字の真ん中の座標に移動するとどうなるでしょうか?。
答え:2バイト文字の先頭にカーソルが移動します。

逆に、上記の性質を使うと、movetoで指定した座標値と、実際に移動した先の座標値(キーワードx と yで取得出来る)を比較することで、 その座標にある文字が、1バイト文字か、2バイト文字の1バイト目か2バイト目かを区別することができます。

  • movetolineno文の場合、移動指定先が、2 バイトコードの 2バイト目に来る場合、2バイト目の最後、 すなわち次の文字の先頭にカーソルが移動します。

  • タブ文字の上に移動する場合も、2バイト文字と同様の動作になります。
    動作環境」-「高度なカーソル」の「タブ文字の上のカーソル移動した時」の設定は、moveto,movetolineno 文の動作には影響しません。

【4】範囲選択するには

後で文字列変数に取り込んだり、秀丸エディタの編集系コマンド(例えば、tohankakuなど)を使ったりする場合には、範囲選択されている必要があります。
秀丸マクロで範囲選択するにはいくつかの方法があります。

  • beginselと、その後にrightmoveto等のカーソル移動系文を使う
  • selectlineselectwordなどのクリップボード系文を使う
  • 検索系文を使って検索する
    動作環境」-「検索」-「検索の動作」-「検索での表示」で、「範囲選択」が選択されている必要があります。
    ちなみに、この選択状態は、searchmodeキーワードで知ることができます。

「検索系文を使って検索する」の補足説明

現状(Ver.4.10以降)では、「動作環境」-「検索」-「検索の動作」-「検索での表示」が「点滅表示」でも取り込む事は可能です。

foundtopx、foundtopy、foundendx、foundendy キーワードが追加され、それぞれに検索にマッチした座標がセットされます。 検索にマッチした事を確認して、foundtopx、foundtopy、foundendx、foundendy キーワードを使い、gettext文で文字変数に取り込む事が可能です。

また、「setcompatiblemode文」が追加され(Ver.6.00以降)、マクロ内で一時的に「検索での表示」の動作を切り替える事も、 可能になっています。その為、「動作環境」に関係なく使用したい「検索での表示」の設定で、マクロを実行する事が可能になっています。

【5】範囲選択を解除するには

範囲選択を解除するにはescape文を使用します。
例えばマクロ文で選択を行う場合、既に範囲選択されていると不都合がある場合があります。そのようなときに利用できます。
ちなみにbeginsel等で範囲選択モードになっているときに範囲選択モードを解除する(選択範囲は残す)場合に使うのはendsel文です。

endsel使用時の注意点

選択モードを終了しても範囲選択状態でカーソル移動コマンドを使うと、移動した場所まで範囲選択状態になります。 (範囲選択が広がってしまう。)

確認用マクロ

//新規ファイル作成
newfile;
//ファイルに内容を追加
gofiletop;
#cnt = 1;
while(5 > #cnt){
    insert "123456789";
    insertreturn;
    #cnt = #cnt + 1;
}
//ファイルの先頭に移動
gofiletop;
//範囲選択開始
beginsel;
moveto x + 3, y;
//範囲選択モード解除
endsel;
message "範囲選択終了";
//範囲選択モードを解除したはずなのに移動したカーソル位置まで選択される。
moveto x + 3, y + 3;
message "カーソル移動";
endmacro;

範囲選択終了時 カーソル移動終了時

動作的にはおかしいが、現状(2016/05/11)においては仕様ということです。 範囲選択状態から、検索を使用し、見つけた位置まで範囲選択を伸ばす事も可能になっているので、 カーソル移動コマンドの使用時は範囲選択を維持しているとの事。
(カーソル移動コマンドとは、moveto、movetolineno goline〜のコマンドです。)

範囲選択した後の操作(コマンド?)で範囲選択が解除されれば問題はないが、 解除されない場合はカーソル移動を行うと思わぬ結果になるので注意すること。

この動作を回避するには、範囲選択終了後に、一度カーソルを動かせばいい。(left、right等)

【6】文字列型変数に取り込むには:その1(gettext文,gettext2文)

ユーザーの操作または上記のマクロ文で範囲選択した後、その選択された文字列を文字列型変数に取り込むにはどうすれば良いでしょうか。

典型的には、以下のようなコーディングを見ることが多くなるでしょう。

$s = gettext(seltopx,seltopy,selendx,selendy);

秀丸マクロでは、範囲選択された文字列を直接文字変数に取り込むマクロ文は有りません。 画面上の任意の範囲の文字列を文字変数に取り込むgettext文と、 現在の選択範囲の座標値を示すseltopxselendyキーワード(範囲選択関連キーワード)を併用します。 (秀丸エディタVer5.00以降は、座標系がカラム位置、エディタ的に計算した行番号になっているgettext2文と、 seltopcolumnseltoplinenoselendcolumnselendlineno キーワードが追加されています。)

但し注意が必要なのは、seltopx〜selendyキーワードに値が入っているといって、 その値どおり範囲選択されているとは限らないことです。
マクロヘルプの「範囲選択関連キーワード」の説明にもあるように、 範囲選択が解除された後も、以前の値を保持しているためです。
ということは、上記のコーディングで文字列型変数に取得する場合は、 その前に、現在本当に範囲選択されているかを確認する必要があります。

gettext文は実行すると範囲選択を解除する仕様でしたが、秀丸エディタVer5.00 より第5引数が追加され 範囲選択を解除するかどうかの設定が可能になってます。(gettext2文も同じ仕様です。)

  • 第5引数に 0 を設定した場合は範囲選択を解除します。
  • 第5引数に 1 を設定した場合は範囲選択を保持します。

第5引数を省略した場合は、0 を設定したと同じ状態になります。

//範囲選択を解除する場合
$s = gettext(seltopx,seltopy,selendx,selendy, 0);
//範囲選択を解除しない場合
$s = gettext(seltopx,seltopy,selendx,selendy, 1);

【7】範囲選択されているかどうか判断するには(selectingキーワード)

秀丸マクロから、現在範囲選択されているかどうか判断するには、selectingキーワードを使います。

(例) 範囲選択された場所を文字列変数に取得する

if(selecting) {
    $s = gettext(seltopx,seltopy,selendx,selendy);
    message "選択範囲は、" + $s + "です";
} else {
    message "範囲選択されていません";
}

範囲選択中か示すキーワードは他にもあります。 状況に応じて使い分けてください。

rectselecting
BOX範囲選択中かどうかを表します。範囲選択中の場合は1、そうでない場合は0です。
lineselecting
行選択開始コマンドによる選択中かどうかを表します。(Ver.8.00以降)
selectionlock
選択開始/BOX選択開始/行選択開始コマンドによる選択中かどうかを表します。(Ver.8.00以降)
mouseselecting
マウスによる選択中かどうかと、その選択方法を表します。(Ver.8.00以降) 0:マウスによる選択ではない
1:文字単位の選択
2:単語単位の選択
3:行単位(折り返しまで)の選択
4:行単位(改行まで)の選択
multiselecting
複数選択中であるかどうかを表します。(Ver.8.40以降)

【8】文字列型変数に取り込むには:その2(クリップボード経由)

クリップボードを経由して行う方法もあります。大まかには、以下の流れになります。

  1. あらかじめ範囲選択する
  2. cutで切り取り、またはcopyでコピーする
  3. beginclipboardread文で、クリップボードからの読み込み開始を宣言する
  4. getclipboard文で、クリップボードから1行(改行文字で区切られた範囲)を読み込む。

使い方の詳細は、秀丸マクロヘルプの「クリップボードと変数のやりとり」を参照してください。

gettext文とクリップボード系文との利点と弱点を比べて、自分が行う処理に合ったものを使いましょう。

  • クリップボードを使うということは、マクロで処理した文字列がクリップボードに残ってしまうことを意味します。 (クリップボード履歴を使用している時は、履歴に保存されてしまいます。)
    gettext文はクリップボードを消費しません。

  • BOX範囲選択された範囲を文字列変数に取り込む場合は、クリップボードを使うのが簡単です。

【9】変数内の文字が何かを知るには(ascii関数)

変数内の文字のコードを調べるために、ascii関数が用意されています。これは引数として与えた文字列の最初の文字のコードを返します。

秀丸エディタ Ver.8β6 より、ascii関数の仕様が変更され、1バイトだけの場合は、マルチバイト文字の上位バイト範囲内でも、 そのまま文字コードを返します。 2バイト以上で、Shift_JIS範囲内の場合は、Shift_JISコードを返します。

ascii関数で判定するため、midstr文などで切り出す場合は、2文字以上切り出すのが良いでしょう。

実験マクロ

debuginfo 1;
$test = "01234567";
##len = strlen($test);
##cnt = 0;
while(##cnt < ##len){
   $$check = midstr($test, ##cnt, 1);
   debuginfo "check = " + $$check + " hex = " + hex(ascii($$check)) + "\n";
   ##cnt = ##cnt  + 1;
}
endmacro;

実行結果

check = 0 hex = 30
check = 1 hex = 31
check = 2 hex = 32
check = ・hex = 8200
check = R hex = 52
check = ・hex = 8200
check = S hex = 53
check = ・hex = 8200
check = T hex = 54
check = 6 hex = 36
check = ・hex = 8200
check = V hex = 56

実行結果(Ver.8β6以降)

check = 0 hex = 30
check = 1 hex = 31
check = 2 hex = 32
check = ・hex = 82
check = R hex = 52
check = ・hex = 82
check = S hex = 53
check = ・hex = 82
check = T hex = 54
check = 6 hex = 36
check = ・hex = 82
check = V hex = 56

実験マクロ その2

debuginfo 1;
$test = "01234567";
##len = strlen($test);
##cnt = 0;
while(##cnt < ##len){
   $$check = midstr($test, ##cnt, 2);
   debuginfo "check = " + $$check + " hex = " + hex(ascii($$check)) + "\n";
   ##cnt = ##cnt  + 1;
}
endmacro;

実行結果

check = 01 hex = 30
check = 12 hex = 31
check = 2・hex = 32
check = 3 hex = 8252
check = R・hex = 52
check = 4 hex = 8253
check = S・hex = 53
check = 5 hex = 8254
check = T6 hex = 54
check = 6・hex = 36
check = 7 hex = 8256
check = V  hex = 56

以下の内容は古いバージョンが対象になります。


変数内の文字のコードを調べるために、ascii関数が用意されています。これは引数として与えた文字列の最初の文字のコードを返します。 また2バイト文字を引数に与えられていると、2バイトのコードが返る便利な関数ですが、逆にそれゆえの落とし穴もあります。
ascii関数を2バイト文字に対して適用した場合、2バイト分をまとめて16bit整数として返す、という仕様ですが、 以下のようにわざと2バイト文字の1バイト目(コード=0x??)を切り出した(1文字からなる)文字列に適用すると、 なんと0x??00という値が返ってきます!

$a = midstr("あ", 0, 1); // 2バイト文字の1バイト目を切り出す\
message str(ascii($a)); // == 33280 == 0x8200 が返る

というわけで、2バイト文字の1バイト目かどうかを判断するのに

if (ascii(midstr($s, #i, 1)) & 0x80) {
    // 2バイト文字の1バイト目か、半角カタカナだった
    
}

というようなかっこいい(笑)コードはNGです。
ascii文の仕様からすると、midstr文などで切り出す場合は、2文字切り出すのが良いです。 (1文字目が1バイト文字でも次の文字はascii文は無視してくれます。)
というわけで、以下の例のようにしましょう。

if (ascii(midstr($s, #i, 2)) >  0xff) {
    // 2バイト文字
    
}

または

if (ascii(midstr($s, #i, 2)) && 0xff00 != 0) {
    // 2バイト文字
    
}

【10】文字列中の先頭以外の文字が1バイト文字か2バイト文字かを区別するには(midstr関数等への注意事項)

前項で、midstr関数を使って、なにげなく文字列変数の中から一部を切り出しましたが、実はこれらの文はmoveto文等とは違って、 切り出す範囲の先頭が、2バイト文字の2バイト目かどうかは判断してくれません。
何も考えずにmidstr等を使うと、切り出した結果の文字列の先頭が2バイト文字の2バイト目だった場合、 別の1バイト文字に化けたり、ゴミになったり(表示させると半角の中点になる)していまいます。

秀丸エディタ ver.8より、文字列を、文字単位で扱う関数群が追加されています。(正確には、文字列をUTF-16LEで扱う関数群) wcsmidstr関数を使用し、文字単位で切り出しコードを確認すれば、2バイト文字の判定は可能です。

また、切り出す範囲の先頭の1バイト分の文字コードだけを見て、そこが2バイト文字の2バイト目かどうかは、一意に決められません。
秀丸エディタに限らず一般にShift_JISのコード体系では、「2バイト文字の2バイト目」になり得るコードの中には、 「2バイト文字の1バイト目」になり得るものが有るためです。

(例) 以下の例では、2バイト文字の2バイト目から始まる2バイトを、別の2バイト文字と誤判断してしまいます。
※例示のため、機種依存文字を使用しています。ご容赦ください。m(_ _)m

$s = "これは�";
message char(ascii(midstr($s, 6, 2))); // �が表示される
$s = "1回一括�";
message char(ascii(midstr($s, 6, 2))); // �が表示される!!
//("括"==0x8a87、"�"==0x8741、"�"==0x8787)

“�”は0x8787と、1バイト目と2バイト目が同じ値で、いかにも意地悪な例ではありますが、各バイト値だけでは判断できないことがわかると思います。

では、文字列中の任意の位置の文字が1バイト文字か2バイト文字かを区別するには、どうすればよいのでしょうか。
実現方法はいくつか考えられますが、文字列の先頭から順番に確認していくのが基本です。
一例としては、[HMM0074A] ●文字列の後方から文字列を検索 を参照してください。

目次に戻る