001myarghelper.txt

1 myarghelper.exe の目的

1. まず、最初に、実行ファイルがあるディレクトリと同じディレクトリに、
     基幹部分の名前 + "For" +  %COMPUTERNAME% + ".ahp"
   
   という名前のファイルがないかを探します。
   myarghelper.exe を hoge.exe という名前で複写した場合で、 COMPUTERNAME が KUMANO の場合、
     "hoge" + "For" + "KUMANO" + ".ahp" -> hogeForKUMANO.ahp
   
   です。
   この形のファイルがあれば、それが「設定ファイル」として採用されます。
   hogeForYODO.ahp があっても、%COMPUTERNAME% が KUMANO であるマシンでは、hogeForYODO.ahp は「設定ファイル」とは考えられません。

2. 前項で述べたように %COMPUTERNAME% が含まれる形の名前の「設定ファイル」がない場合は、
     基幹部分の名前 + ".ahp"
   
   というファイルがないかを探します。
   myarghelper.exe を hoge.exe という名前で複写した場合は、
     hoge.ahp
   
   です。そういう名前のファイルがあれば、それを「設定ファイル」として採用します。

3. 基幹部分の名前 + ".ahp" の形の名前のファイルもない場合は、「設定ファイル」がないということになります。
   「設定ファイル」がないと、エラーメッセージを表示する窓がポップアップします。その窓の OK ボタンを押せば、なにもせずにプログラムは終了します。

4. hoge.exe (myarghelper.exe をコピーしたファイル) は、上述したルールにしたがって、設定ファイルを選択し、それを読み込みます。
   設定ファイルの一行目に書いてあるコマンドに、設定ファイルの二行目に書いてある引数と、hoge.exe を実行するときに渡された引数を加えて実行します。
   例えば、hoge.exe の設定ファイルの一行目に
     C:¥home¥shiiba¥bin¥foo.exe
   
   と書いてあって、hoge.exe の設定ファイルの二行目に
     C:¥script¥bar.uws
   
   と書いてあり、hoge.exe の実行時に、Hello, world. という引数を与えると、
     C:¥home¥shiiba¥bin¥foo.exe C:¥script¥bar.uws Hello, world. 
   
   が実行されます。

5. 設定ファイルの一行目に、絶対パスではなくて、相対パスを使って実行するコマンドを書くことができます。
   例えば、hoge.exe の設定ファイルの一行目に
     C:¥home¥shiiba¥bin¥foo.exe
   
   のように書いてあるのではなくて、
     .¥foo.exe
   
   のように相対パスで書いてあった場合は、hoge.exe (myarghelper.exe をコピーしたファイル）は、.¥foo.exe の . を hoge.exe が置かれているディレクトリと解釈します。
   従って、hoge.exe が c:¥home¥tak¥bin にあれば、
     c:¥home¥tak¥bin¥foo.exe
   
   が実行されます。

6. 設定ファイルの書き方につぎのような特別なルールを導入しました。
   設定ファイルの2行目に $(Arguments) という文字列があると、実行時に与えられた引数の全体が、$(Arguments) に置き換えられます。
   $(Arguments) を使っている場合には、$(Argument1)、 $(Argument2)、$(Argument3) を使うことはできません。
   $(Argument1) という文字列があると、実行時に与えられた引数の1番目の引数に置き換えられます。
   $(Argument2) という文字列があると、実行時に与えられた引数の2番目の引数に置き換えられます。$(Argument1) を使っていないのに$(Argument2) を使うことはできません。
   $(Argument3) という文字列があると、実行時に与えられた引数の3番目の引数に置き換えられます。$(Argument2) を使っていないのに$(Argument3) を使うことはできません。
   $(Argument4) は使うことができません。

7. 一行目に start.exe と書いてあった場合は、引数部分を arguments に格納したとして、
      System.Diagnostics.Process.Start(arguments);
   
   のようにして、引数部分 arguments を関連付けによって開きます。

8. 実行時の引数の第一引数に限り、.¥ で始まると、作業ディレクトリに置き換えられます。第一引数が "..." のように引用符号で囲まれていると、引用符号の内側の最初が .¥ で始まると、作業ディレクトリに置き換えられます。
   例えば、myarghelper.exe を runuws.exe という名前に複写して、
      PS> cd c:¥foo¥bar
      PS> runuws .¥foo.uws a b c
   
   のようにした場合、これは、
      PS> runuws c:¥foo¥bar¥foo.uws a b c
   
   のように実行したように動作します。
   (重要) 「実行時の引数の第一引数」と設定ファイルの中に書く引数とは異なることに注意してください。

9. [2015-04-22] 第一引数に //help を指定すると、コメントファイルを start コマンドを使って表示します。
   例えば、myarghelper.exe を hoge.exe という名前で複写した場合は、
      PS> hoge //help
   
   とすると、コメントファイル
      hoge.exe.txt
   
   が、hoge.exe があるディレクトリにあれば、それを、start コマンドを使って表示します。
   第一引数に //help が指定されたときに、標準出力にコメントファイルを書き出したい気もします。しかしmyarghelper.exe は Windows プログラムであって、コンソールプログラムではないので、コンソールに出力することができません。

2 設定ファイル（拡張子が .ahp のファイル）の書き方

3 設定ファイルの記述例

# @(#) hoge.ahp
#
# $Filename: hoge.ahp $
# $Lastupdate: 2015-12-31 18:01:28 $
#
# これは hoge.exe の設定ファイル(ahpfile)のサンプルです。
# 
# (1) 実行するプログラムのフルパスまたは相対パスまたは start.exe
# 必須です。
# 
# start.exe を指定すると、2番目に指定する文字列をファイル名
# あるいは URL と見て、関連付けによって開きます。相対パスの
# 場合、myarghelper.exe があるディレクトリからの相対パスと解
# 釈されます。
C:¥home¥shiiba¥bin¥MsgBox.exe
#
# (2) 引数 (必要でなければ無くても構いません。
# $(Arguments)、$(Argument1)、$(Argument2), $(Argument3) を
# 文字列の中に含めることができます。
# 
# $(Arguments) を指定すると、myarghelper.exe を複写してでき
# た名前のファイル hoge.exeに与えられたすべての引数が 
# $(Arguments) の位置に挿入されます。
# 
# $(Argument1) を指定すると、hoge.exe を呼び出したときの引数
# の1番目の引数が$(Argument1) の位置に挿入されます。
# 
# $(Argument1)、$(Argument2) を指定すると、hoge.exe を呼び出
# したときの引数の1番目の引数が$(Argument1) の位置に、2番目
# の引数が$(Argument2) の位置に挿入されます。
# 
# $(Argument1)、$(Argument2)、$(Argument3) を指定すると、
# hoge.exe を呼び出したときの引数の1番目の引数が$(Argument1) 
# の位置に、2番目の引数が$(Argument2) の位置に、3番目の引数
# が$(Argument3) の位置に挿入されます。
# 
-t:"hoge"
#
# ここの例のように設定すると、実行するコマンドラインとして
# 
#   C:¥home¥shiiba¥bin¥MsgBox.exe -t:"hoge" 
#
# が用意され、hoge.exe を起動したときの引数が後に追加され
# て実行されます。
# 
# たとえば、
# 
#   hoge.exe Hello
#   
# とすると、
# 
#   C:¥home¥shiiba¥bin¥MsgBox.exe -t:"hoge" Hello
#
# が実行されます。
# 
# 実行プログラムとして、start.exe を指定して、
# 引数として、
# http://www.google.com/search?q=$(Arguments)
# を指定すれば、google 検索できます。

4 //help

5 アイコンの変更